Liên kết API & Tích hợp hệ thống là nền tảng giúp Zalo Mini App kết nối với CRM, ERP, phần mềm bán hàng, cổng thanh toán và các hệ thống quản trị khác để dữ liệu được đồng bộ tự động theo thời gian thực. Thay vì nhập liệu thủ công hoặc vận hành rời rạc, doanh nghiệp có thể xây dựng một quy trình xuyên suốt từ tiếp nhận khách hàng, xử lý đơn hàng đến chăm sóc sau bán. Bài viết này sẽ giúp bạn hiểu các nhóm API của Zalo, quy trình tích hợp, những lưu ý kỹ thuật quan trọng và lộ trình triển khai phù hợp cho doanh nghiệp nhỏ.
1. Các nhóm API mà Zalo cung cấp cho Mini App
Zalo chia API thành hai lớp chính: JSAPI (client-side, chạy trên thiết bị người dùng) và Open API/Server API (server-side, gọi từ backend doanh nghiệp). JSAPI xử lý tương tác trực tiếp như lấy thông tin user, yêu cầu quyền truy cập, điều khiển thiết bị. Open API phục vụ các thao tác cần xác thực phía server như gửi tin nhắn OA, quản lý template ZNS.
Một số API nhạy cảm — getPhoneNumber, getLocation, requestCameraPermission — yêu cầu đăng ký quyền trước với Zalo. Admin và developer có thể truy cập tất cả API trong môi trường test, nhưng người dùng cuối sẽ bị giới hạn nếu app chưa được duyệt quyền (nguồn: Zalo Mini App Docs).
| Nhóm API | API tiêu biểu | Ứng dụng trong tích hợp |
|---|---|---|
| Thông tin người dùng | getUserInfo, getPhoneNumber | Đồng bộ khách hàng sang CRM — tên, avatar, số điện thoại liên kết |
| Tương tác OA | interactOA, followOA | Tự động cho khách follow OA sau khi dùng Mini App, gửi tin chăm sóc |
| Thanh toán | createOrder (ZaloPay API) | Tạo đơn thanh toán, nhận callback xác nhận giao dịch, đồng bộ với hệ thống đơn hàng |
| Thiết bị & lưu trữ | getLocation, getNetworkType, Native Storage | Gợi ý cửa hàng gần nhất, lưu dữ liệu offline, cá nhân hóa trải nghiệm |
| Giao diện & trải nghiệm | createShortcut, vibrate, keepScreen | Tạo shortcut trên màn hình chính, giữ màn hình sáng khi quét QR |
| Zalo Notification Service (ZNS) | ZNS Template API | Gửi thông báo đơn hàng, nhắc lịch hẹn, cập nhật trạng thái giao hàng |
2. 04 loại API nền tảng để kết nối hệ thống ngoài
Ngoài JSAPI nội bộ của Mini App, doanh nghiệp cần hiểu bốn loại API nền tảng mà Zalo cung cấp để tích hợp với hệ thống bên ngoài. Mỗi loại phục vụ một mục đích khác nhau trong chuỗi vận hành.
- OA API (Official Account API): cho phép hệ thống CRM gửi tin nhắn, lấy thông tin người quan tâm, gắn tag khách hàng trực tiếp qua Zalo OA. Đây là API được dùng nhiều nhất khi tích hợp chăm sóc khách hàng.
- ZNS API (Zalo Notification Service): gửi thông báo có cấu trúc (template) đến người dùng đã liên kết số điện thoại — kể cả khi họ chưa follow OA. Phù hợp cho xác nhận đơn hàng, nhắc lịch hẹn, cập nhật vận chuyển.
- Social API: xác thực người dùng qua Zalo Login (OAuth 2.0), giúp Mini App và website nhận diện khách hàng mà không cần tạo tài khoản riêng.
- ZaloPay API: xử lý thanh toán trong Mini App — tạo đơn, nhận callback khi giao dịch thành công, hoàn tiền. Tích hợp trực tiếp vào luồng mua hàng.
3. Quy trình tích hợp Zalo Mini App với hệ thống nội bộ
Tích hợp API không yêu cầu thay đổi hệ thống hiện tại. API đóng vai trò “cầu nối” — Mini App gửi dữ liệu sang hệ thống cũ và nhận ngược lại. Dưới đây là 6 bước triển khai.
- Tạo Zalo App trên trang Zalo Developers (developers.zalo.me): đăng ký ứng dụng, nhận App ID và Secret Key.
- Xác minh domain: khai báo domain backend của doanh nghiệp với Zalo. Server cần cấu hình Access-Control-Allow-Origin cho các domain h5.zdn.vn và zbrowser://h5.zdn.vn (nguồn: Zalo Mini App Docs).
- Đăng ký quyền API: chọn các API cần dùng (getPhoneNumber, interactOA, v.v.) và gửi yêu cầu duyệt. Thời gian duyệt thường từ vài ngày đến khoảng một tuần.
- Cấu hình OAuth 2.0: thiết lập luồng xác thực để hệ thống backend lấy access token từ Zalo. Token có thời hạn — cần cơ chế refresh token tự động.
- Kích hoạt Webhook: đăng ký URL endpoint để nhận sự kiện realtime từ Zalo (khách follow OA, gửi tin nhắn, thanh toán xong). Webhook là nền tảng của đồng bộ hai chiều.
- Đồng bộ dữ liệu hai chiều: khi có sự kiện từ Zalo (đơn hàng mới, khách mới), Webhook đẩy dữ liệu về CRM/ERP. Ngược lại, khi CRM cập nhật trạng thái (giao hàng, hoàn tiền), backend gọi OA API hoặc ZNS để thông báo cho khách.
4. Các hệ thống thường tích hợp với Zalo Mini App
Tùy quy mô và ngành hàng, doanh nghiệp nhỏ có thể kết nối Zalo Mini App với một hoặc nhiều hệ thống. Dưới đây là các loại hệ thống phổ biến và dữ liệu được trao đổi qua API.
| Hệ thống | Dữ liệu trao đổi | API/giao thức chính | Ví dụ ứng dụng |
|---|---|---|---|
| CRM (quản lý khách hàng) | Thông tin khách, lịch sử tương tác, tag phân loại | OA API + Webhook | Khách follow OA → tự động tạo contact trong CRM, gắn tag nguồn “Zalo Mini App” |
| ERP (quản lý tổng thể) | Đơn hàng, doanh thu, công nợ | REST API + Webhook | Đơn hàng từ Mini App → tự động tạo phiếu bán trong ERP, trừ tồn kho |
| Phần mềm kho hàng | Tồn kho, trạng thái sản phẩm | REST API (polling hoặc push) | Sản phẩm hết hàng trong kho → Mini App tự động hiển thị “Hết hàng” |
| Cổng thanh toán | Giao dịch, trạng thái thanh toán | ZaloPay API, VNPay API | Khách thanh toán xong → callback xác nhận → CRM ghi nhận doanh thu |
| Hệ thống vận chuyển | Mã vận đơn, trạng thái giao hàng | REST API + Webhook | Đơn hàng xác nhận → tự động tạo vận đơn, gửi ZNS thông báo mã tracking |
5. Lưu ý kỹ thuật khi tích hợp API Zalo Mini App
Tích hợp API có nhiều điểm dễ gây lỗi trong thực tế. Dưới đây là các vấn đề thường gặp và cách xử lý.
5.1. Quản lý access token
Access token của Zalo OA API có thời hạn. Nếu token hết hạn mà không được refresh, toàn bộ luồng đồng bộ sẽ ngắt — CRM không nhận dữ liệu mới. Lỗi phổ biến nhất là HTTP 401. Giải pháp: xây dựng cơ chế refresh token tự động, kèm cảnh báo khi refresh thất bại.
5.2. Xử lý Webhook và sự kiện trùng lặp
Webhook Zalo có thể gửi lại cùng một sự kiện nhiều lần nếu server phản hồi chậm. Không có cơ chế idempotency thì hệ thống có thể tạo trùng đơn hàng. Cách phòng tránh: lưu event ID, kiểm tra trước khi xử lý.
5.3. Cấu hình CORS và xác minh domain
Server backend cần khai báo đúng domain trong header Access-Control-Allow-Origin. Thiếu bước này, request từ Mini App bị chặn. Domain cũng cần được xác minh trên Zalo Developers trước khi API hoạt động trên production.
6. Doanh nghiệp nhỏ nên bắt đầu tích hợp từ đâu?
Không cần tích hợp tất cả cùng lúc. Doanh nghiệp nhỏ thường đi theo lộ trình từ đơn giản đến phức tạp, dựa trên nhu cầu thực tế và nguồn lực kỹ thuật.
- Giai đoạn 1 — OA API + CRM: đồng bộ khách hàng từ Zalo sang CRM, gắn tag tự động, gửi tin chăm sóc. Bước này mang lại giá trị nhanh nhất.
- Giai đoạn 2 — ZNS + cổng thanh toán: gửi thông báo đơn hàng qua ZNS, tích hợp ZaloPay hoặc VietQR để khách trả tiền ngay trong Mini App.
- Giai đoạn 3 — ERP + kho hàng: đồng bộ đơn hàng, tồn kho, trạng thái giao hàng realtime. Phù hợp khi lượng đơn đã ổn định.
- Giai đoạn 4 — Mở rộng: tích hợp loyalty, chatbot AI, hệ thống vận chuyển. Mini App trở thành đầu mối tiếp nhận, backend xử lý vận hành.
Kết luận
Liên kết API giúp Zalo Mini App không chỉ là nơi hiển thị sản phẩm mà còn trở thành trung tâm kết nối khách hàng, đơn hàng và thanh toán với hệ thống nội bộ. Với doanh nghiệp nhỏ, hãy bắt đầu từ OA API + CRM, vận hành ổn định rồi mở rộng dần theo nhu cầu.
Nếu muốn triển khai nhanh mà không phải tự xây dựng toàn bộ hạ tầng tích hợp, Mini AI cung cấp giải pháp kết nối Zalo Mini App với CRM, OA và Loyalty, giúp doanh nghiệp tự động hóa quy trình và quản lý khách hàng hiệu quả. Liên hệ để được tư vấn chi tiết ngay!
FAQ
Zalo Mini App có cần tài khoản doanh nghiệp (OA) mới tích hợp API được không?
Có. Để sử dụng OA API và ZNS, doanh nghiệp cần có Zalo Official Account (OA) với gói trả phí (Advanced hoặc Premium). OA miễn phí có giới hạn số lượng tin nhắn và không truy cập được một số API nâng cao.
Chi phí tích hợp API Zalo Mini App là bao nhiêu?
Bản thân API của Zalo không tính phí gọi. Chi phí phát sinh chủ yếu từ: phí ZNS theo template (vài trăm đến vài nghìn đồng/tin), phí cổng thanh toán (1-3%/giao dịch), và chi phí phát triển/vận hành server backend. Doanh nghiệp nhỏ có thể bắt đầu với ngân sách thấp nếu dùng nền tảng có sẵn kết nối.
Access token Zalo OA API hết hạn sau bao lâu?
Access token có thời hạn giới hạn và cần được refresh định kỳ. Cơ chế refresh token cho phép lấy token mới mà không cần người dùng xác thực lại. Doanh nghiệp nên xây dựng cron job tự động refresh và giám sát lỗi xác thực (HTTP 401).
Webhook Zalo có hỗ trợ những sự kiện gì?
Webhook Zalo OA hỗ trợ nhiều loại sự kiện: người dùng follow/unfollow OA, gửi tin nhắn, gửi hình ảnh, click vào menu OA, và các sự kiện từ Mini App (mở app, tương tác). Mỗi sự kiện gửi kèm payload chứa thông tin chi tiết để backend xử lý.
