Tin nhắn Web Widget (live chat website)
Gửi và đọc tin nhắn của kênh live chat website (widget nhúng), bao gồm tạo hội thoại mới cho khách vãng lai.
Kênh Website (widget live chat) có bộ endpoint riêng cho phép tạo hội thoại mới từ khách vãng lai và trao đổi tin nhắn mà không cần định danh mạng xã hội.
Endpoints
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/widget/messages | Gửi tin nhắn / tạo hội thoại mới cho khách web |
GET | /v1/widget/messages | Đọc tin nhắn của một hội thoại web |
Tham số gửi tin (POST body)
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
channel_id | Có | id kênh website |
visitor_id | Có | Định danh khách vãng lai (do widget sinh ra) |
conversation_id | Không | Để trống/null để tạo hội thoại mới |
text | Có* | Nội dung tin nhắn |
attachment_ids | Không | Danh sách media đính kèm |
name | Không | Tên khách nếu đã khai báo |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/widget/messagesKiểm thử tại chỗDùng GET /v1/widget/messages với `conversation_id` để đọc lại. Token không được lưu lại.
Body
cURL gửi tin nhắn web và đọc lại
# Gửi (tạo hội thoại mới nếu bỏ conversation_id)
curl -X POST "https://omni.hitechcloud.vn/v1/widget/messages" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_01HZWEBSITE",
"visitor_id": "vis_8f21ab",
"text": "Mình cần tư vấn gói VPS",
"name": "Nguyen Van A"
}'
# Đọc tin nhắn của hội thoại web
curl -X GET "https://omni.hitechcloud.vn/v1/widget/messages?channel_id=chn_01HZWEBSITE&conversation_id=cnv_01HZWEB01" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"Phản hồi gửi tin web (201 Created)
{
"status": "success",
"data": {
"id": "msg_01HZWEBMSG1",
"conversation_id": "cnv_01HZWEB01",
"channel_id": "chn_01HZWEBSITE",
"visitor_id": "vis_8f21ab",
"direction": "in",
"text": "Mình cần tư vấn gói VPS",
"sent_at": "2026-10-31T10:20:00+07:00"
}
}Sau khi tạo, hội thoại web xuất hiện trong
GET /v1/conversations như mọi kênh khác, và nhân viên trả lời bằng POST /v1/conversations/{id}/messages thông thường.Kênh Website (widget live chat) có bộ endpoint riêng cho phép tạo hội thoại mới từ khách vãng lai và trao đổi tin nhắn mà không cần định danh mạng xã hội.
Endpoints
| Method | Endpoint | Mô tả |
|---|---|---|
POST | /v1/widget/messages | Gửi tin nhắn / tạo hội thoại mới cho khách web |
GET | /v1/widget/messages | Đọc tin nhắn của một hội thoại web |
Tham số gửi tin (POST body)
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
channel_id | Có | id kênh website |
visitor_id | Có | Định danh khách vãng lai (do widget sinh ra) |
conversation_id | Không | Để trống/null để tạo hội thoại mới |
text | Có* | Nội dung tin nhắn |
attachment_ids | Không | Danh sách media đính kèm |
name | Không | Tên khách nếu đã khai báo |
Kiểm thử tại chỗ
POST
https://omni.hitechcloud.vn/v1/widget/messagesKiểm thử tại chỗDùng GET /v1/widget/messages với `conversation_id` để đọc lại. Token không được lưu lại.
Body
Sau khi tạo, hội thoại web xuất hiện trong
GET /v1/conversations như mọi kênh khác, và nhân viên trả lời bằng POST /v1/conversations/{id}/messages thông thường.cURL gửi tin nhắn web và đọc lại
# Gửi (tạo hội thoại mới nếu bỏ conversation_id)
curl -X POST "https://omni.hitechcloud.vn/v1/widget/messages" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "chn_01HZWEBSITE",
"visitor_id": "vis_8f21ab",
"text": "Mình cần tư vấn gói VPS",
"name": "Nguyen Van A"
}'
# Đọc tin nhắn của hội thoại web
curl -X GET "https://omni.hitechcloud.vn/v1/widget/messages?channel_id=chn_01HZWEBSITE&conversation_id=cnv_01HZWEB01" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"Phản hồi gửi tin web (201 Created)
{
"status": "success",
"data": {
"id": "msg_01HZWEBMSG1",
"conversation_id": "cnv_01HZWEB01",
"channel_id": "chn_01HZWEBSITE",
"visitor_id": "vis_8f21ab",
"direction": "in",
"text": "Mình cần tư vấn gói VPS",
"sent_at": "2026-10-31T10:20:00+07:00"
}
}