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).
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
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/conversations/{id}/messages | Gửi tin nhắn trong một hội thoại |
Tham số thân yêu cầu (Body)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
type | string | Có | text, image, file, comment_reply, private_reply |
text | string | Có* | Nội dung văn bản (bắt buộc với text, comment_reply, private_reply) |
attachment_ids | array | Có* | Danh sách id media đã upload (bắt buộc với image, file) |
reply_to_message_id | string | Không | id bình luận cần trả lời (với comment_reply / private_reply) |
idempotency_key | string | Không | Khoá chống gửi trùng khi retry |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/conversations/{id}/messagesKiểm thử tại chỗ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.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
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/conversations/{id}/messages | Gửi tin nhắn trong một hội thoại |
Tham số thân yêu cầu (Body)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
type | string | Có | text, image, file, comment_reply, private_reply |
text | string | Có* | Nội dung văn bản (bắt buộc với text, comment_reply, private_reply) |
attachment_ids | array | Có* | Danh sách id media đã upload (bắt buộc với image, file) |
reply_to_message_id | string | Không | id bình luận cần trả lời (với comment_reply / private_reply) |
idempotency_key | string | Không | Khoá chống gửi trùng khi retry |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/conversations/{id}/messagesKiểm thử tại chỗ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
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.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"
}
}