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.

Xem Markdown

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

Mọi kênh gom về một API hợp nhất, đẩy sự kiện realtime về ứng dụng của bạn
KênhFacebook · Instagram · Zalo · TikTok · Web
HiTechCloud OmnichannelREST API hợp nhất
Hội thoại hợp nhất · WebhookSự kiện realtime
Ứng dụng của bạnCSKH · Chatbot · Trợ lý AI
Các kênh được hỗ trợ
FacebookFacebookMessengerMessengerInstagramInstagramZalo OAZalo OATikTokTikTok

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ênMô 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
WebhookKênh đẩy sự kiện realtime về hệ thống của bạn

Môi trường và Base URL

Môi trườngBase URLMô tả
Production (Chính thức)https://omni.hitechcloud.vnHộ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.vnDữ liệu mô phỏng độc lập, an toàn để kiểm thử
Webhook basehttps://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.

Cấu trúc phản hồi tiêu chuẩn
{
  "status": "success",
  "data": [],
  "meta": {
    "pagination": {
      "total": 240,
      "per_page": 50,
      "current_page": 1,
      "last_page": 5,
      "next_cursor": "cnv_01HZ...",
      "has_more": true
    }
  }
}
Luôn kiểm tra trường 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