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

Form khách hàng tiềm năng của Trang — API Facebook

Page Lead Forms · 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.

Page Lead Forms

GET/{version}/{page_id}/leadgen_formsGọi qua 360: GET https://partner.quantri360.com/v1/facebook/{version}/{page_id}/leadgen_forms
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

Danh sách form khách hàng tiềm năng (form lead) của Trang: tên, trạng thái, số lead, câu hỏi, màn mở đầu / cảm ơn, chính sách riêng tư.

  • Chỉ trả thông tin FORM, không trả người điền — danh sách lead lấy ở GET /{form_id}/leads (cần quyền đọc lead riêng).
  • Trang chưa từng tạo form → {"data": []}.
  • Gọi quá dày → lỗi 80005 (quá nhiều lệnh form lead tới Trang), chờ rồi thử lại.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/facebook/{version}/{page_id}/leadgen_forms

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_idquerystringact_123456789 hoặc 1234567890Tà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ênVị tríKiểuBắt buộcMẫuMô tả
versionpathstringCóv25.0
page_idpathstringCó559411604582644Id Trang đã nối.
fieldsquerystringKhôngid,name,status,locale,leads_count,created_time,questionsTrường cần lấy (mặc định chỉ có id, name, status, locale).
limitqueryintKhông25Số form mỗi trang.
afterquerystringKhôngpaging.cursors.after của trang trước.

Phân trang

Lặp khi có paging.next: thêm after = paging.cursors.after.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/559411604582644/leadgen_forms?fields=id%2Cname%2Cstatus%2Cleads_count%2Ccreated_time%2Cquestions&limit=25" \
  -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/559411604582644/leadgen_forms",
    params={
        "fields": "id,name,status,leads_count,created_time,questions",
        "limit": 25
    },
    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/559411604582644/leadgen_forms');
for (const [k, v] of Object.entries({"fields":"id,name,status,leads_count,created_time,questions","limit":25})) 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/559411604582644/leadgen_forms' . '?' . http_build_query(['fields' => 'id,name,status,leads_count,created_time,questions', 'limit' => 25]);
$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ênKiểuMẫuMô tả
dataobject[]Form lead.
idstring1051871308787985Id form — dùng cho GET /{form_id}/leads.
namestringForm đại lý 2022Tên form.
statusstringACTIVE`ACTIVE` (đang dùng) · `ARCHIVED` (đã lưu trữ) · `DELETED` · `DRAFT`.
localestringvi_VNNgôn ngữ form.
created_timestring2022-07-25T08:04:08+0000ISO 8601, UTC.
leads_countint0Tổng số lead của form.
organic_leads_countint0Số lead không đến từ quảng cáo.
expired_leads_countint0Số lead đã quá hạn lưu, không tải về được nữa.
questionsobject[]Câu hỏi của form.
idstringId câu hỏi.
keystringKhóa câu hỏi — trùng `field_data[].name` của lead.
labelstringSố điện thoại liên hệNhãn hiển thị.
typestringCUSTOM`FULL_NAME` · `EMAIL` · `PHONE` · `CUSTOM` (câu hỏi tự đặt) …
optionsobject[]Lựa chọn `{key, value}` — chỉ có ở câu hỏi nhiều lựa chọn.
context_cardobjectMàn mở đầu: `{id, title, content[], style, cover_photo}`.
thank_you_pageobjectMàn cảm ơn: `{id, title, body, button_text, button_type, website_url, enable_messenger}`.
privacy_policy_urlstringLink chính sách riêng tư.
follow_up_action_urlstringLink nút ở màn cảm ơn.
legal_contentobject`{id, privacy_policy: {url, link_text}}`.
pageobject`{id, name}` Trang sở hữu form.
block_display_for_non_targeted_viewerbooltrue`true` = chỉ người thấy quảng cáo mới mở được form.
is_optimized_for_qualitybooltrue`true` = form có bước xác nhận lại thông tin (lead chất lượng cao hơn).
question_page_custom_headlinestringTiêu đề trang câu hỏi.
tracking_parametersobjectTham số theo dõi tự đặt khi tạo form.
pagingobjectChỉ có khi còn trang.

Bắt đầu dùng

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