Webhook — order.created

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

Xem Markdown

Sự kiện order.created được gửi khi một đơn hàng được tạo từ hội thoạ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ệnorder.created
Kích hoạt khiTạo đơn hàng mới
Base URLhttps://sale-ai.hitechcloud.vn/webhook
Header chữ kýX-SaleAI-Signature

Cấu trúc payload

Payload order.created
{
  "id": "evt_9f0a1b2c",
  "event": "order.created",
  "created_at": "2026-10-31T10:35:00+07:00",
  "data": {
    "id": "order_55667788",
    "bot_id": "bot_7c1a9f2e",
    "subscriber_id": "sub_2a9b8c7d",
    "items": [
      {
        "product_id": "prod_a1f2e3d4",
        "name": "Ao thun basic",
        "quantity": 2,
        "unit_price": 199000
      }
    ],
    "subtotal": 398000,
    "shipping_fee": 30000,
    "total": 428000,
    "currency": "VND",
    "status": "pending",
    "customer": {
      "name": "Nguyen Van A",
      "phone": "0901234567",
      "address": "12 Nguyen Hue, Q1, HCM"
    },
    "created_at": "2026-10-31T10:30: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.