Mẫu ZNS của OA (offset, limit, status) — API Zalo OA

Lấy danh sách template

GET/zns/template/allGọi qua 360: GET https://partner.quantri360.com/v1/zalo/zns/template/all

Mô tả API

Danh sách mẫu tin ZNS (template) của OA: mã, tên, ngày tạo, trạng thái duyệt, chất lượng. Dùng tìm template_id để gửi tin hoặc xem mẫu nào đang chờ duyệt / bị từ chối.

Chỉ mẫu ENABLE mới gửi được.
Lấy tham số cần truyền của một mẫu bằng /zns/template/info/v2.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/zalo/zns/template/all

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	1173478676788457425	OA_ID của Zalo OA brand đã nối (GET /v1/platforms). Mỗi brand một OA — có thể bỏ.
data	query	string (JSON)	{"offset":0,"count":10}	Nhiều API GET của Zalo nhận tham số gói trong `data` là chuỗi JSON — gửi nguyên như tài liệu Zalo.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
offset	query	int	Có	0	Vị trí bắt đầu; mẫu tạo gần nhất có thứ tự 0.
limit	query	int	Có	100	Số mẫu mỗi lần, tối đa 100.
status	query	int	Không	1	Lọc trạng thái: `1` ENABLE (dùng được) · `2` PENDING_REVIEW · `3` REJECT · `4` DISABLE. Bỏ trống = mọi trạng thái.
filterPreset	query	int	Không	0	`0` mọi mẫu của OA · `1` chỉ mẫu do app đang gọi tạo.

Phân trang

Tăng offset thêm limit tới khi đủ metadata.total.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/zalo/zns/template/all?offset=0&limit=100&status=1" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/zalo/zns/template/all",
    params={
        "offset": 0,
        "limit": 100,
        "status": 1
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/zalo/zns/template/all');
for (const [k, v] of Object.entries({"offset":0,"limit":100,"status":1})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/zalo/zns/template/all' . '?' . http_build_query(['offset' => 0, 'limit' => 100, 'status' => 1]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của Zalo OA)

Tên	Kiểu	Mẫu	Mô tả
error	int	0	0 = thành công.
message	string	Success
data	object[]		Mới tạo trước.
templateId	int	600001	Mã mẫu — dùng làm template_id khi gửi.
templateName	string		Tên mẫu.
createdTime	timestamp	1786952525000	Ngày tạo, Unix MILI GIÂY (mẫu cũ có thể là 0).
status	string	ENABLE	`ENABLE` · `PENDING_REVIEW` · `REJECT` · `DISABLE`.
templateQuality	string	UNDEFINED	`HIGH` · `MEDIUM` · `LOW` · `UNDEFINED` — LOW có nguy cơ bị khóa mẫu.
metadata	object
total	int	23	Tổng số mẫu theo bộ lọc status.

Mẫu phản hồi

{
  "error": 0,
  "message": "Success",
  "data": [
    {
      "templateId": 600001,
      "templateName": "Xác thực đăng nhập hệ thống tích điểm Cửa hàng mẫu",
      "createdTime": 1786952525000,
      "status": "ENABLE",
      "templateQuality": "UNDEFINED"
    },
    {
      "templateId": 600002,
      "templateName": "Xác nhận đơn hàng (bản sao)",
      "createdTime": 1777278521286,
      "status": "ENABLE",
      "templateQuality": "UNDEFINED"
    },
    {
      "templateId": 600003,
      "templateName": "Xác nhận đơn hàng",
      "createdTime": 0,
      "status": "ENABLE",
      "templateQuality": "UNDEFINED"
    }
  ],
  "metadata": {
    "total": 17
  }
}

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm ZNS (Zalo Notification Service) ở trang nền tảng
Tạo API key (tick kênh Zalo OA)
Gọi theo ví dụ ở trên