Webhook Events

WhatsApp: new_whatsapp_conversation

Sent when a WhatsApp conversation handled by Jodie closes and has been analysed. It includes the contact's number, every message and the details Jodie collected, so the payload always has the final close_reason and the complete thread.

HeaderValue
Event-Typenew_whatsapp_conversation

Example payload

This is the sample payload used by Send test event.

{
  "event_type": "new_whatsapp_conversation",
  "conversation_id": "wac_sample0000000000000000",
  "contact_phone_number": "+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": "inactivity",
  "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_whatsapp_conversation".
conversation_idstringThe conversation's unique ID, prefixed with wac_.
contact_phone_numberstring | nullThe contact's phone number in E.164 format, or null if unavailable.
timestampstring | nullWhen the conversation was first seen, 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 conversation.
close_reasonstring | nullA short reason the conversation was closed.
data_collectionsarrayThe details collected. Same shape as on calls. [] if none.
messagesarrayEvery message, oldest first. [] if there are none.

messages items

KeyTypeDescription
orderintegerPosition in the conversation: 1, 2, 3 and so on.
directionstring"inbound" from the contact, or "outbound" from your business.
sent_bystring | nullFor outbound messages: "ai" if Jodie wrote it, or "company" if a team member typed it on their own device. null for inbound messages.
messagestringThe message text. "" if the message has no text, such as a photo.
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]