AI sidecar callback

Sent to the sidecar’s url as an HTTP POST whenever you set one. The same event is always published in real time on the SignalWire RELAY event channel (calling.ai.sidecar), so the webhook is optional. Each event is wrapped under sidecar_event — read that before checking its type and fields.

This payload covers the envelope shared by every callback. For the fields specific to each type (such as insight.raw, turn.transcript_delta, or final.summary), see the SWML ai_sidecar reference.

Sent to the sidecar's `url` as an HTTP `POST` whenever you set one. The same event is always published in real time on the SignalWire RELAY event channel (`calling.ai.sidecar`), so the webhook is optional. Each event is wrapped under `sidecar_event` — read that before checking its `type` and fields. This payload covers the envelope shared by every callback. For the fields specific to each `type` (such as `insight.raw`, `turn.transcript_delta`, or `final.summary`), see the [SWML ai_sidecar reference](/docs/swml/reference/calling/ai-sidecar#callback-types).

Payload

The payload of this webhook request is an object.

call_infoobjectRequired

Envelope describing the call. project_id and space_id are included when available.

sidecar_eventobjectRequired

The sidecar callback. Carries the common fields below plus type-specific fields.

Response

200

Webhook received

1	{
2	"call_info": {
3	"call_id": "2e1e66e5-5d07-413d-9668-55542992eec0",
4	"content_type": "text/json",
5	"content_disposition": "post_data",
6	"conversation_type": "voice"
7	},
8	"sidecar_event": {
9	"type": "insight",
10	"ts": 1745870400123456,
11	"tick_id": 7,
12	"channel_data": {}
13	}
14	}