Extension này là gì?
ZCA Hub Extension là tiện ích trình duyệt Chrome do ZCA phát triển, giúp cửa hàng đang dùng phần mềm bán hàng (KiotViet, và sau này mở rộng iPOS, Sapo, Pancake, POS365...) gửi tin nhắn ZNS (Zalo Business Solution) trực tiếp từ màn hình thanh toán lên hệ thống ZCA.
Bạn chỉ cần cài extension, cấu hình API Key và mapping template một lần — sau đó mỗi khi thanh toán đơn, tin nhắn ZNS sẽ được gửi tới khách hàng theo template Zalo bạn đã đăng ký.
Mục tiêu
- Kết nối phần mềm bán hàng với ZCA, không cần tích hợp API phức tạp tại từng nền tảng.
- Gửi thông báo ZNS cho khách ngay trong luồng thanh toán (số điện thoại, mã đơn, tổng tiền, ngày giờ... tùy template).
- Một extension dùng được cho nhiều nền tảng POS (KiotViet trước, các nền khác bổ sung sau).
Cơ chế hoạt động
1. Cài đặt & cấu hình
Cài ZCA Hub Extension từ Chrome Web Store. Mở popup extension để nhập API Key và Template ID ZNS do ZCA cung cấp. Dùng tính năng Mapping ZBS để chọn trường dữ liệu trên trang (tên khách, SĐT, tổng tiền, ngày giờ...) ánh xạ vào từng trường của template Zalo.
2. Trên trang bán hàng
Khi bạn mở trang thanh toán (ví dụ KiotViet /sale/#/), extension hiển thị tùy chọn Gửi ZBS. Khi thực hiện thanh toán đơn, dữ liệu đơn hàng (số điện thoại khách, thông tin đã mapping) được gửi lên API ZCA để gửi tin nhắn ZNS theo template bạn đã cấu hình.
3. Dữ liệu & bảo mật
Extension chỉ đọc dữ liệu hiển thị trên trang bán hàng (tên, SĐT, tổng tiền, ngày giờ...) và chỉ gửi tới api.zca.vn khi bạn thao tác gửi ZBS. API Key do bạn tự nhập và lưu trên máy; extension không gửi dữ liệu tới bên thứ ba nào khác. Chi tiết xem tại Chính sách bảo mật.
Yêu cầu sử dụng
- Tài khoản ZCA và Template ZNS đã được duyệt.
- API Key (Bearer token) do ZCA cung cấp.
- Trình duyệt Chrome (hoặc Edge / Cốc Cốc dùng nền Chromium).
Chính sách bảo mật
ZCA Hub Extension thu thập dữ liệu từ trang bán hàng (tên khách hàng, số điện thoại, tổng tiền, mã đơn, ngày giờ...) chỉ để gửi tin nhắn ZNS qua API của ZCA (api.zca.vn). Dữ liệu được gửi khi bạn thao tác gửi ZBS; extension không gửi dữ liệu tới bên thứ ba nào khác. API Key do bạn nhập và được lưu cục bộ trên thiết bị (chrome.storage). Chúng tôi không lưu trữ hoặc xử lý dữ liệu khách hàng trên server của NDK.
(Liên kết sẽ được cập nhật khi extension được phê duyệt)