Skip to main content
WEBHOOK
chat:new
{
  "event_type": "chat:new",
  "chat": {
    "id": 123456,
    "name": "John Smith",
    "phone": "+123456789",
    "jid": "123456789@s.whatsapp.net",
    "is_group": false,
    "closed": false,
    "read": false,
    "labels": [
      "<string>"
    ],
    "unattended_customer": false,
    "chatgpt_autoresponse_enabled": false,
    "whatsapp_account_id": "123456789@s.whatsapp.net",
    "chat_url": "https://app.timelines.ai/chat/123456/messages/",
    "created_timestamp": "2024-01-08 10:35:18 +0200",
    "last_message_uid": "afa9d4dd-978d-4a14-aa1b-bd65c272e645",
    "last_message_timestamp": "2024-01-08 10:35:18 +0200",
    "responsible_name": "Agent Brown",
    "responsible_email": "agent-brown@example.com",
    "previous_responsible_name": "Agent Jones",
    "previous_responsible_email": "agent-jones@example.com"
  },
  "whatsapp_account": {
    "id": "123456789@s.whatsapp.net",
    "phone": "+123456789",
    "connected_on": "2024-01-08 10:35:18 +0200",
    "status": "active",
    "account_name": "Some account",
    "owner_name": "Agent Smith",
    "owner_email": "agent-smith@example.com",
    "disconnected_on": "2024-01-08 10:35:18 +0200"
  }
}

Body

application/json
​
event_type
enum<string>
required

Webhook code name

Available options:
chat:new,
chat:incoming:new,
chat:outgoing:new,
chat:responsible:assigned,
chat:responsible:unassigned
Example:

"chat:new"

​
chat
object
required
​
whatsapp_account
object
required

Response

200

Receiver accepted the event