Webhook — message.received

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

Xem Markdown

Sự kiện message.received được gửi khi bot nhận tin nhắn mới từ người theo dõi. 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ệnmessage.received
Kích hoạt khiNhận tin từ khách
Base URLhttps://sale-ai.hitechcloud.vn/webhook
Header chữ kýX-SaleAI-Signature

Cấu trúc payload

Payload message.received
{
  "id": "evt_9f0a1b2c",
  "event": "message.received",
  "created_at": "2026-10-31T10:35:00+07:00",
  "data": {
    "id": "msg_aa11bb22",
    "bot_id": "bot_7c1a9f2e",
    "subscriber_id": "sub_2a9b8c7d",
    "direction": "inbound",
    "type": "text",
    "content": {
      "text": "Ao nay con size L khong?"
    },
    "status": "sent",
    "sent_at": "2026-10-31T10:31:00+07:00"
  }
}
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.