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

Retry Policy

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

Webhook Payload

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