Tổng quan

AdFlex ZNS API cho phép hệ thống của bạn gửi tin Zalo ZNS tới người dùng cuối. API theo chuẩn REST, trao đổi dữ liệu JSON, xác thực bằng API key.

Base URL

https://business.adflex.vn

Kiến trúc

Bạn chỉ làm việc với AdFlex. Việc gọi Zalo, quản lý token của Official Account và đối soát chi phí do AdFlex đảm nhiệm.

Điều kiện sử dụng

Yêu cầu	Nơi thiết lập
Official Account đã kết nối	Console → Official Account
Template ở trạng thái `ENABLE`	Console → Template
API key	Console → Cài đặt → API Keys

API vận hành ở chế độ production. Không có môi trường sandbox. Mỗi request thành công tạo một tin thật tới số thật.Để kiểm thử nội dung template không mất phí, dùng chức năng Gửi thử trong Console → Template .Chức năng đó chạy ở chế độ development của Zalo: không tính phí, nhưng chỉ gửi được tới số quản trị viên của Official Account. Đây là giới hạn của Zalo, không phải của AdFlex. Gửi tới số bất kỳ ở chế độ này trả mã -127.

Luồng tích hợp

1. Lấy template

GET /api/v1/templates trả về template_id và danh sách tham số.

2. Chuẩn hoá dữ liệu

Số điện thoại, template_data và tracking_id.

3. Gửi

POST /api/v1/messages/send hoặc /batch.

4. Nhận kết quả

Webhook DLR và đối soát bằng API tra cứu.

Ví dụ

curl -X POST https://business.adflex.vn/api/v1/messages/send \
  -H "Authorization: Bearer $ADFLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "123456",
    "phone": "84912345678",
    "template_data": { "otp": "246813", "time": "5 phut" },
    "tracking_id": "otp-login-8842"
  }'

HTTP 202 Accepted
{
  "msg_id": "m_a1b2c3d4e5f6g7h8",
  "tracking_id": "otp-login-8842",
  "status": "queued",
  "scheduled_at": null
}

202 xác nhận tin đã vào hàng đợi, không xác nhận đã gửi tới người nhận. Kết quả gửi tra qua trạng thái tin hoặc webhook DLR.

Bắt đầu

Template

Gửi tin

Theo dõi kết quả

Tham chiếu

Base URL

Kiến trúc

Điều kiện sử dụng

Luồng tích hợp

1. Lấy template

2. Chuẩn hoá dữ liệu

3. Gửi

4. Nhận kết quả

Ví dụ

​Base URL

​Kiến trúc

​Điều kiện sử dụng

​Luồng tích hợp

1. Lấy template

2. Chuẩn hoá dữ liệu

3. Gửi

4. Nhận kết quả

​Ví dụ

Base URL

Kiến trúc

Điều kiện sử dụng

Luồng tích hợp

Ví dụ