Webhooks

Receive real-time notifications when events occur on your sessions.

Set Webhook URL

Configure your webhook URL from the dashboard when creating or editing a session. Alternatively you can set it during session creation.

Event Types

Event	Description
`message.received`	Incoming message from a contact
`message.sent`	Outgoing message confirmed sent
`session.connected`	Session successfully authenticated
`session.disconnected`	Session lost connection

Webhook Payload

{
  "event": "message.received",
  "session_id": 1,
  "timestamp": "2026-03-08T10:30:00Z",
  "data": {
    "from": "260971000000",
    "message": "Hi there!",
    "type": "text"
  }
}

Retry Policy

Failed webhook deliveries are retried up to 3 times with exponential backoff (1min, 5min, 15min).