Skip to main content
WEBHOOK
message:received:new
{
  "event_type": "message:new",
  "chat": {
    "full_name": "Agent Smith",
    "chat_url": "https://app.timelines.ai/chat/123456/messages/",
    "chat_id": 123456,
    "is_group": false,
    "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": "2024-01-08 10:35:18 +0200",
    "message_uid": "c7ec509d-0171-1ead-a84b-c6943a644768",
    "sender": {
      "full_name": "John Smith",
      "phone": "+123456789"
    },
    "recipient": {
      "full_name": "John Smith",
      "phone": "+123456789"
    },
    "reply_to_uid": "c7ec509d-0171-1ead-a84b-c6943a644768",
    "attachments": [
      {
        "temporary_download_url": "https://example.s3.amazonaws.com/att/...",
        "filename": "example.doc",
        "size": 1234567,
        "mimetype": "application/msword"
      }
    ]
  }
}

Body

application/json
event_type
enum<string>
required

Webhook event name

Available options:
message:new,
message:sent:new,
message:received:new
Example:

"message:new"

chat
object
required
whatsapp_account
object
required
message
object
required

Response

200

Receiver accepted the event