Tin nhắn — Gửi trả lời nhanh

Gửi tin kèm các nút trả lời nhanh (quick reply).

Xem Markdown

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

MethodEndpointMô tả
POST/api/v1/bots/{bot_id}/messagesGửi tin trả lời nhanh

Tham số

Tham sốVị tríKiểuBắt buộcMô tả
bot_idpathstringCóĐịnh danh bot
X-Page-Access-TokenheaderstringCóToken truy cập trang của bot
subscriber_idbodystringCóNgười nhận
typebodystringCóLoại tin: quick_reply
textbodystringCóCâu hỏi
quick_repliesbodyarrayCóDanh sách lựa chọn nhanh

Kiểm thử tại chỗ

POSThttps://sale-ai.hitechcloud.vn/api/v1/bots/{bot_id}/messages

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"
  }
}