将 Facebook 主页订阅到 Webhook:subscribed_apps 边
通过 POST /{page-id}/subscribed_apps 将 Facebook 主页订阅到应用的 Webhook,传入 subscribed_fields(例如 feed,messages),并使用具备 CREATE_CONTENT、MANAGE 或 MODERATE 任务的人员所持有的主页访问令牌,同时需已获授予 pages_manage_metadata 与 pages_show_list。只有应用也订阅了某个字段时,Meta 才会发送该字段的事件;GET 可列出订阅,DELETE 则将其移除。
easyCoexistence 通过 subscribed_apps 为您连接的每个主页订阅 feed、messages 与 mention,移除主页时取消订阅,并通过一个 MCP 连接器或 Partner API,将主页事件以该主页专属的密钥签名后转发至您的 HTTPS 端点。
只有在主页和应用两个层级都订阅的字段才会产生 Webhook;主页可以列出比应用更多的字段。
主页任务:持有令牌的人员需要具备其中一项任务,才能读取或创建订阅。
应用通过 DELETE 移除主页的 Webhook 订阅时,会与 success 并列返回 messaging_success。
/{app-id}/subscriptions 读取、创建或删除应用级订阅所需的条件。
一小时内 Messenger 投递失败后,Meta 会取消应用与主页的订阅,直至应用重新订阅。
subscribed_apps 边的作用是什么?
它将应用安装到主页上,并设定应用接收主页哪些 Webhook 字段。只有主页已安装应用、且未在设置中禁用应用平台时,Meta 才会发送通知,并且仅针对两个层级都已订阅的字段:一是主页层级(通过此边设置),二是应用层级(在应用控制台中设置,或通过 /{app-id}/subscriptions 设置)。主页可订阅的字段可以多于应用。
如何订阅主页?
向该边发送 POST 请求,在 subscribed_fields 中以逗号分隔列出字段,并附上主页的访问令牌。调用成功时返回 success true;若列出了 messages,令牌还需具备 pages_messaging 权限:
POST https://graph.facebook.com/{page-id}/subscribed_apps
?subscribed_fields=feed,messages,mention
&access_token=<PAGE_ACCESS_TOKEN>
{ "success": true }需要哪些令牌、任务和权限?
主页访问令牌,它将调用绑定到某一个主页,且须来自能够代表该主页操作的人员。Meta 的参考文档与指南规定了以下要求:
- 任意字段:持有
CREATE_CONTENT、MANAGE 或 MODERATE 任务的人员,并具备pages_manage_metadata与pages_show_list。 - messages 及其他 Messenger 字段:另需
pages_messaging,且令牌须来自能够执行 MESSAGING 任务的人员。 - leadgen:需要 ADVERTISE 任务,并具备
leads_retrieval、pages_read_engagement与ads_management。 - 使用 GET 读取订阅所需的任务与权限,与创建订阅相同。
字段需要哪种访问级别?
高级访问权限,适用于主页以及应用自身角色之外的人员。在标准访问权限下,Messenger 通知仅来自在应用中拥有角色的人员,例如管理员、开发者和测试人员;高级访问权限需通过应用审核逐项授予,并且需要商家认证,从而让应用的客户也能接收通知。Meta 的 Messenger 指南还将发布应用列为前提条件之一。
什么是应用级订阅?
这是另一半:应用自身监听的字段,以及其回调 URL。它可以在应用控制台中设置,也可以使用应用访问令牌,通过 POST /{app-id}/subscriptions 设置,传入 object=page、callback_url、fields、include_values 与 verify_token,并会触发 Meta 的验证请求。对同一边执行 GET 可显示每个对象的 callback_url、fields 以及订阅是否处于激活状态;新的 POST 会修改字段而不覆盖其他字段;DELETE 则删除全部字段,或删除指定的字段。
如何检查主页订阅了什么?
对同一边使用主页的令牌发送 GET 请求。data 数组列出主页已安装的每个应用,包括其名称、ID 与 subscribed_fields;若主页未安装任何应用,则返回空数组:
GET https://graph.facebook.com/{page-id}/subscribed_apps
?access_token=<PAGE_ACCESS_TOKEN>
{
"data": [
{
"category": "Business",
"link": "https://example.com/app",
"name": "<APP_NAME>",
"id": "<APP_ID>",
"subscribed_fields": ["feed", "messages", "mention"]
}
]
}如何移除订阅?
使用 DELETE /{page-id}/subscribed_apps,它会解除应用与主页的关联;应用也可以使用应用访问令牌移除自身的订阅,响应中包含 success 与 messaging_success。Meta 也会自行移除订阅:Messenger 投递失败持续一小时后,应用会被取消与主页的订阅,待其端点恢复正常后需重新订阅。
easyCoexistence 在连接时做什么?
在您选择每个主页并保存其令牌后,随即为该主页订阅:POST /{page-id}/subscribed_apps,subscribed_fields 设为 feed,messages,mention。若 Meta 拒绝,该主页仍保持连接,list_social_accounts 会在 last_error 中显示原因。移除主页时,会先发送 DELETE /{page-id}/subscribed_apps,然后才丢弃令牌;没有任何工具可访问 subscribed_apps 与 token 路径,因此该订阅仅由 easyCoexistence 管理。
常见错误
- 使用用户访问令牌调用该边。它需要的是被订阅主页的主页访问令牌。
- 只订阅了主页,未订阅应用。只有应用自身的订阅也包含某字段,该字段才会到达回调。
- 订阅 messages 时遗漏 pages_messaging。Meta 要求此权限,且令牌须来自能够执行 MESSAGING 任务的人员。
- 故障后忘记重新订阅。一小时的 Messenger 投递失败会取消应用的订阅,在重新发送 POST 之前,事件将停止推送。
每个连接每月 US$ 9 起,随连接数增加降至 US$ 0.75;前 3 天免费试用。
常见问题
我需要分别为每个主页订阅吗?
需要。subscribed_apps 按主页工作,使用该主页自己的令牌;而针对 page 对象的应用级订阅则适用于已安装该应用的主页。
为什么 subscribed_apps 返回错误代码 200?
Meta 将 200 列为该边的权限错误。请检查令牌是否具备 pages_manage_metadata 与 pages_show_list,并确认其来自持有 CREATE_CONTENT、MANAGE 或 MODERATE 任务的人员。
能否通过 Graph API Explorer 订阅主页?
可以。Meta 的指南要求选择应用,获取具备 pages_manage_metadata 的用户令牌,将其换取为主页的令牌,然后向 {page-id}/subscribed_apps 发送 POST 请求。
我能为已连接 easyCoexistence 的主页添加 Webhook 字段吗?
不能通过其工具操作:没有任何工具可访问 subscribed_apps 路径,主页将保持订阅 feed、messages 与 mention,即 easyCoexistence 转发的字段。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间