Stream events

curl "https://core.wadial.com/api/v1/sessions/{sessionId}/events" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Accept: text/event-stream"

GET

api

sessions

{sessionId}

events

curl "https://core.wadial.com/api/v1/sessions/{sessionId}/events" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Accept: text/event-stream"

Use this stream when your app needs live token updates while the token is connecting, pairing, sending, receiving, or calling.

string

required

Token id returned by POST /api/v1/sessions.

curl "https://core.wadial.com/api/v1/sessions/{sessionId}/events" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Accept: text/event-stream"

The response is a Server-Sent Events stream. Each event uses the WADial event name as the SSE event, the event id as the SSE id, and a JSON data object.

id: 019f...
event: message.receipt
data: {"sessionId":"019eff5e-e24e-74ce-a9bb-ccd97e6946b6","createdAt":"2026-06-29T17:10:00.000Z","messageIds":["3EB0..."],"status":"read"}

WADial also sends heartbeat comments every 30 seconds:

: heartbeat

Live SSE events include:

session.created
session.deleted
connection.state
auth.qr
auth.pairing_required
auth.pairing_code
auth.paired
message.received
message.sent
message.receipt
message.failed
call.incoming
call.state
call.ended
call.error
call.recording.ready
stanza.error
stream.failure

auth.pairing_required and auth.pairing_code are live stream events only. Use the token timeline or webhooks for persisted and retryable event delivery.

Common payloads

Connection state:

{
  "sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
  "createdAt": "2026-06-29T17:10:00.000Z",
  "status": "open"
}

Pairing QR:

{
  "sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
  "createdAt": "2026-06-29T17:10:00.000Z",
  "qr": "2@...",
  "ttlMs": 20000
}

Inbound message:

{
  "sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
  "createdAt": "2026-06-29T17:10:00.000Z",
  "key": {
    "remoteJid": "[email protected]",
    "id": "3EB0A1B2C3D4E5F6",
    "fromMe": false
  },
  "timestampSeconds": 1782753000,
  "pushName": "Jane",
  "message": {
    "conversation": "Hello"
  }
}

Outgoing send result:

{
  "sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
  "createdAt": "2026-06-29T17:10:00.000Z",
  "messageId": "3EB0A1B2C3D4E5F6",
  "to": "[email protected]",
  "contentType": "text"
}

Call state:

{
  "sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
  "createdAt": "2026-06-29T17:10:00.000Z",
  "callId": "call-123",
  "peerJid": "[email protected]",
  "direction": "incoming",
  "mediaType": "audio",
  "state": "active",
  "transport": "websocket"
}

Call and recording events carry metadata only. Raw call audio is only available on the call media WebSocket.

Get started

Guides

Build with the API

API Reference

Common payloads

​Common payloads

Common payloads