Skip to main content
Mọi endpoint gửi trả 202 Accepted khi tin vào hàng đợi. Mã này xác nhận tiếp nhận, không xác nhận đã gửi tới người nhận.

Vòng đời một request

Phản hồi 202 xảy ra ở bước 2, trước khi AdFlex gọi Zalo. Kết quả thật đến ở bước 6 và 7.

Gửi một tin

POST /api/v1/messages/send — dùng cho OTP và tin giao dịch theo sự kiện.
Phản hồi
Lưu msg_id để đối soát.

Gửi batch

POST /api/v1/messages/batch — tối đa 500 người nhận mỗi request. send_at và mode áp dụng cho toàn batch.
Phản hồi
202 không đảm bảo mọi người nhận hợp lệ. Đối chiếu accepted với total; phần tử status: "error" không được gửi và không có msg_id.
Xử lý kết quả
AdFlex kiểm tra hạn mức tài khoản cho toàn batch trước khi xếp hàng. Vượt hạn mức trả 402 và không tin nào được gửi. Khuyến nghị chia batch 100–200 người nhận để giảm chi phí thử lại khi lỗi mạng.

Bảo mật số điện thoại

Không truyền mode thì áp dụng mặc định của OA, cấu hình tại Console → Official Account .