Reference
contact.stage_changed — Customer stage changed
The customer moved to another stage of the sales pipeline.
View MarkdownThis page is generated from the source code on every release.
The customer moved to another stage of the sales pipeline.
Since web 1.0.0, worker —.
| Name | Value |
|---|---|
| Code | contact.stage_changed |
| Group | People (CRM) |
| Status | Subscribable |
| Scope needed to receive it | crm.read |
| Tied to one account | No |
| Only the connection that caused it receives it | No |
| Filters that apply | person_stage_ids |
Fields dropped in thin content mode |
person.name, person.username, reason |
| Fields written by outside people (untrusted) | person.name |
JSON Schema
https://tlg.builera.app/schemas/events/contact.stage_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": "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"
]
}
}