Tin nhắn — Gửi trả lời nhanh
Gửi tin kèm các nút trả lời nhanh (quick reply).
Gửi tin nhắn kèm quick reply để người dùng chọn nhanh. Lựa chọn của họ sẽ phát webhook message.received.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /api/v1/bots/{bot_id}/messages | Gửi tin trả lời nhanh |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
bot_id | path | string | Có | Định danh bot |
X-Page-Access-Token | header | string | Có | Token truy cập trang của bot |
subscriber_id | body | string | Có | Người nhận |
type | body | string | Có | Loại tin: quick_reply |
text | body | string | Có | Câu hỏi |
quick_replies | body | array | Có | Danh sách lựa chọn nhanh |
Kiểm thử tại chỗ
POST
https://sale-ai.hitechcloud.vn/api/v1/bots/{bot_id}/messagesKiểm thử tại chỗGửi thử sẽ ghi dữ liệu thật trên môi trường được chọn. Nên thử trên Sandbox trước. Token không được lưu lại.
Tham số đường dẫn
Headers
Body
Ví dụ cURL
curl -X POST "https://sale-ai.hitechcloud.vn/api/v1/bots/bot_7c1a9f2e/messages" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "X-Page-Access-Token: PAGE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"subscriber_id": "sub_2a9b8c7d",
"type": "quick_reply",
"text": "Ban muon xem gi?",
"quick_replies": [
"Ao",
"Quan",
"Phu kien"
]
}'Phản hồi mẫu
{
"status": "success",
"data": {
"id": "msg_aa11bb22",
"bot_id": "bot_7c1a9f2e",
"subscriber_id": "sub_2a9b8c7d",
"direction": "outbound",
"type": "quick_reply",
"content": {
"text": "Ban muon xem gi?",
"quick_replies": [
"Ao",
"Quan",
"Phu kien"
]
},
"status": "sent",
"sent_at": "2026-10-31T10:31:00+07:00"
}
}Gửi tin nhắn kèm quick reply để người dùng chọn nhanh. Lựa chọn của họ sẽ phát webhook message.received.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /api/v1/bots/{bot_id}/messages | Gửi tin trả lời nhanh |
Tham số
| Tham số | Vị trí | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
bot_id | path | string | Có | Định danh bot |
X-Page-Access-Token | header | string | Có | Token truy cập trang của bot |
subscriber_id | body | string | Có | Người nhận |
type | body | string | Có | Loại tin: quick_reply |
text | body | string | Có | Câu hỏi |
quick_replies | body | array | Có | Danh sách lựa chọn nhanh |
Kiểm thử tại chỗ
POST
https://sale-ai.hitechcloud.vn/api/v1/bots/{bot_id}/messagesKiểm thử tại chỗGửi thử sẽ ghi dữ liệu thật trên môi trường được chọn. Nên thử trên Sandbox trước. Token không được lưu lại.
Tham số đường dẫn
Headers
Body
Ví dụ cURL
curl -X POST "https://sale-ai.hitechcloud.vn/api/v1/bots/bot_7c1a9f2e/messages" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "X-Page-Access-Token: PAGE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"subscriber_id": "sub_2a9b8c7d",
"type": "quick_reply",
"text": "Ban muon xem gi?",
"quick_replies": [
"Ao",
"Quan",
"Phu kien"
]
}'Phản hồi mẫu
{
"status": "success",
"data": {
"id": "msg_aa11bb22",
"bot_id": "bot_7c1a9f2e",
"subscriber_id": "sub_2a9b8c7d",
"direction": "outbound",
"type": "quick_reply",
"content": {
"text": "Ban muon xem gi?",
"quick_replies": [
"Ao",
"Quan",
"Phu kien"
]
},
"status": "sent",
"sent_at": "2026-10-31T10:31:00+07:00"
}
}