API Omni Channel INCOM là giải pháp kết nối và quản lý gửi tin đa kênh, giúp doanh nghiệp tích hợp ZBS, SMS và Auto Call trên cùng một hệ thống. Thay vì xây dựng nhiều kết nối riêng lẻ, doanh nghiệp có thể gửi thông báo tự động, đồng bộ trạng thái và quản lý dữ liệu tập trung thông qua một API duy nhất, tối ưu vận hành và nâng cao hiệu quả chăm sóc khách hàng.
API Omni Channel là mô hình kết nối gửi tin tự động thông qua 1 hệ thống
API Omni Channel là gì?
API Omni Channel là hệ thống gửi tin hợp nhất của INCOM (omni.incom.vn), cho phép doanh nghiệp gửi thông báo, OTP, tin giao dịch qua nhiều kênh và nhận trạng thái phản hồi (đã gửi/đã nhận/thất bại) theo thời gian thực qua webhook, thay vì phải polling từng kênh riêng.
Tham khảo dịch vụ của INCOM Sài Gòn ngay: TẠI ĐÂY
Các kênh hỗ trợ cho doanh nghiệp
| Kênh | Dùng cho |
|---|---|
| ZBS (Zalo Notification Service) | Thông báo giao dịch, OTP, chăm sóc khách hàng qua Zalo |
| Brandname SMS | Tin nhắn thương hiệu qua SMS |
| Auto Call | Gọi thoại tự động — thường dùng gửi OTP khi SMS/ZBS không khả dụng |
Cách hoạt động của API Omni Channel
Hệ thống của bạn gửi tin qua API (mỗi tin được cấp một idOmniMess).
INCOM xử lý và gửi tin qua kênh tương ứng.
Kết quả trạng thái được tự động callback về webhook bạn đã đăng ký, theo từng kênh:
| Kênh | Các trạng thái (Status) |
|---|---|
| ZBS | SUCCESS (đã đến Zalo), RECEIVE (người dùng đã nhận), FAIL |
| Auto Call | PROCESSING, SUCCESS, FAIL |
| Brandname SMS | SUCCESS, FAIL (kèm MtCount, TelcoId) |
Khi Status là FAIL, response có thêm ErrorCode — mã lỗi khác nhau theo từng kênh (INCOM cung cấp bảng tra cứu riêng).
Các endpoint chính
Lưu ý: Đây là API nên không mở được bằng browser, chỉ dùng để gọi api
/omni.incom.vn/api/OmniHook/UpdateWebhookEndPointCập nhật URL và header nhận callback trạng thái tin. Yêu cầu access_token, trả về thông tin cấu hình cũ/mới.
Lấy kết quả đánh giá (rating) từ template ZBS
/omni.incom.vn/api/OmniReport/GetRatingResultTruy vấn phản hồi đánh giá (số sao, ghi chú) của khách hàng theo TemplateCode, khoảng thời gian và phân trang.
Gửi OTP qua giọng nói (Auto Call)
/autocall.incom.vn/api/VoiceOTP/SendOTP/autocall.incom.vn/api/VoiceOTPReport/GetStatusBộ API riêng cho kênh Auto Call: gửi cuộc gọi đọc mã OTP (4–8 ký tự) và tra cứu trạng thái cuộc gọi (Answered, Busy, No Answered, Fail).
Tất cả request đều xác thực bằng username/password hoặc access_token được INCOM cấp khi đăng ký dịch vụ.
Xem chương trình đối tác đại lý INCOM Sài Gòn: TẠI ĐÂY
Bắt đầu tích hợp
Liên hệ kinh doanh/kỹ thuật INCOM để được cấp tài khoản (username, password, access_token).
Đăng ký URL webhook qua UpdateWebhookEndPoint để nhận trạng thái real-time.
Tích hợp gửi tin theo kênh cần dùng; xử lý callback theo bảng trạng thái tương ứng.
Với lỗi (FAIL), tra ErrorCode theo bảng mã lỗi INCOM cung cấp để xử lý retry/fallback.
Câu hỏi thường gặp
Một webhook có nhận trạng thái cho cả 3 kênh không? Có. Field Channel trong payload (ZBS / AUTOCALL / BRANDNAMESMS) giúp bạn phân biệt và xử lý theo từng kênh.
Không có IP whitelist thì có gọi được API không? Không. Hệ thống trả lỗi 401 Can't access from this IP nếu IP gọi API không nằm trong whitelist đã đăng ký với INCOM.
Muốn đổi endpoint webhook thì cập nhật thế nào? Gọi UpdateWebhookEndPoint với Endpoint và Header mới — response trả về cả cấu hình cũ và mới để đối chiếu.
Xem tài liệu API đầy đủ
Bài viết trên tóm tắt các endpoint chính. Xem chi tiết tham số, response mẫu và code theo nhiều ngôn ngữ tại tài liệu Postman:
Cần cấp tài khoản test hoặc tư vấn tích hợp? Liên hệ đội kinh doanh/kỹ thuật INCOM tại đây
INCOM Sài Gòn – Cùng Nâng Tầm Giá Trị
Hãy liên hệ với chúng tôi để được tư vấn chiến lược kinh doanh và nhu cầu thực tế, INCOM sẽ giúp bạn lựa chọn và triển khai những giải pháp phù hợp, tránh đầu tư vào các tính năng chưa cần thiết.
Tư vấn miễn phí: Zalo OA, Zalo Business Solutions và Zalo Mini App
Website đăng ký tư vấn: Incom Sài Gòn
Địa chỉ: 648 Nguyễn Kiệm, P. Đức Nhuận, TP.HCM
Chia sẻ
