Webhook — subscriber.created

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

Xem Markdown

Sự kiện subscriber.created được gửi khi một người theo dõi mới bắt đầu trò chuyện. Payload gửi tới URL webhook của bạn bằng HTTP POST kèm header chữ ký X-SaleAI-Signature (HMAC-SHA256).

Thông tin sự kiện

Thuộc tínhGiá trị
Tên sự kiệnsubscriber.created
Kích hoạt khiCó người theo dõi mới
Base URLhttps://sale-ai.hitechcloud.vn/webhook
Header chữ kýX-SaleAI-Signature

Cấu trúc payload

Payload subscriber.created
{
  "id": "evt_9f0a1b2c",
  "event": "subscriber.created",
  "created_at": "2026-10-31T10:35:00+07:00",
  "data": {
    "id": "sub_2a9b8c7d",
    "bot_id": "bot_7c1a9f2e",
    "psid": "6103928475610",
    "full_name": "Nguyen Van A",
    "first_name": "A",
    "last_name": "Nguyen Van",
    "gender": "male",
    "locale": "vi_VN",
    "profile_pic": "https://cdn.hitechcloud.vn/sub/2a9b8c7d.jpg",
    "tags": [
      "khach_moi",
      "quan_tam_ao"
    ],
    "subscribed_at": "2026-10-20T14:00:00+07:00",
    "last_interaction_at": "2026-10-31T09:40:00+07:00",
    "status": "active"
  }
}
Khử trùng lặp theo id sự kiện (evt_...) và xác thực X-SaleAI-Signature trước khi xử lý. Sự kiện được gửi theo cơ chế at-least-once; hãy phản hồi 200 trong vòng 5 giây.