Skip to main content
Template do AdFlex đăng ký với Zalo và Zalo duyệt. Hệ thống của bạn không tạo được template qua API; endpoint dưới đây dùng để đọc thông tin cần cho việc gửi tin.

Lấy danh sách template

GET /api/v1/templates · scope templates:read Trả về mọi template thuộc các OA của workspace, kèm danh sách tham số Zalo yêu cầu.

Trường trả về

Endpoint không trả về giá tin. Chi phí xem trong Console → Template.

Trạng thái template

Gửi tin bằng template không ở trạng thái ENABLE trả lỗi 400 với thông báo Template chưa được duyệt (status=…).
Trạng thái template do Zalo quyết định và có thể thay đổi bất kỳ lúc nào. Nếu hệ thống của bạn cache template_id, hãy đồng bộ lại định kỳ thay vì cấu hình cố định một lần.

Tham số template

Mỗi phần tử trong params mô tả một tham số của template_data: Giá trị truyền vào template_data luôn là chuỗi, kể cả với tham số mang ý nghĩa số hoặc ngày tháng. Xem Chuẩn hoá dữ liệu.

Đồng bộ template về hệ thống của bạn

Lưu cả params để kiểm tra template_data phía bạn trước khi gọi API gửi.

Lấy danh sách OA

GET /api/v1/oas · scope templates:read
Dùng oa_id để lọc template khi workspace có nhiều OA.