Zalo Cloud API là gì?

Zalo Cloud API là entry point kỹ thuật cho mọi tích hợp Zalo Business. Cung cấp 5 nhóm API chính 2026: (1) ZBS API (trước đây gọi là ZNS API) — gửi tin template 1-1 có phí; (2) OA Open API — quản lý fan, gửi broadcast, lấy data tương tác; (3) Mini App Framework — build mini-app trong Zalo, push notification miễn phí; (4) Zalo Pay API — xử lý thanh toán trong Zalo; (5) OAuth/Login API — đăng nhập bằng Zalo. Tất cả endpoint REST JSON, doc tại developers.zalo.me.

Authentication flow: app cần đăng ký tại developers.zalo.me, lấy App ID + Secret Key. Với ZBS, cần thêm OA Access Token (lấy qua OAuth flow uỷ quyền từ chủ OA). Access Token mặc định hết hạn sau 1 giờ; Refresh Token sau 3 tháng — cần xử lý refresh logic. Sai khâu này là lỗi tích hợp số 1 — app tự build thường gặp 'token expired' giữa đêm khiến tin gửi fail không retry.

Rate limit và quota 2026: ZBS API giới hạn ~600 request/phút/OA cho hạng cơ bản, ~3.000 req/phút cho OA hạng cao. OA Open API ~300 req/phút. Vượt limit trả 429, cần exponential backoff + retry queue. Quan trọng: Zalo không retry tự động — request fail là mất tin. App build trực tiếp phải tự implement retry logic với idempotency key để tránh gửi trùng khi retry.

Ví dụ tích hợp với POS Việt Nam: khi POS (KiotViet/iPOS/Sapo) ghi nhận giao dịch mới → webhook về app → app trích xuất SĐT khách + dữ liệu đơn → format theo template ZBS đã đăng ký → gọi Zalo Cloud API gửi tin xác nhận. Chuỗi này nghe đơn giản nhưng thực tế phức tạp: cần xử lý webhook retry, dedup, mapping field, fallback khi SĐT không có Zalo, log + monitoring. Build từ scratch thường mất 8–16 tuần dev cho 1 senior engineer.

Build trực tiếp vs dùng platform middleware (PEKO): Build trực tiếp ưu điểm: control 100%, không phí platform. Nhược điểm: tốn 8–16 tuần dev + 2–4 tuần Zalo duyệt template; phải tự duy trì refresh token, retry, monitoring, fallback channel; chi phí dev maintenance 200–500 triệu/năm cho team 1–2 dev. Dùng PEKO (hoặc platform middleware tương đương): trả phí gói 290k–5 triệu/tháng nhưng có sẵn template pre-approved, retry/idempotency, multi-OA dashboard, AI viết nội dung, fallback SMS — go-live trong 1 buổi chiều. Build vs buy break-even thường ở mức ~50.000 tin/tháng — dưới ngưỡng đó buy luôn rẻ hơn.