v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0102123.3 KB
chats

Triggered when there is a new direct or group chat.

postWebhookchat:new

Payload

event_type'chat:new' | 'chat:incoming:new' | 'chat:outgoing:new' | 'chat:responsible:assigned' | 'chat:responsible:unassigned' required

Webhook code name

Example payload

{
  "event_type": "chat:new",
  "chat": {
    "id": 123456,
    "name": "John Smith",
    "phone": "+123456789",
    "jid": "123456789@s.whatsapp.net",
    "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",
    "disconnected_on": "2024-01-08 10:35:18 +0200",
    "status": "active",
    "account_name": "Some account",
    "owner_name": "Agent Smith",
    "owner_email": "agent-smith@example.com"
  }
}

Response

Receiver accepted the event