VI | EN
Nhắn Messenger
Dành cho developer

Lấy danh sách user_id khách quan tâm/đã tương tác (lọc theo nhãn, thời gian, is_follower) — API Zalo OA

Lấy danh sách người dùng · gọi qua Quantri360 bằng một API key cho chính tài khoản / tài sản bạn đã kết nối và ủy quyền — 360 lo việc ký request và làm mới phiên đăng nhập bạn đã cấp.

Lấy danh sách người dùng

GET/v3.0/oa/user/getlistGọi qua 360: GET https://partner.quantri360.com/v1/zalo/v3.0/oa/user/getlist
Mô tả API

Truy xuất danh sách người dùng của OA. Ứng dụng cần được cấp quyền quản lý thông tin người dùng.

  • Hiện Zalo trả lỗi -212 "App has not registed this api": app Zalo của 360 chưa được Zalo duyệt nhóm quyền người dùng — chưa dùng được (gọi thử 24/10/2026).

Request

Địa chỉ

GET https://partner.quantri360.com/v1/zalo/v3.0/oa/user/getlist

Xác thực & gian hàng

TênVị tríKiểuMẫuMô tả
AuthorizationheaderheaderBearer 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_idquerystring1173478676788457425OA_ID của Zalo OA brand đã nối (GET /v1/platforms). Mỗi brand một OA — có thể bỏ.
dataquerystring (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ênVị tríKiểuBắt buộcMẫuMô tả
dataqueryJson objectCóThông tin truyền vào để lấy dữ liệu

Ví dụ request

curl -s "https://partner.quantri360.com/v1/zalo/v3.0/oa/user/getlist?data=%7B%22offset%22%3A0%2C%22count%22%3A0%7D" \
  -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/v3.0/oa/user/getlist",
    params={
        "data": {
            "offset": 0,
            "count": 0
        }
    },
    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/v3.0/oa/user/getlist');
for (const [k, v] of Object.entries({"data":{"offset":0,"count":0}})) 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/v3.0/oa/user/getlist' . '?' . http_build_query(['data' => '{"offset":0,"count":0}']);
$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ênKiểuMẫuMô tả
errorint0 = thành công; khác 0 xem `message` (Zalo trả HTTP 200 kèm mã lỗi).
messagestringThông điệp của Zalo.
dataobjectDữ liệu.
countintSố lượng người dùng đã request
offsetintThứ tự của người dùng đầu tiên trong danh sách trả về
totalintTổng số lượng người dùng thỏa điều kiện
usersarrayDanh sách ID của tất cả người dùng thỏa điều kiện truyền vào

Mẫu phản hồi

{
    "data": {
        "total": 6,
        "count": 15,
        "offset": 0,
        "users": [
            {
                "user_id": "4572947693969771653"
            },
            {
                "user_id": "8969911359184683656"
            },
            {
                "user_id": "195313740847641158"
            },
            {
                "user_id": "2242767944251000300"
            },
            {
                "user_id": "4476513743385388268"
            },
            {
                "user_id": "7511600376107668429"
            }
        ]
    },
    "error": 0,
    "message": "Success"
}

Bắt đầu dùng

  1. Đăng ký tài khoản Partner
  2. Mở loại dữ liệu thuộc nhóm Official Account & khách hàng ở trang nền tảng
  3. Tạo API key (tick kênh Zalo OA)
  4. Gọi theo ví dụ ở trên