Xác thực & Access Token
Xác thực HiTechCloud Omnichannel: cấp phát và quản lý vòng đời access token, gọi API qua header Bearer hoặc tham số access_token.
Mọi endpoint của Omnichannel API đều yêu cầu một Access Token hợp lệ. Có hai cách gửi token, bạn chọn một trong hai.
Cách 1: Bearer Token (khuyến nghị)
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
Accept: application/jsonCách 2: Tham số access_token trên query
Trong một số môi trường không đặt được header tuỳ ý (ví dụ webhook ngược, công cụ no-code), bạn có thể truyền token qua query string access_token.
curl -X GET "https://omni.hitechcloud.vn/v1/channels?access_token=YOUR_ACCESS_TOKEN"access_token trên URL, token có thể bị ghi vào log máy chủ hoặc lịch sử proxy — chỉ dùng với kết nối HTTPS tin cậy và token có phạm vi hẹp.Phạm vi quyền (scopes)
| Scope | Cho phép |
|---|---|
channels:read | Đọc danh sách và chi tiết kênh |
conversations:read | Đọc hội thoại và tin nhắn |
messages:write | Gửi tin nhắn, trả lời bình luận |
tags:write | Gắn / gỡ nhãn hội thoại |
assign:write | Phân công hội thoại cho nhân viên |
customers:write | Cập nhật hồ sơ và ghi chú khách hàng |
orders:read | Đọc đơn hàng phát sinh từ hội thoại |
webhooks:write | Đăng ký và quản lý webhook |
Kiểm tra token đang dùng
https://omni.hitechcloud.vn/v1/meKiểm thử tại chỗTrả về thông tin token: chủ sở hữu, scopes và danh sách kênh truy cập được. Token không được lưu lại.
{
"status": "success",
"data": {
"token_id": "tok_01HZME",
"workspace": "CONG TY CP CONG NGHE HITECHCLOUD",
"scopes": ["channels:read", "conversations:read", "messages:write"],
"channel_ids": ["chn_01HZX8QWERTY"],
"expires_at": null
}
}401 với code: UNAUTHORIZED. Hãy tạo token mới trong Cài đặt → API & Tích hợp.Mọi endpoint của Omnichannel API đều yêu cầu một Access Token hợp lệ. Có hai cách gửi token, bạn chọn một trong hai.
Cách 1: Bearer Token (khuyến nghị)
Cách 2: Tham số access_token trên query
Trong một số môi trường không đặt được header tuỳ ý (ví dụ webhook ngược, công cụ no-code), bạn có thể truyền token qua query string access_token.
access_token trên URL, token có thể bị ghi vào log máy chủ hoặc lịch sử proxy — chỉ dùng với kết nối HTTPS tin cậy và token có phạm vi hẹp.Phạm vi quyền (scopes)
| Scope | Cho phép |
|---|---|
channels:read | Đọc danh sách và chi tiết kênh |
conversations:read | Đọc hội thoại và tin nhắn |
messages:write | Gửi tin nhắn, trả lời bình luận |
tags:write | Gắn / gỡ nhãn hội thoại |
assign:write | Phân công hội thoại cho nhân viên |
customers:write | Cập nhật hồ sơ và ghi chú khách hàng |
orders:read | Đọc đơn hàng phát sinh từ hội thoại |
webhooks:write | Đăng ký và quản lý webhook |
Kiểm tra token đang dùng
https://omni.hitechcloud.vn/v1/meKiểm thử tại chỗTrả về thông tin token: chủ sở hữu, scopes và danh sách kênh truy cập được. Token không được lưu lại.
401 với code: UNAUTHORIZED. Hãy tạo token mới trong Cài đặt → API & Tích hợp.Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
Accept: application/jsoncurl -X GET "https://omni.hitechcloud.vn/v1/channels?access_token=YOUR_ACCESS_TOKEN"{
"status": "success",
"data": {
"token_id": "tok_01HZME",
"workspace": "CONG TY CP CONG NGHE HITECHCLOUD",
"scopes": ["channels:read", "conversations:read", "messages:write"],
"channel_ids": ["chn_01HZX8QWERTY"],
"expires_at": null
}
}