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.

Xem Markdown

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ị)

Header chuẩn cho mọi yêu cầu
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
Accept: application/json

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.

Gọi API bằng access_token trên query
curl -X GET "https://omni.hitechcloud.vn/v1/channels?access_token=YOUR_ACCESS_TOKEN"
Ưu tiên Bearer header. Khi dùng 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)

ScopeCho 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:writeGửi tin nhắn, trả lời bình luận
tags:writeGắn / gỡ nhãn hội thoại
assign:writePhân công hội thoại cho nhân viên
customers:writeCậ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

GEThttps://omni.hitechcloud.vn/v1/me

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.

Phản hồi GET /v1/me
{
  "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
  }
}
Khi token sai hoặc hết hạn, API trả về HTTP 401 với code: UNAUTHORIZED. Hãy tạo token mới trong Cài đặt → API & Tích hợp.