Webhook — deal.stage_changed

Chi tiết và payload mẫu của sự kiện webhook `deal.stage_changed`.

Xem Markdown

Sự kiện deal.stage_changed được gửi khi cơ hội chuyển sang giai đoạn khác. Payload được gửi tới URL webhook của bạn bằng HTTP POST kèm header chữ ký X-CRM-Signature.

Thông tin sự kiện

Thuộc tínhGiá trị
Tên sự kiệndeal.stage_changed
Kích hoạt khiCơ hội chuyển giai đoạn
Base URLhttps://crm-gateways.hitechcloud.vn/webhook

Cấu trúc payload

Payload deal.stage_changed
{
  "id": "evt_9f0a1b2c",
  "event": "deal.stage_changed",
  "created_at": "2026-10-31T10:35:00+07:00",
  "data": {
    "id": "deal_a19c330e",
    "title": "Goi Cloud Server",
    "pipeline_id": "pl_sales",
    "stage_id": "stg_proposal",
    "status": "open",
    "amount": 24000000,
    "currency": "VND",
    "contact_id": "con_8f2a1c9d",
    "company_id": "co_4b7e2f10",
    "expected_close_date": "2026-12-15",
    "owner_id": "usr_12",
    "created_at": "2026-10-20T08:00:00+07:00",
    "previous_stage_id": "stg_qualified"
  }
}
Khử trùng lặp theo id sự kiện (evt_...) và xác thực X-CRM-Signature (HMAC-SHA256) trước khi xử lý. Sự kiện được gửi theo cơ chế at-least-once.