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

Lấy chi tiết người dùng: tên, ảnh, nhãn, thông tin đã chia sẻ, tương tác gần nhất — API Zalo OA

Lấy chi tiết 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 chi tiết người dùng

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

Truy xuất chi tiết một người dùng. Ứ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 Zalo của 360 chưa được duyệt nhóm quyền người dùng (gọi thử 24/10/2026).

Request

Địa chỉ

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

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/detail?data=%7B%22user_id%22%3A%22%22%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/detail",
    params={
        "data": {
            "user_id": ""
        }
    },
    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/detail');
for (const [k, v] of Object.entries({"data":{"user_id":""}})) 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/detail' . '?' . http_build_query(['data' => '{"user_id":""}']);
$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.
user_idstringID của người dùng
user_id_by_appstringID của người dùng ứng với app
user_external_idstringuser_id của người dùng trong hệ thống của Doanh nghiệp. Kết quả sẽ trả về "" nếu user chưa tồn tại user_external_id
display_namestringTên hiển thị của người dùng
user_aliasstringTên alias của người dùng
is_sensitivebooleanCó 2 giá trị: - true: tài khoản này dưới 18 tuổi. - false: tài khoản này từ đủ 18 tuổi trở lên.
user_last_interaction_datestringNgày cuối dùng người dùng có tương tác. Định dạng dd/MM/yyyy
user_is_followerbooleanTrạng thái quan tâm OA của người dùng
avatarstringĐường dẫn đến ảnh đại diện của người dùng (ảnh có kích thước đúng với size ảnh hiển thị trên app Zalo)
avatarsstringĐường dẫn đến ảnh đại diện của người dùng: - 120: đường dẫn đến ảnh size nhỏ hơn kích thước chuẩn. - 240: đường dẫn đến ảnh size lớn hơn kích thước chuẩn.
dynamic_paramstringThông tin về dynamic_param cuối cùng mà người dùng truy cập thông qua Dynamic URL của OA
tags_and_notes_infojsonThông tin nhãn và ghi chú OA gắn cho người dùng "tags_and_notes_info": { "notes": ["Discount 10% mỗi đơn hàng."], "tag_names": [ "Khách VIP", "Phú Nhuận", "Product" ] }
shared_infojsonThuộc tính trả về thông tin người dùng đã chia sẻ cho OA. Nếu không có thông tin, data sẽ trả giá trị rỗng. Ví dụ: "shared_info": { "address": "Z06 Đường số 13", "city": "Hồ Chí Minh", "district": "Quận 7", "phone": 84868602410, "name": "Phạm Khoa", "user_dob": "25/12/1999" }

Mẫu phản hồi

{
  "data": {
    "user_id": "4572947693969771653",
    "user_id_by_app": "4604138790644222978",
    "user_external_id": "Id của người dùng trong hệ thống của Doanh nghiệp",
    "display_name": "Tên hiển thị của người dùng",
    "user_alias": "Tên alias của người dùng",
    "is_sensitive": false,
    "user_last_interaction_date": "06/07/2023",
    "user_is_follower": false,
    "avatar": "https://s120-ava-talk.zadn.vn/5/2/2/e/2/120/e7a622713a730e9c1aeb339343486a55.jpg",
    "avatars": {
      "120": "https://s120-ava-talk.zadn.vn/5/2/2/e/2/120/e7a622713a730e9c1aeb339343486a55.jpg",
      "240": "https://s240-ava-talk.zadn.vn/5/2/2/e/2/240/e7a622713a730e9c1aeb339343486a55.jpg"
    },
    "dynamic_param":"value",
    "tags_and_notes_info": {
      "notes": [
        ""
      ],
      "tag_names": []
    },
    "shared_info": {
      "address": "123 Trần Hưng Đạo",
      "city": "Hồ Chí Minh",
      "district": "Quận 1",
      "phone": "84385953xxx",
      "name": "Tên người dùng"
    }
  },
  "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