Tin nhắn — Gửi (send message)

Gửi tin nhắn trả lời khách trong một hội thoại: văn bản, hình ảnh/tệp, trả lời bình luận hoặc trả lời riêng (private reply).

Xem Markdown

Endpoint này gửi một tin nhắn ra ngoài (direction out) trong một hội thoại đang có. Tuỳ loại hội thoại và nền tảng, bạn có thể gửi văn bản, đính kèm media, trả lời bình luận công khai hoặc trả lời riêng.

Endpoint

MethodEndpointMô tả
POST/v1/conversations/{id}/messagesGửi tin nhắn trong một hội thoại

Tham số thân yêu cầu (Body)

Tham sốKiểuBắt buộcMô tả
typestringCótext, image, file, comment_reply, private_reply
textstringCó* Nội dung văn bản (bắt buộc với text, comment_reply, private_reply)
attachment_idsarrayCó* Danh sách id media đã upload (bắt buộc với image, file)
reply_to_message_idstringKhôngid bình luận cần trả lời (với comment_reply / private_reply)
idempotency_keystringKhôngKhoá chống gửi trùng khi retry

Kiểm thử tại chỗ

POSThttps://omni.hitechcloud.vn/v1/conversations/{id}/messages

Gửi thử sẽ tạo tin nhắ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.

Tham số đường dẫn
Body
cURL gửi tin nhắn văn bản
curl -X POST "https://omni.hitechcloud.vn/v1/conversations/cnv_01HZABCDEF/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text",
    "text": "Dạ shop còn hàng ạ, mình cho em xin size và địa chỉ nhé!",
    "idempotency_key": "reply-cnv-01HZ-001"
  }'
cURL gửi hình ảnh (đã upload)
curl -X POST "https://omni.hitechcloud.vn/v1/conversations/cnv_01HZABCDEF/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "image",
    "attachment_ids": ["att_01HZIMG01"]
  }'
Phản hồi (201 Created)
{
  "status": "success",
  "data": {
    "id": "msg_01HZSEND01",
    "conversation_id": "cnv_01HZABCDEF",
    "direction": "out",
    "type": "text",
    "text": "Dạ shop còn hàng ạ, mình cho em xin size và địa chỉ nhé!",
    "sender": { "id": "usr_01HZNV01", "name": "Nhan vien CSKH" },
    "sent_at": "2026-10-31T09:41:00+07:00",
    "delivery_status": "sent"
  }
}
Ngay cả khi HTTP trả về 200/201, hãy kiểm tra status và delivery_status. Một số nền tảng từ chối tin ngoài cửa sổ nhắn tin — khi đó status là error với code: MESSAGING_WINDOW_CLOSED.