Đơ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.
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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/orders | Danh sách đơn hàng (lọc theo kênh, hội thoại, trạng thái) |
POST | /v1/orders | Tạ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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
conversation_id | string | Có | Hội thoại phát sinh đơn |
items | array | Có | Danh sách sản phẩm: name, quantity, price |
shipping_address | object | Không | Địa chỉ giao hàng của khách |
note | string | Không | Ghi chú đơn hàng |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/ordersKiểm thử tại chỗ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.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
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/orders | Danh sách đơn hàng (lọc theo kênh, hội thoại, trạng thái) |
POST | /v1/orders | Tạ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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
conversation_id | string | Có | Hội thoại phát sinh đơn |
items | array | Có | Danh sách sản phẩm: name, quantity, price |
shipping_address | object | Không | Địa chỉ giao hàng của khách |
note | string | Không | Ghi chú đơn hàng |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/ordersKiểm thử tại chỗ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
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.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"
}
}