---
title: "call.ended — Cuộc gọi kết thúc"
locale: vi
url: https://tlg.builera.app/docs/reference/events/call.ended
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# call.ended — Cuộc gọi kết thúc

Cuộc gọi kết thúc, kèm lý do (cúp, người kia cúp, từ chối, nhỡ, bận, lỗi…) và số giây đã nói.

Cuộc gọi kết thúc, kèm lý do (cúp, người kia cúp, từ chối, nhỡ, bận, lỗi…) và số giây đã nói.

Từ bản web 2.4.0, máy chạy 1.0.44.

| Tên | Giá trị |
| --- | --- |
| Mã | `call.ended` |
| Nhóm | Cuộc gọi |
| Trạng thái | Đăng ký được |
| Scope cần để nhận | `messages.read` |
| Gắn với một tài khoản | Có |
| Chỉ kết nối gây ra sự kiện mới nhận | Không |
| Bộ lọc áp dụng | — |
| Trường bị bỏ ở chế độ nội dung `thin` | — |
| Trường do người ngoài viết (không tin cậy) | — |

## JSON Schema

[https://tlg.builera.app/schemas/events/call.ended/2.json](https://tlg.builera.app/schemas/events/call.ended/2.json)

## Payload mẫu (đúng như `webhooks.test` gửi)

```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"
    }
  }
}
```