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

Thống kê tương tác của page theo giờ — API Pancake Chat

get /pages/{page_id}/statistics/pages · 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.

get /pages/{page_id}/statistics/pages

GET/public_api/v1/pages/{page_id}/statistics/pagesGọi qua 360: GET https://partner.quantri360.com/v1/pancake_chat/public_api/v1/pages/{page_id}/statistics/pages
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ê tương tác của trang THEO GIỜ: số tin / bình luận của khách, số tin / bình luận trang trả lời, khách mới, hội thoại mới, hội thoại có tương tác, SĐT thu được. Cộng các giờ ra tổng ngày / kỳ — dùng cho báo cáo hiệu quả trực page và tỉ lệ xin được số.

  • Thiếu since → {"message":"since is required!","success":false}; khoảng > 1 năm → {"message":"Statistics date range cannot exceed one calendar year","success":false} (HTTP 200).
  • since / until là Unix UTC nhưng hour trả theo giờ của trang: gửi 00:00–23:59 giờ VN (since = 1793120400, until = 1793206799) nhận các mốc 2026-10-28T04:00:00 … 2026-10-28T21:00:00.
  • Chỉ có giờ phát sinh số liệu: thử thật 1 ngày → 13 mốc, 31 ngày → 319 mốc. Muốn tổng ngày / kỳ thì tự cộng.

Request

Địa chỉ

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

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

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
page_idpathstringCó107896751234567Mã trang đã nối với 360.
sincequerytimestampCó1793120400Từ (Unix giây, UTC).
untilquerytimestampCó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/pages?since=1793120400&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/pages",
    params={
        "since": 1793120400,
        "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/pages');
for (const [k, v] of Object.entries({"since":1793120400,"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/pages' . '?' . http_build_query(['since' => 1793120400, '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ênKiểuMẫuMô tả
successbooltrue`false` + `message` khi lỗi (HTTP vẫn 200).
dataobject[]Mỗi phần tử một GIỜ có hoạt động (giờ không có gì bị bỏ qua), cũ trước.
hourstring2026-10-28T20:00:00Mốc giờ — GIỜ CỦA TRANG (trang VN = giờ VN), dù since / until là UTC.
customer_inbox_countint1Tin nhắn của khách.
customer_comment_countint0Bình luận của khách.
page_inbox_countint104Tin trang gửi.
page_comment_countint0Bình luận trang trả lời.
new_customer_countint0Khách mới.
new_inbox_countint0Hội thoại inbox mới.
inbox_interactive_countint1Hội thoại inbox có tương tác.
phone_number_countint0SĐT thu được.
uniq_phone_number_countint0SĐT không trùng.
today_uniq_website_referral / today_website_guest_referralint0Khách đến từ website (không trùng / lượt).

Mẫu phản hồi

{
  "success": true,
  "data": [
    {
      "hour": "2026-10-28T04:00:00",
      "new_customer_count": 0,
      "customer_inbox_count": 1,
      "customer_comment_count": 0,
      "page_inbox_count": 1,
      "page_comment_count": 0,
      "phone_number_count": 0,
      "inbox_interactive_count": 1,
      "new_inbox_count": 0,
      "uniq_phone_number_count": 0,
      "today_uniq_website_referral": 0,
      "today_website_guest_referral": 0
    },
    {
      "hour": "2026-10-28T20:00:00",
      "new_customer_count": 0,
      "customer_inbox_count": 0,
      "customer_comment_count": 0,
      "page_inbox_count": 104,
      "page_comment_count": 0,
      "phone_number_count": 0,
      "inbox_interactive_count": 0,
      "new_inbox_count": 0,
      "uniq_phone_number_count": 0,
      "today_uniq_website_referral": 0,
      "today_website_guest_referral": 0
    }
  ]
}

Bắt đầu dùng

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