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.

Xem Markdown

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

MethodEndpointMô tả
POST/v1/widget/messagesGử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ộcMô tả
channel_idCóid kênh website
visitor_idCóĐịnh danh khách vãng lai (do widget sinh ra)
conversation_idKhôngĐể trống/null để tạo hội thoại mới
textCó* Nội dung tin nhắn
attachment_idsKhôngDanh sách media đính kèm
nameKhôngTên khách nếu đã khai báo

Kiểm thử tại chỗ

POSThttps://omni.hitechcloud.vn/v1/widget/messages

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.