---
title: "call.state_changed — Cuộc gọi đổi trạng thái"
locale: vi
url: https://tlg.builera.app/docs/reference/events/call.state_changed
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# call.state_changed — Cuộc gọi đổi trạng thái

Cuộc gọi chuyển trạng thái (đang gọi, đổ chuông, trao khoá, đang kết nối, đang nói). Không bao giờ kèm khoá, địa chỉ hay tiếng.

Cuộc gọi chuyển trạng thái (đang gọi, đổ chuông, trao khoá, đang kết nối, đang nói). Không bao giờ kèm khoá, địa chỉ hay tiếng.

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

| Tên | Giá trị |
| --- | --- |
| Mã | `call.state_changed` |
| 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.state_changed/2.json](https://tlg.builera.app/schemas/events/call.state_changed/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.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"
    }
  }
}
```