Tổng quan HiTechCloud Omnichannel
HiTechCloud Omnichannel: một API gom hội thoại Facebook, Instagram, Zalo, TikTok, Website — đọc, trả lời, gắn nhãn, phân công nhân viên và nhận webhook thời gian thực.
HiTechCloud Omnichannel là nền tảng quản lý hội thoại đa kênh của HiTechCloud. Thay vì phải tích hợp riêng lẻ Graph API của Facebook, Zalo OA API, TikTok Business và widget chat website, bạn chỉ cần kết nối một lần rồi dùng một bộ REST API thống nhất để đọc hội thoại, gửi tin nhắn, quản lý khách hàng và đồng bộ đơn hàng phát sinh ngay trong khung chat.
Luồng kết nối
Kết nối một lần qua giao diện quản trị, sau đó dùng chung một bộ API cho tất cả.
Vì sao chọn Omnichannel API
Các nhóm tài nguyên chính
| Tài nguyên | Mô tả |
|---|---|
| Kênh (channels) | Các trang/kênh đã kết nối: Facebook Page, Instagram, Zalo OA, TikTok Shop, Website widget |
| Hội thoại (conversations) | Luồng trao đổi giữa doanh nghiệp và một khách trên một kênh |
| Tin nhắn (messages) | Từng tin trong hội thoại: văn bản, hình ảnh, tệp, bình luận, trả lời riêng |
| Khách hàng (customers) | Hồ sơ người liên hệ, hợp nhất theo định danh trên từng kênh |
| Nhãn (tags) | Phân loại hội thoại theo trạng thái, chiến dịch, mức ưu tiên |
| Đơn hàng (orders) | Đơn phát sinh trực tiếp từ hội thoại bán hàng |
| Webhook | Kênh đẩy sự kiện realtime về hệ thống của bạn |
Môi trường và Base URL
| Môi trường | Base URL | Mô tả |
|---|---|---|
| Production (Chính thức) | https://omni.hitechcloud.vn | Hội thoại và khách hàng thật trên các kênh đã kết nối |
| Sandbox (Thử nghiệm) | https://omni-sandbox.hitechcloud.vn | Dữ liệu mô phỏng độc lập, an toàn để kiểm thử |
| Webhook base | https://omni.hitechcloud.vn/webhook | Điểm gửi sự kiện realtime (verify + đăng ký) |
Định dạng phản hồi Envelope
Mọi endpoint của Omnichannel API trả về một cấu trúc JSON Envelope thống nhất, giúp bạn chỉ cần viết một lớp xử lý chung cho toàn bộ tài nguyên.
{
"status": "success",
"data": [],
"meta": {
"pagination": {
"total": 240,
"per_page": 50,
"current_page": 1,
"last_page": 5,
"next_cursor": "cnv_01HZ...",
"has_more": true
}
}
}status trước khi đọc data. Khi status là error, phản hồi sẽ có thêm code và message thay cho data.Danh mục tài liệu
- Bắt đầu nhanh — Lấy token và gọi API đầu tiên.
- Xác thực & Access Token — Bearer token và access_token.
- Kết nối kênh — Liên kết Facebook, Instagram, Zalo, TikTok, Web.
- Hội thoại — Danh sách — Lọc và duyệt hội thoại.
- Tin nhắn — Gửi — Trả lời khách qua API.
- Webhook — Tổng quan — Nhận sự kiện realtime.
HiTechCloud Omnichannel là nền tảng quản lý hội thoại đa kênh của HiTechCloud. Thay vì phải tích hợp riêng lẻ Graph API của Facebook, Zalo OA API, TikTok Business và widget chat website, bạn chỉ cần kết nối một lần rồi dùng một bộ REST API thống nhất để đọc hội thoại, gửi tin nhắn, quản lý khách hàng và đồng bộ đơn hàng phát sinh ngay trong khung chat.
Luồng kết nối
Kết nối một lần qua giao diện quản trị, sau đó dùng chung một bộ API cho tất cả.
Vì sao chọn Omnichannel API
Các nhóm tài nguyên chính
| Tài nguyên | Mô tả |
|---|---|
| Kênh (channels) | Các trang/kênh đã kết nối: Facebook Page, Instagram, Zalo OA, TikTok Shop, Website widget |
| Hội thoại (conversations) | Luồng trao đổi giữa doanh nghiệp và một khách trên một kênh |
| Tin nhắn (messages) | Từng tin trong hội thoại: văn bản, hình ảnh, tệp, bình luận, trả lời riêng |
| Khách hàng (customers) | Hồ sơ người liên hệ, hợp nhất theo định danh trên từng kênh |
| Nhãn (tags) | Phân loại hội thoại theo trạng thái, chiến dịch, mức ưu tiên |
| Đơn hàng (orders) | Đơn phát sinh trực tiếp từ hội thoại bán hàng |
| Webhook | Kênh đẩy sự kiện realtime về hệ thống của bạn |
Môi trường và Base URL
| Môi trường | Base URL | Mô tả |
|---|---|---|
| Production (Chính thức) | https://omni.hitechcloud.vn | Hội thoại và khách hàng thật trên các kênh đã kết nối |
| Sandbox (Thử nghiệm) | https://omni-sandbox.hitechcloud.vn | Dữ liệu mô phỏng độc lập, an toàn để kiểm thử |
| Webhook base | https://omni.hitechcloud.vn/webhook | Điểm gửi sự kiện realtime (verify + đăng ký) |
Định dạng phản hồi Envelope
Mọi endpoint của Omnichannel API trả về một cấu trúc JSON Envelope thống nhất, giúp bạn chỉ cần viết một lớp xử lý chung cho toàn bộ tài nguyên.
status trước khi đọc data. Khi status là error, phản hồi sẽ có thêm code và message thay cho data.Danh mục tài liệu
- Bắt đầu nhanh — Lấy token và gọi API đầu tiên.
- Xác thực & Access Token — Bearer token và access_token.
- Kết nối kênh — Liên kết Facebook, Instagram, Zalo, TikTok, Web.
- Hội thoại — Danh sách — Lọc và duyệt hội thoại.
- Tin nhắn — Gửi — Trả lời khách qua API.
- Webhook — Tổng quan — Nhận sự kiện realtime.
{
"status": "success",
"data": [],
"meta": {
"pagination": {
"total": 240,
"per_page": 50,
"current_page": 1,
"last_page": 5,
"next_cursor": "cnv_01HZ...",
"has_more": true
}
}
}