Reference
call.state_changed — Call state changed
A call moved to another state (requesting, ringing, exchanging keys, connecting, active). Never carries keys, addresses or audio.
View MarkdownThis page is generated from the source code on every release.
A call moved to another state (requesting, ringing, exchanging keys, connecting, active). Never carries keys, addresses or audio.
Since web 2.4.0, worker 1.0.44.
| Name | Value |
|---|---|
| Code | call.state_changed |
| Group | Calls |
| Status | Subscribable |
| Scope needed to receive it | messages.read |
| Tied to one account | Yes |
| Only the connection that caused it receives it | No |
| Filters that apply | — |
Fields dropped in thin content mode |
— |
| Fields written by outside people (untrusted) | — |
JSON Schema
https://tlg.builera.app/schemas/events/call.state_changed/2.json
Sample payload (exactly what webhooks.test sends)
{
"specversion": "1.0",
"id": "evt_01JDOCSSAMPLE",
"source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
"type": "call.state_changed",
"time": "2026-10-21T13:45:00.123Z",
"datacontenttype": "application/json",
"dataschema": "https://tlg.builera.app/schemas/events/call.state_changed/2.json",
"platform": "telegram",
"workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
"accountid": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
"seq": "000000000000000",
"schemaversion": "2",
"correlationid": null,
"causationid": null,
"test": true,
"replay": false,
"data": {
"call_id": "4c8e2a6f-1b3d-4f5a-9c7e-2d4f6a8b0c1e",
"account": {
"id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
"label": "Sale 1",
"username": "sale_demo_1",
"tg_user_id": "100200300"
},
"conversation_id": "9f2e4b6a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
"peer_id": "500600700",
"direction": "outgoing",
"state": "active",
"previous_state": "connecting",
"end_reason": null,
"error_code": null,
"duration_sec": null,
"origin": "human",
"started_at": "2026-10-21T13:45:00.123Z",
"answered_at": "2026-10-21T13:45:00.123Z",
"ended_at": null,
"links": {
"app": "https://tlg.builera.app/w/07c2e5e1-c42f-4212-851b-c55b6dd7989d/inbox?c=9f2e4b6a-1c3d-4e5f-8a9b-0c1d2e3f4a5b"
}
}
}