Tin nhắn trong một hội thoại — API Facebook

Conversation Messages

GET/{version}/{conversation_id}/messagesGọi qua 360: GET https://partner.quantri360.com/v1/facebook/{version}/{conversation_id}/messages

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

Tin nhắn trong một hội thoại (nội dung, người gửi, đính kèm).

Request

Địa chỉ

GET https://partner.quantri360.com/v1/facebook/{version}/{conversation_id}/messages

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	act_123456789 hoặc 1234567890	Tài sản Facebook brand đã nối với 360: tài khoản quảng cáo (act_<id> hoặc <id>), Page id hoặc Pixel id — lấy ở GET /v1/platforms. Có thể bỏ khi đường dẫn đã chứa act_<id> / page id của brand.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu
version	path	string	Có	v25.0
conversation_id	path	string	Có	t_123456789
fields	query	string	Có	id,message,from,created_time,attachments{mime_type,image_data,file_url}
limit	query	int	Không	100
after	query	string	Không

Ví dụ request

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/t_123456789/messages?fields=id%2Cmessage%2Cfrom%2Ccreated_time&limit=100" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/facebook/v25.0/t_123456789/messages",
    params={
        "fields": "id,message,from,created_time",
        "limit": 100
    },
    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/facebook/v25.0/t_123456789/messages');
for (const [k, v] of Object.entries({"fields":"id,message,from,created_time","limit":100})) 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/facebook/v25.0/t_123456789/messages' . '?' . http_build_query(['fields' => 'id,message,from,created_time', 'limit' => 100]);
$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 Facebook)

Tên	Kiểu	Mẫu	Mô tả
data	object[]
id	string	m_…
message	string
from	object		{id, name}
created_time	string
paging	object

Bắt đầu dùng

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