Webhook Events

Website chat: new_web_conversation

Sent when a chat on your website closes. It includes the visitor's details, every message and the details Jodie collected. Jodie extracts those details first, so they're in the payload. If extraction fails, the webhook is still sent with whatever is available.

HeaderValue
Event-Typenew_web_conversation

Example payload

This is the sample payload used by Send test event.

{
  "event_type": "new_web_conversation",
  "conversation_id": "wcv_sample0000000000000000",
  "visitor_name": "Sam Taylor",
  "visitor_email": "[email protected]",
  "visitor_phone": "+447700900123",
  "timestamp": "2026-11-02T16:50:00+00:00",
  "start_time": "2026-11-02T16:50:00+00:00",
  "end_time": "2026-11-02T16:51:30+00:00",
  "message_count": 4,
  "close_reason": "visitor_ended",
  "data_collections": [
    { "key": "name", "value": "Sam Taylor" },
    { "key": "phone_number", "value": "+447700900123" },
    { "key": "message", "value": "Would like a quote to replace a boiler." },
    { "key": "internal_label", "value": "LEAD" },
    {
      "key": "transcript_summary",
      "value": "Sam asked for a quote to replace a boiler and would like a call back tomorrow morning."
    }
  ],
  "messages": [
    {
      "order": 1,
      "direction": "inbound",
      "sent_by": null,
      "message": "Hi, could I get a quote to replace my boiler?",
      "sent_at": "2026-11-02T16:50:00+00:00"
    },
    {
      "order": 2,
      "direction": "outbound",
      "sent_by": "ai",
      "message": "Of course! What is your name and the best number to reach you on?",
      "sent_at": "2026-11-02T16:50:30+00:00"
    },
    {
      "order": 3,
      "direction": "inbound",
      "sent_by": null,
      "message": "Sam Taylor, 07700 900123. Tomorrow morning is best.",
      "sent_at": "2026-11-02T16:51:00+00:00"
    },
    {
      "order": 4,
      "direction": "outbound",
      "sent_by": "ai",
      "message": "Thanks Sam, I have passed that on and the team will call you tomorrow morning.",
      "sent_at": "2026-11-02T16:51:30+00:00"
    }
  ]
}

Fields

KeyTypeDescription
event_typestringAlways "new_web_conversation".
conversation_idstringThe chat's unique ID, prefixed with wcv_.
visitor_namestring | nullThe visitor's name, if they gave it.
visitor_emailstring | nullThe visitor's email address, if they gave it.
visitor_phonestring | nullThe visitor's phone number, if they gave it.
timestampstring | nullWhen the chat started, in ISO 8601 format.
start_timestring | nullWhen the first message was sent.
end_timestring | nullWhen the last message was sent.
message_countintegerThe number of messages in the chat.
close_reasonstring | nullWhy the chat closed. See below.
data_collectionsarrayThe details collected. Same shape as on calls. [] if none.
messagesarrayEvery message, oldest first. [] if there are none.

close_reason values

ValueMeaning
visitor_endedThe visitor ended the chat.
visitor_leftThe visitor left the page.
inactivityThe chat closed after a period with no messages.
cappedThe chat reached its reply limit.
teamA team member closed the chat.

messages items

Messages use the same shape as WhatsApp and email.

KeyTypeDescription
orderintegerPosition in the chat: 1, 2, 3 and so on.
directionstring"inbound" from the visitor, or "outbound" from your business.
sent_bystring | nullFor outbound messages: "ai" if Jodie wrote it, or "company" if a team member took over the chat. null for inbound messages.
messagestringThe message text. "" if empty.
sent_atstring | nullWhen the message was sent, in ISO 8601 format.

Need a hand?

Our team can help you connect Jodie to your systems.

Email [email protected]