Chuyển tới nội dung chính

Xuất bản Template ZBS

API này giúp bạn xuất bản một Template Zalo Business Solution (ZBS) đã khởi tạo trong hệ thống lên Zalo để có thể sử dụng gửi tin nhắn đến người dùng cuối.

Luồng sử dụng:

  1. Khởi tạo template bằng API Khởi tạo Template ZBS — phản hồi trả về _id của template.
  2. Dùng chính _id đó làm template_id để gọi API này, xuất bản template lên Zalo.
  3. Có thể tra cứu lại template qua API Lấy danh sách template hoặc Lấy chi tiết template.

Bạn cần cung cấp template_id (chính là _id nhận được khi khởi tạo template) trong params để hoàn tất việc xuất bản.


Endpoint

🔗Endpoint Staging
PATCH https://staging-manage.api.miniai.vn/api/external/zns-template/publish/<template_id>
Example
id : 6870b7eec2fd3b17da55be6d
🔗Endpoint Production
PATCH https://manage-api.miniap.vn/api/external/zns-template/publish/<template_id>

Điều kiện hợp lệ (Prerequisites)

Trước khi đăng ký, template phải thỏa các điều kiện sau, nếu không request sẽ trả về lỗi 400:

  • Template phải được liên kết với một OA (oaId).
  • Nếu imageTypelogo: phải có đủ cả logo sáng (logoLight) và logo tối (logoDark).
  • Nếu imageTypeimage: phải có ít nhất một ảnh trong images.
  • Tất cả tham số trong params đều phải được chọn loại kỹ thuật (techSetting).

Sau khi đăng ký thành công, template chuyển sang trạng thái PENDING_REVIEW (chờ Zalo duyệt).

Phản hồi (Response)

{
"message": "Success",
"data": {
"id": "68c8ede8e4fe66c9d2168054",
"status": "PENDING_REVIEW"
}
}