v3

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

Triggered when there is a new message.

postWebhookmessage:new

Payload

event_type'message:new' | 'message:sent:new' | 'message:received:new' required

Webhook event name

Example payload

{
  "event_type": "message:new",
  "chat": {
    "full_name": "Agent Smith",
    "chat_url": "https://app.timelines.ai/chat/123456/messages/",
    "chat_id": 123456,
    "phone": "+123456789",
    "responsible_name": "Agent Brown",
    "responsible_email": "agent-brown@example.com"
  },
  "whatsapp_account": {
    "full_name": "Agent Brown",
    "email": "agent-brown@example.com",
    "phone": "+123456789"
  },
  "message": {
    "text": "Sending some example document to you",
    "direction": "sent",
    "origin": "Public API",
    "timestamp": "2023-06-18 15:19:23 +0300",
    "received_timestamp": "2023-06-18 14:39:25 +0300",
    "message_uid": "c7ec509d-0171-1ead-a84b-c6943a644768",
    "reply_to_uid": "c7ec509d-0171-1ead-a84b-c6943a644768",
    "sender": {
      "full_name": "John Smith",
      "phone": "+123456789"
    },
    "recipient": {
      "full_name": "John Smith",
      "phone": "+123456789"
    },
    "attachments": [
      {
        "temporary_download_url": "https://example.s3.amazonaws.com/att/...",
        "filename": "example.doc",
        "size": 1234567,
        "mimetype": "application/msword"
      }
    ]
  }
}

Response

Receiver accepted the event

All 16 operations