Tag — API Pancake Chat - Partner Quantri360

get /pages/{page_id}/statistics/tags

GET/public_api/v1/pages/{page_id}/statistics/tagsGọi qua 360: GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/statistics/tags

Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.

Mô tả API

Thống kê NHÃN theo ngày: mỗi nhãn của trang được gắn bao nhiêu trong từng ngày. Dùng để theo dõi phễu bằng nhãn (vd "bước 1" → "bước 2" → "Mua hàng") hoặc số hội thoại bị gắn "Hết size" / "Cần xử lý" theo ngày.

Thiếu since → since is required!; khoảng > 1 năm → Statistics date range cannot exceed one calendar year (HTTP 200, success:false).
categories chỉ là DD/MM và bỏ ngày không có phát sinh — khoảng dài qua năm phải tự suy năm theo thứ tự. Thử thật 60 ngày → 38 nhãn ngày.
Mã nhãn ở đây là chuỗi tag_32, còn ở /tags và /conversations là số 32.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/statistics/tags

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	107896751234567	page_id đã nối — có thể bỏ (lấy từ đường dẫn).

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
page_id	path	string	Có	107896751234567	Mã trang đã nối với 360.
since	query	timestamp	Có	1792602000	Từ (Unix giây, UTC).
until	query	timestamp	Có	1793206799	Đến (Unix giây, UTC). Khoảng tối đa 1 năm.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/tags?since=1792602000&until=1793206799" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/107896751234567/statistics/tags",
    params={
        "since": 1792602000,
        "until": 1793206799
    },
    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/pancake_chat/public_api/v1/pages/107896751234567/statistics/tags');
for (const [k, v] of Object.entries({"since":1792602000,"until":1793206799})) 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/pancake_chat/public_api/v1/pages/107896751234567/statistics/tags' . '?' . http_build_query(['since' => 1792602000, 'until' => 1793206799]);
$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 Pancake Chat)

Tên	Kiểu	Mẫu	Mô tả
success	bool	true
data	object		Dạng biểu đồ theo ngày.
categories	string[]	["22/10","23/10"]	Ngày `DD/MM` (không có năm), cũ trước — CHỈ những ngày có phát sinh.
series	object		Khóa `tag_<mã nhãn>`; giá trị = mảng `{ total, pin }` ứng với từng phần tử của `categories`.
total	int	1	Số liệu ròng của nhãn trong ngày — có thể ÂM (gỡ nhiều hơn gắn).
pin	int	2	Số liệu thứ hai Pancake trả cho nhãn trong ngày; thực tế luôn ≥ `total`.
data_today	object		Cùng cấu trúc `data` cho hôm nay (thực tế thường rỗng).
tags	object[]		Danh sách nhãn: id dạng `tag_<mã>` (khớp khóa `series`), text, color, lighten_color, is_lead_event, description.

Mẫu phản hồi

{
  "success": true,
  "data": {
    "categories": [
      "27/10",
      "28/10"
    ],
    "series": {
      "tag_32": [
        {
          "total": -1,
          "pin": 0
        },
        {
          "total": 1,
          "pin": 2
        }
      ],
      "tag_36": [
        {
          "total": 1,
          "pin": 1
        },
        {
          "total": 2,
          "pin": 2
        }
      ]
    }
  },
  "data_today": {
    "categories": [],
    "series": {
      "tag_32": [],
      "tag_36": []
    }
  },
  "tags": [
    {
      "id": "tag_32",
      "text": "bước 1",
      "color": "#4b5577",
      "lighten_color": "rgba(75,85,119,0.4)"
    },
    {
      "id": "tag_36",
      "text": "Mua hàng",
      "color": "#26afff",
      "lighten_color": "rgba(38,175,255,0.4)"
    }
  ]
}

Bắt đầu dùng

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