Đơn hàng từ hội thoại (orders)

Tạo và theo dõi đơn hàng phát sinh ngay trong khung chat bán hàng — inbox, bình luận livestream — gắn trực tiếp với hội thoại và khách hàng.

Xem Markdown

Nhiều giao dịch bán hàng chốt ngay trong hội thoại. Omnichannel API cho phép tạo đơn hàng gắn với một hội thoại/khách, liệt kê và cập nhật trạng thái đơn để đồng bộ về hệ thống quản lý bán hàng của bạn.

Endpoints

MethodEndpointMô tả
GET/v1/ordersDanh sách đơn hàng (lọc theo kênh, hội thoại, trạng thái)
POST/v1/ordersTạo đơn hàng từ một hội thoại
GET/v1/orders/{id}Chi tiết một đơn hàng
PUT/v1/orders/{id}Cập nhật trạng thái / thông tin đơn

Tham số thân yêu cầu (tạo đơn)

Tham sốKiểuBắt buộcMô tả
conversation_idstringCóHội thoại phát sinh đơn
itemsarrayCóDanh sách sản phẩm: name, quantity, price
shipping_addressobjectKhôngĐịa chỉ giao hàng của khách
notestringKhôngGhi chú đơn hàng

Kiểm thử tại chỗ

POSThttps://omni.hitechcloud.vn/v1/orders

Gửi thử tạo đơn thật trên môi trường được chọn. Nên thử Sandbox trước. Token không được lưu lại.

Body
cURL tạo đơn hàng từ hội thoại
curl -X POST "https://omni.hitechcloud.vn/v1/orders" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "cnv_01HZABCDEF",
    "items": [
      { "name": "Ao thun HiTech", "quantity": 2, "price": 150000 }
    ],
    "shipping_address": { "name": "Nguyen Van A", "phone": "0909123456", "address": "123 Le Loi, Q1, TP.HCM" },
    "note": "Giao giờ hành chính"
  }'
Phản hồi (201 Created)
{
  "status": "success",
  "data": {
    "id": "ord_01HZORDER01",
    "conversation_id": "cnv_01HZABCDEF",
    "customer_id": "cus_01HZCUST",
    "status": "pending",
    "items": [
      { "name": "Ao thun HiTech", "quantity": 2, "price": 150000, "amount": 300000 }
    ],
    "total_amount": 300000,
    "created_at": "2026-10-31T09:45:00+07:00"
  }
}
Trạng thái đơn (status) đi qua các bước: pending → confirmed → shipping → completed (hoặc cancelled). Cập nhật qua PUT /v1/orders/{id} và nhận thông báo realtime qua sự kiện webhook order.updated.