Skip to main content
Template do bạn đăng ký trực tiếp với Zalo và Zalo kiểm duyệt. AdFlex đồng bộ template bạn đã khai báo trên Zalo về hệ thống, sẵn sàng cho việc gửi tin.

​
Cấu trúc một template

Template gồm hai phần độc lập, kết hợp khi hiển thị tin: Mỗi parameter là một chỗ trống có tên, ví dụ <customer_name> hay <order_code>. Khi bạn gọi API gửi tin, giá trị trong template_data được thay vào đúng chỗ trống tương ứng.
Tên parameter bạn đặt lúc đăng ký chính là khoá dùng trong template_data. Đặt tên theo nghiệp vụ và giữ nguyên — đổi tên nghĩa là phải sửa cả code gửi tin.
Mỗi loại component có ràng buộc riêng về độ dài, số lượng parameter và điều kiện bắt buộc. Chi tiết xem tài liệu Zalo .

​
Các bước

1

Soạn template trên Zalo

Đăng nhập tài khoản Zalo Business của bạn và tạo mẫu tin cho Official Account. Khai báo đầy đủ components và parameters. Hướng dẫn chi tiết xem tài liệu Zalo .
2

Chờ Zalo kiểm duyệt

Template ở trạng thái PENDING_REVIEW. Zalo duyệt hoặc từ chối kèm lý do.
3

Đồng bộ về AdFlex

Được duyệt xong, vào Console → Template và bấm Đồng bộ. Template xuất hiện trong hệ thống kèm template_id và danh sách parameters.
4

Lấy thông tin qua API

GET /api/v1/templates?status=ENABLE trả về template_id và params — đúng bộ dữ liệu cần cho việc gửi tin. Xem Template và OA.

​
Chọn loại template

Zalo phân loại template theo mục đích sử dụng, và mỗi loại có hạn mức cùng quy định riêng: Chọn sai loại là lý do bị từ chối phổ biến. Tin giao dịch đăng ký dưới dạng khuyến mãi sẽ chịu hạn mức thấp hơn nhiều.

​
Sau khi đăng ký

  • Trạng thái template có thể đổi bất kỳ lúc nào do Zalo quyết định. AdFlex chỉ phản ánh bản đồng bộ gần nhất — xem Template và OA.
  • Nội dung template chỉnh sửa trên Zalo, sau đó đồng bộ lại để AdFlex nhận bản mới.
  • Chỉ template ENABLE mới gửi được. Xem mã lỗi nếu bị từ chối.