---
title: "call.ended — Call ended"
locale: en
url: https://tlg.builera.app/en/docs/reference/events/call.ended
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# call.ended — Call ended

A call ended, with the reason (hang-up, remote hang-up, declined, missed, busy, failed…) and the seconds spoken.

A call ended, with the reason (hang-up, remote hang-up, declined, missed, busy, failed…) and the seconds spoken.

Since web 2.4.0, worker 1.0.44.

| Name | Value |
| --- | --- |
| Code | `call.ended` |
| 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.ended/2.json](https://tlg.builera.app/schemas/events/call.ended/2.json)

## Sample payload (exactly what `webhooks.test` sends)

```json
{
  "specversion": "1.0",
  "id": "evt_01JDOCSSAMPLE",
  "source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "type": "call.ended",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/call.ended/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": "ended",
    "previous_state": "active",
    "end_reason": "remote_hangup",
    "error_code": null,
    "duration_sec": 74,
    "origin": "human",
    "started_at": "2026-10-21T13:45:00.123Z",
    "answered_at": "2026-10-21T13:45:00.123Z",
    "ended_at": "2026-10-21T13:45:00.123Z",
    "links": {
      "app": "https://tlg.builera.app/w/07c2e5e1-c42f-4212-851b-c55b6dd7989d/inbox?c=9f2e4b6a-1c3d-4e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}
```