# AdFlex ZNS API

> Tài liệu tích hợp API gửi tin Zalo ZNS cho đối tác

## Docs

- [Tổng quan](https://docs-zns.adflex.vn/index.md): API gửi tin Zalo ZNS của AdFlex
- [Xác thực](https://docs-zns.adflex.vn/authentication.md): API key và phạm vi quyền
- [Template và OA](https://docs-zns.adflex.vn/guides/templates.md): Lấy danh sách template, đọc tham số, kiểm tra trạng thái duyệt
- [Chuẩn hoá dữ liệu](https://docs-zns.adflex.vn/guides/prepare-data.md): Yêu cầu đối với số điện thoại, template_data và tracking_id
- [Gửi tin](https://docs-zns.adflex.vn/guides/send.md): Gửi một tin hoặc gửi lô
- [Đặt lịch và huỷ](https://docs-zns.adflex.vn/guides/schedule.md): Gửi vào thời điểm định trước, và huỷ khi chưa gửi
- [Gửi RSA](https://docs-zns.adflex.vn/guides/rsa.md): Mã hoá đầu-cuối, AdFlex không lưu số điện thoại
- [Tra cứu tin](https://docs-zns.adflex.vn/guides/messages.md): Trạng thái một tin, liệt kê có lọc, và huỷ tin chưa gửi
- [Webhook DLR](https://docs-zns.adflex.vn/guides/webhooks.md): Nhận báo cáo giao tin
- [Trạng thái và mã lỗi](https://docs-zns.adflex.vn/guides/errors.md): Vòng đời tin, mã lỗi HTTP và mã lỗi Zalo
- [Ví dụ đầu-cuối](https://docs-zns.adflex.vn/guides/end-to-end.md): Gửi OTP đăng nhập, từ lúc người dùng bấm nút tới lúc đối soát xong
- [Giới hạn và checklist](https://docs-zns.adflex.vn/guides/limits.md): Con số cần biết khi thiết kế, và việc phải làm trước khi chạy thật
- [Liệt kê template](https://docs-zns.adflex.vn/api-reference/template/liệt-kê-template.md): Trả về template của workspace kèm đúng bộ tham số Zalo yêu cầu. Gọi endpoint này TRƯỚC khi viết code gửi — đừng đoán tên tham số.
- [Liệt kê Official Account](https://docs-zns.adflex.vn/api-reference/template/liệt-kê-official-account.md): OA đã kết nối vào workspace.
- [Gửi một tin](https://docs-zns.adflex.vn/api-reference/gửi-tin/gửi-một-tin.md): Gửi một tin ZNS.
- [Gửi lô tối đa 500 tin](https://docs-zns.adflex.vn/api-reference/gửi-tin/gửi-lô-tối-đa-500-tin.md): Gửi tối đa 500 tin cùng một template.
- [Gửi mã hoá đầu-cuối (RSA)](https://docs-zns.adflex.vn/api-reference/gửi-tin/gửi-mã-hoá-đầu-cuối-rsa.md): Gửi tin mã hoá đầu-cuối. AdFlex không lưu số điện thoại.
- [Liệt kê và lọc tin](https://docs-zns.adflex.vn/api-reference/tra-cứu/liệt-kê-và-lọc-tin.md): Tin của workspace, mới nhất trước.
- [Trạng thái một tin](https://docs-zns.adflex.vn/api-reference/tra-cứu/trạng-thái-một-tin.md): Scope: `messages:read`
- [Huỷ tin chưa gửi](https://docs-zns.adflex.vn/api-reference/tra-cứu/huỷ-tin-chưa-gửi.md): Chỉ huỷ được tin còn ở trạng thái `queued` — thường là tin đã đặt lịch.

## OpenAPI Specs

- [openapi](https://business.adflex.vn/openapi.json)