---
title: "contact.stage_changed — Khách đổi giai đoạn"
locale: vi
url: https://tlg.builera.app/docs/reference/events/contact.stage_changed
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# contact.stage_changed — Khách đổi giai đoạn

Khách chuyển sang giai đoạn khác trong quy trình bán.

Khách chuyển sang giai đoạn khác trong quy trình bán.

Từ bản web 1.0.0, máy chạy —.

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

## JSON Schema

[https://tlg.builera.app/schemas/events/contact.stage_changed/2.json](https://tlg.builera.app/schemas/events/contact.stage_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": "contact.stage_changed",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/contact.stage_changed/2.json",
  "platform": "telegram",
  "workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "accountid": null,
  "seq": "000000000000000",
  "schemaversion": "2",
  "correlationid": null,
  "causationid": null,
  "test": true,
  "replay": false,
  "data": {
    "person": {
      "id": "c41b7e2a-9d3c-4b1f-8e2a-7c5d3b1f9e08",
      "name": "Nguyễn Văn A",
      "username": "nva",
      "tg_user_id": "456789",
      "stage_id": "3e5f7a9b-1c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "tags": [
        "vip"
      ],
      "temperature": "warm",
      "owner_account_id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
      "listed": true
    },
    "from_stage": {
      "id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
      "name": "Đã trả lời",
      "key": "replied"
    },
    "to_stage": {
      "id": "3e5f7a9b-1c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "name": "Quan tâm",
      "key": "interested"
    },
    "by": {
      "kind": "human",
      "id": null
    },
    "reason": null,
    "untrusted_fields": [
      "person.name"
    ]
  }
}
```