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

Đ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
Ví workspace còn số dư	Console → Tổng quan
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 và trừ phí từ ví workspace theo giá template.Để 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 này chỉ gửi tới số quản trị viên của OA.

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

Đ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

​Đ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

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

Luồng tích hợp

Ví dụ