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

Meta Platforms, Inc. · 企业办公

Meta Business Suite 是 Meta Platforms 官方推出的免费企业经营应用，接替了早年的 Facebook Pages Manager（公共主页管理）应用。管理员选定一个 Facebook 公共主页后，即可连同其关联的 Instagram 专业账号和 WhatsApp Business 号码一起管理，只在 Instagram 上经营的商家同样可以用它打理。主要界面包括：内容日历与帖子详情页，集中查看主页发布过的全部内容，并可就地把符合条件的帖子加热为付费推广；统一收件箱，把 Messenger、Instagram Direct 与 WhatsApp 对话合并成一个会话列表，支持文件夹、客户标签与收件箱搜索；线索中心，把 Instant Form 线索汇总成线索列表和单条线索卡片，并可回链到线索来源的对话；联系人标签页，客户名片上记录标签、备注以及每条线索所处的销售阶段；还有追踪帖子表现与互动者的主页洞察。应用在美国区 Google Play 上架，是中小企业和主页管理员在手机上处理社交客服、线索跟进与日常发帖的工具；同类产品有 Hootsuite、Sprout Social、Agorapulse、Buffer 等第三方社交媒体管理套件，而它是 Meta 自家出品的免费第一方选择。

一个 Facebook 公共主页就是整套数据的根记录：page_id 连同 ig_business_id 与 wa_id 把主页与其关联的 Instagram、WhatsApp 身份绑定在一起，has_linked_ig_account、has_linked_whats_app、is_ig_only_presence 等标记说明这一企业存在如何连接，另附 asset_name、asset_type 与头像。已发布内容都挂在这个 id 下，每条帖子带有 boostPostStatus、bizPostContentType、productType、postMedias 与 insightUserData——发了什么、以什么形式、能否加热推广，以及附带的洞察互动者，细到其 profilePicUri 头像。

消息侧是按渠道划分的会话状态：messenger_connected、instagram_connected、whatsapp_connected 标出各渠道是否已就绪可同步；收件箱会话以 thread_id 为键，带有 last_message_id、last_message_timestamp_ms、thread_type 以及 msys_sync_cursor、sync_status 等同步游标，每条会话再补全 customerTags、folder、snippetWithEntities 与 blockedByViewerStatus。线索经 lead_id 解析，可选的 thread_id 把线索回链到原对话；客户经 contact_id 与 business_id 解析，从收件箱搜索或联系人标签页打开的联系人卡片承载标签、备注、资料、简介、CTA 与线索商机阶段。

集成正是建在这些数据之上：客服平台把 Messenger、Instagram 与 WhatsApp 的会话状态汇入同一个坐席队列，不让客户消息沉在没人盯的渠道里；CRM 在线索卡片与客户名片到达时即时抓取，带着标签、备注与线索上下文开出商机，免去从收件箱人工誊抄；营销看板按推广状态与内容类型追踪主页帖子，看清哪些在线、哪些在投流、每周发帖节奏如何。openData Studio 把这些主页、收件箱、线索与联系人数据变成可调用的开放数据，供这些集成直接使用。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

加载企业主页资产

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

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

认证方式：所选企业资产的主页级访问令牌，作为 access_token 查询参数随 sdk 与 format 标志一起发送。

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
}

列出主页帖子

POST /v1/content/posts/list opendata

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

认证方式：来自当前企业会话的主页级访问令牌；帖子读取以命名文档的形式经应用的 GraphQL 通道提交。

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"}]
          }
        ]
      }
    }
  }
}

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

POST /v1/inbox/channels/validate opendata

告知消息中心 Messenger、Instagram Direct 与 WhatsApp 会话是否已就绪可合并。

认证方式：来自已登录管理员会话的主页级访问令牌；就绪校验会标识 Android 客户端界面。

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}
    }
  }
}

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

POST /v1/inbox/threads/validate osint

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

认证方式：来自已登录管理员会话的主页级访问令牌；一致性校验携带本地按渠道同步的快照。

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"
  }
}

获取线索卡片

POST /v1/leads/cards/get osint

加载该主页的单条 Instant Form / 线索中心记录（可选关联会话 id），用于线索详情页。

认证方式：主页级访问令牌；线索读取的作用域限定为当前企业会话的主页 id。

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"
    }
  }
}

获取客户联系人卡片

POST /v1/contacts/cards/get osint

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

认证方式：主页级访问令牌；联系人读取接受一个限定在企业资产范围内的身份输入。

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"
    }
  }
}

数据类别

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

数据使用场景与案例

统一收件箱客服台
客服平台把 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 区分资产范围；这些是第一方端点，没有公开的匿名访问方式。

与 Meta Business Suite 相似的应用

Hootsuite — 面向企业级用户的社交媒体管理平台，现有方案内置 Talkwalker 提供的舆情聆听功能。
Buffer — 简洁易上手的排期发布工具，免费方案可管理三个社交渠道。
Sprout Social — 高端社交媒体管理套件，具备强大的原生分析与报表能力，面向规模较大的团队。
Later — 以 Instagram 为先的可视化内容规划工具，同时提供 link-in-bio 主页链接功能。
Agorapulse — 以互动管理为核心的套件，把各社交平台的消息、评论与提及汇总进同一个收件箱。
Loomly — 以日历为核心的内容工具，侧重帮助团队决定发什么内容，而不只是何时发布。
SocialBee — 按内容分类组织帖子的排期工具，可循环再发旧帖，让发布队列不会断更。
Sendible — 面向代理商的排期工具，入门方案支持六个社交账号且不限团队成员数。

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

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

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

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

应用截图

API 端点一览

加载企业主页资产

列出主页帖子

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

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

获取线索卡片

获取客户联系人卡片

数据类别

数据使用场景与案例

统一收件箱客服台

线索捕获管道

主页内容监控

常见问题

与 Meta Business Suite 相似的应用

更多企业办公类应用

Box

CryptoRush: Crypto Simulator

Darwinbox

Dayforce

相关主题

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

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

应用截图

API 端点一览

加载企业主页资产

列出主页帖子

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

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

获取线索卡片

获取客户联系人卡片

数据类别

数据使用场景与案例

统一收件箱客服台

线索捕获管道

主页内容监控

常见问题

相关应用

与 Meta Business Suite 相似的应用

更多企业办公类应用

Box

CryptoRush: Crypto Simulator

Darwinbox

Dayforce

相关主题

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