Meta Business Suite 数据 API：公共主页、收件箱与线索

Meta Platforms, Inc. · 电商

Meta Business Suite 把 Facebook 公共主页、Instagram 专业账号与 WhatsApp 的消息、内容与线索收进一个客户端。页面数据来自一套以 JSON 为主的私有 API：GET /v1/business/assets/{asset_id} 加载当前主页资产，POST /v1/content/posts/list 拉取已发布内容列表。

统一收件箱通过 POST /v1/inbox/threads/validate 校验 Messenger、Instagram Direct 与 WhatsApp 会话快照；线索与客户资料则分别由 POST /v1/leads/cards/get 和 POST /v1/contacts/cards/get 水合。

Meta Business Suite（前身 Pages Manager）是 Meta 官方安卓客户端，用于管理 Facebook 公共主页、Instagram 专业账号、广告、统一收件箱、线索与客户联系人。其数据 API 覆盖主页资产、内容、消息与 CRM 卡片。

应用截图

API 端点一览

加载企业主页资产

GET /v1/business/assets/{asset_id} opendata

加载当前作用域的企业存在（Facebook 公共主页及关联的 Instagram / WhatsApp 账号），作为其他界面的上下文。

认证方式： Page-scoped access token for the selected business asset, sent as the access_token query parameter alongside sdk and format flags.

page_id
asset_id
asset_name
asset_type
auth_token
bpn_id
ig_business_id
wa_id
profile_pic_url
ig_profile_pic_url
has_linked_ig_account
has_linked_whats_app
has_presence_node
is_ig_only_presence
is_facebook_profile
is_tool_ready
scope_id

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/business/assets/17841400000000000?fields=page_id,asset_id,asset_name,asset_type,auth_token,ig_business_id,wa_id,profile_pic_url,ig_profile_pic_url,has_linked_ig_account,has_linked_whats_app,is_ig_only_presence,is_facebook_profile,is_tool_ready,has_presence_node,scope_id,bpn_id&format=json&sdk=android&access_token=<page-access-token> HTTP/1.1

{
  "page_id": 17841400000000000,
  "asset_id": 17841400000000000,
  "asset_name": "Example Bakery",
  "asset_type": "PAGE",
  "auth_token": "<page-access-token>",
  "bpn_id": 1234567890,
  "ig_business_id": 17841405309200000,
  "wa_id": 15551234567,
  "profile_pic_url": "https://cdn.example.net/p200x200/page.jpg",
  "ig_profile_pic_url": "https://cdn.example.net/t51.2885-19/ig.jpg",
  "has_linked_ig_account": true,
  "has_linked_whats_app": true,
  "has_presence_node": true,
  "is_ig_only_presence": false,
  "is_facebook_profile": false,
  "is_tool_ready": true,
  "scope_id": 17841400000000000
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

reconstructed from the business-asset scoping flow that runs when a Page is selected
field names mirror the business-presence model every Suite screen hangs off

列出主页帖子

POST /v1/content/posts/list opendata

返回公共主页的已发布内容列表（动态帖子、可推广标记、媒体与逐帖元数据）。

认证方式： Page-scoped access token from the current business session; the posts read is submitted as a named document over the app's GraphQL transport.

id
boostPostStatus
bizPostContentType
productType
postMedias
insightUserData
profilePicUri

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/content/posts/list HTTP/1.1
Content-Type: application/json

{"page_id": "17841400000000000", "access_token": "<page-access-token>"}

{
  "data": {
    "page": {
      "id": "17841400000000000",
      "posts": {
        "nodes": [
          {
            "id": "17841400000000000_122118000000000000",
            "boostPostStatus": "ELIGIBLE",
            "bizPostContentType": "PHOTO",
            "productType": "FEED",
            "postMedias": [{"uri": "https://cdn.example.net/post.jpg"}],
            "insightUserData": [{"profilePicUri": "https://cdn.example.net/p50x50/user.jpg"}]
          }
        ]
      }
    }
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

reconstructed from the Suite content calendar and post-detail screens

校验统一收件箱渠道就绪状态
POST /v1/inbox/channels/validate opendata
告知消息中心 Messenger、Instagram Direct 与 WhatsApp 会话是否已就绪可合并。
认证方式： Page-scoped access token from the signed-in admin session; the readiness check identifies the Android client surface.
- page_id
- instagram_connected
- messenger_connected
- whatsapp_connected
- client_surface
- client_time_unix_seconds
- validation_tracking_id
- client_channels
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/inbox/channels/validate HTTP/1.1
Content-Type: application/json

{"page_id": "17841400000000000", "query_params": {"client_channels": {"instagram_connected": true, "messenger_connected": true, "whatsapp_connected": true}, "client_surface": "android_app", "client_time_unix_seconds": 1758500000, "validation_tracking_id": "trk-01"}, "access_token": "<page-access-token>"}
```
```
{
  "data": {
    "inbox_channel_readiness": {
      "messenger": {"is_ready": true},
      "instagram": {"is_ready": true},
      "whatsapp": {"is_ready": false}
    }
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- reconstructed from the unified-inbox channel onboarding and readiness check

校验收件箱会话列表（Messenger / IG / WhatsApp）

POST /v1/inbox/threads/validate osint

上传本地 Messenger / Instagram Direct / WhatsApp 会话快照（id、最后消息等），换取统一的会话列表。

认证方式： Page-scoped access token from the signed-in admin session; the consistency check carries the local per-channel sync snapshot.

thread_id
last_message_id
last_message_timestamp_ms
thread_type
thread_subtype
authority_level
parent_thread_key
msys_sync_cursor
sync_status
sync_epoch_id
sync_network_channel
sync_failure_count
db_treads
ui_treads
id
pageCommItemId
customerTags
folder
snippetWithEntities
blockedByViewerStatus

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/inbox/threads/validate HTTP/1.1
Content-Type: application/json

{"query_params": {"validation_tracking_id": "trk-01", "client_time_unix_seconds": 1758500000, "messenger": {"sync_status": "COMPLETE", "msys_sync_cursor": "cursor-abc", "sync_failure_count": 0, "sync_epoch_id": "99", "sync_network_channel": 1, "db_treads": [{"thread_id": "1234567890", "last_message_id": "mid.$cAAAA", "last_message_timestamp_ms": "1758499900000", "thread_type": 1, "authority_level": 0}], "ui_treads": [{"thread_id": "1234567890", "last_message_id": "mid.$cAAAA"}], "thread_ids": []}, "instagram": {}, "whatsapp": {}}, "access_token": "<page-access-token>"}

{
  "data": {
    "inbox_thread_validation": {
      "is_consistent": true
    }
  },
  "thread": {
    "id": "t_1234567890",
    "pageCommItemId": "17841400000000000",
    "customerTags": [{"name": "VIP"}],
    "folder": "INBOX",
    "snippetWithEntities": {"text": "Hi, is the order ready?"},
    "blockedByViewerStatus": "NOT_BLOCKED"
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

reconstructed from the unified inbox sync-consistency check
thread rows hydrate with customer tags, folder and snippet

获取线索卡片
POST /v1/leads/cards/get osint
加载该主页的单条 Instant Form / 线索中心记录（可选关联会话 id），用于线索详情页。
认证方式： Page-scoped access token; the lead read is scoped to the Page id of the current business session.
- lead_id
- page_id
- include_details
- include_thread_id
- thread_id
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/leads/cards/get HTTP/1.1
Content-Type: application/json

{"page_id": "17841400000000000", "lead_id": "l:123456789012345", "include_details": true, "include_thread_id": true, "access_token": "<page-access-token>"}
```
```
{
  "data": {
    "lead": {
      "lead_id": "l:123456789012345",
      "page_id": "17841400000000000",
      "include_details": true,
      "include_thread_id": true,
      "thread_id": "t_1234567890"
    }
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- reconstructed from the lead-card and leads-list surfaces

获取客户联系人卡片

POST /v1/contacts/cards/get osint

水合 CRM 联系人卡片（身份、标签、备注、资料、关于、CTA、线索机会等字段）。

认证方式： Page-scoped access token; the contact read takes an identity input scoped to the business asset.

contact_id
business_id
type
surface
include_about
include_config
include_cta
include_identity
include_labels
include_notes
include_profile
include_tos
include_lead_opportunity
business_asset_id
business_assets

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/contacts/cards/get HTTP/1.1
Content-Type: application/json

{"identity": {"contact_id": "c:9876543210", "business_id": "17841400000000000", "type": "FACEBOOK"}, "surface": "INBOX", "include_about": true, "include_config": true, "include_cta": true, "include_identity": true, "include_labels": true, "include_notes": true, "include_profile": true, "include_tos": true, "include_lead_opportunity": true, "business_assets": [{"business_asset_id": "17841400000000000"}], "access_token": "<page-access-token>"}

{
  "data": {
    "contact": {
      "contact_id": "c:9876543210",
      "business_id": "17841400000000000",
      "type": "FACEBOOK",
      "surface": "INBOX",
      "include_about": true,
      "include_labels": true,
      "include_notes": true,
      "include_profile": true,
      "include_lead_opportunity": true,
      "business_asset_id": "17841400000000000"
    }
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

reconstructed from the customer contact card opened from inbox search and the contacts tab

数据类别

企业资产
帖子
收件箱
线索
联系人
主页洞察

数据使用场景与案例

统一收件箱客服台
客服平台把 Messenger、Instagram、WhatsApp 的会话状态——会话类型、未读数、同步游标——汇聚到一个坐席队列，不再有客户消息沉在没人盯的渠道里。
线索捕获管道
CRM 在线索到达的瞬间抓取向导卡片与客户名片，自动带着标签、备注与线索上下文开出商机，替代人工从收件箱誊抄。
主页内容监控
营销看板列出主页帖子及其推广状态与内容类型，追踪哪些内容在线、哪些在投流，以及数周内的发帖节奏。

常见问题

Meta Business Suite 使用什么数据 API？

客户端围绕主页资产调用一套私有 API：GET /v1/business/assets/{asset_id} 返回当前 Facebook 公共主页及其关联的 Instagram / WhatsApp 账号；帖子、收件箱、线索与联系人各有专用端点，均以 JSON 交换数据。

统一收件箱的数据来自哪里？

应用先通过 POST /v1/inbox/channels/validate 确认 Messenger、Instagram Direct 与 WhatsApp 渠道就绪，再用 POST /v1/inbox/threads/validate 上传本地会话快照（会话 id、最后一条消息等），换取合并后的会话列表。

线索（Leads）卡片包含哪些字段？

POST /v1/leads/cards/get 返回单条 Instant Form / 线索中心记录：联系人身份、表单答案、来源广告与可选的关联会话 id，用于线索详情页。

该 API 如何认证？

所有调用都依赖登录后的主页访问令牌（page access token），并按 page_id / ig_business_id 区分资产范围；这些是第一方端点，没有公开的匿名访问方式。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

获取报价

Meta Business Suite 数据 API：公共主页、收件箱与线索

应用截图

API 端点一览

加载企业主页资产

列出主页帖子

校验统一收件箱渠道就绪状态

校验收件箱会话列表（Messenger / IG / WhatsApp）

获取线索卡片

获取客户联系人卡片

数据类别

数据使用场景与案例

统一收件箱客服台

线索捕获管道

主页内容监控

常见问题

相关应用

相关主题

需要集成这个 App 的数据 API？