Messenger 交接协议:在 AI 代理与真人之间共享粉丝专页收件箱
Meta 用 Conversation Routing 取代了 Messenger 交接协议,同时保留其会话控制调用:pass_thread_control 将会话交给另一个应用,例如应用 ID 为 263902037430900 的粉丝专页收件箱;take_thread_control 认领会话;request_thread_control 请求控制权;release_thread_control 将会话交还为空闲状态。开启路由后,控制会话的应用会收到其消息,其他应用则通过 standby 通道接收。
easyCoexistence 通过一个 MCP 连接器,为您的 AI 代理提供粉丝专页的 Messenger 会话:send_social_dm 可在 24 小时窗口内回复,新消息到达时即转发至您的端点。
Meta 为将会话控制权转交给粉丝专页收件箱而提供的 target_app_id。
错误 10 下的子代码,表示消息因会话被其他应用控制而发送失败。
若用户在此时长内没有发来消息,会话进入空闲状态,此后只有默认应用可以发送消息。
extend_thread_control 能将应用的控制权延长到超出 24 小时响应时限的程度。
使用您的 Business AI 接管会话;关闭时,未加标签发送到 Business AI 会话的消息会以错误 10、子代码 2018300 失败。
交接协议发生了什么变化?
Meta 已将其并入 Conversation Routing。其指南称,Meta 不再支持 Messenger 交接协议,企业已迁移至 Conversation Routing,且该路由与大多数交接协议调用向后兼容,因此 pass_thread_control、take_thread_control 和 messaging_handovers Webhook 预计将继续正常工作。变化在于决定权:企业在粉丝专页设置的 Conversation Routing 下设定默认应用和路由规则。
谁控制会话?
同一时间只有一个应用,Meta 称之为会话所有者。当用户与会话所有者交谈时,会话处于活动状态;若用户已 24 小时未发消息,或所有者已释放控制权,会话则处于空闲状态。在空闲会话中,只有默认应用可以在消息窗口内发送消息。路由规则决定由谁接管会话:
- 默认应用:在没有配置其他应用或其他应用未响应时作出回应的应用。
- 社交路由:当用户打开空闲会话或点击 Get Started 时接管控制的应用。
- 链接路由:分配给每个 m.me 链接的应用。
- 广告系列路由:为 Click-to-Messenger 广告所选的应用,在该会话的消息窗口内(最长 7 天)拥有控制权。
哪些调用会在应用之间转移控制权?
每个调用都是向粉丝专页的 edge 发起的 POST 请求,recipient 设为用户的 PSID,且每个都返回 success true;多数调用还可附带一个 metadata 字符串,由下一个应用接收:
pass_thread_control:将会话交给target_app_id中的应用,该应用会收到一个messaging_handovers事件。release_thread_control:结束应用的控制权,并将会话恢复为空闲状态。take_thread_control:使调用方应用成为所有者,适用于企业允许接管控制权的应用。request_thread_control:请求取得该会话的控制权。extend_thread_control:超出 24 小时响应时限继续保持控制权,最长 7 天,时长以秒为单位。- Send API 可以通过
thread_control对象,随消息一并转移或释放控制权。
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }真人如何介入粉丝专页收件箱?
通过回复。Conversation Routing 将 Meta Business Suite 收件箱视为又一个已连接的应用,企业甚至可以将其设为默认应用。当有人在收件箱中回复一个收件箱并未控制的会话,或将其移至“主要”文件夹时,收件箱即接管控制权。应用可以使用 pass_thread_control 并将 target_app_id 设为 263902037430900,把会话交给真人处理;若应用需要在 24 小时窗口之后转发用户的回复,则须在用户最后一条消息后 7 天内使用 HUMAN_AGENT 标签发送。
当 Meta 的 Business AI 拥有会话时会发生什么?
其他应用会通过 standby 通道接收用户的消息,且不应回复。Meta 的指南称,应在收到带有 pass_thread_control 的 messaging_handovers 事件之后再开始回复;messages 通知可能包含 admin_text,以及 human_requested 或 purchase_intent 等 handoff_reason,但它并不转移所有权。若“使用您的 Business AI 接管会话”保持关闭(即默认设置),发送到该会话且未加标签的消息会以错误代码 10、子代码 2018300 失败。
应用如何检查会话的所有者?
向 /{page-id}/thread_owner 发送 GET 请求,并将 recipient 设为 PSID,即可返回所有者应用的 app_id 及其控制权的到期时间,返回对象可以是所有者本身,或粉丝专页的默认应用。开启路由后,Conversations API 的 is_owner 字段会针对每个会话回答同样的问题;而 GET /{page-id}?fields=messaging_feature_status 则会通过 msgr_multi_app 等字段显示粉丝专页的 Conversation Routing 状态。
没有 Conversation Routing 时会怎样?
Meta 将其称为默认行为,适用于只连接一个应用、由该应用独自接收并回复消息的粉丝专页。所有已连接的应用都会收到 messaging Webhook,并且都可以回复同一条消息;在设置默认应用之前,take_thread_control 会被阻止,且只有广告系列路由可用。Meta 对这种设置的建议是协调应用与粉丝专页收件箱,避免同一条消息被回复两次。
easyCoexistence 在共享收件箱中做什么?
它为每个粉丝专页订阅 feed、messages 和 mention,而不订阅 messaging_handovers、standby 或 message_echoes,因此在其应用接收用户消息的同时转发这些消息,但它既看不到交接事件,也看不到从粉丝专页收件箱发出的回复。send_social_dm 会在没有 thread_control 的情况下发送 RESPONSE;当 Meta 因另一个应用持有会话而拒绝发送时,该工具会将 Meta 的错误代码 10 及其消息返回给您的 AI。会话控制调用、thread_owner 与 is_owner 不在其工具之列。
常见错误
- 回复 standby 消息。这些消息送达的应用并不拥有该会话;应在收到 pass_thread_control 之后再回复。
- 将 admin_text 误读为交接。带有交接上下文的 messages 通知并不转移所有权,只有 messaging_handovers 事件才会转移。
- 在没有路由的情况下让 AI 与收件箱并行运行。在默认行为下,两者都会收到同一条消息,Meta 要求协调以避免两次回复。
- 流程结束后仍持有会话。Meta 建议在应用完成工作后立即释放控制权,而不要等待响应时限到期。
Meta 的会话控制调用不在其工具之列;由人工在粉丝专页收件箱中回复,即可接管会话。每个连接每月 US$ 9 至 US$ 0.75,连接越多越便宜,并提供前 3 天免费试用。
常见问题
同一粉丝专页上的两个应用是否需要 Conversation Routing?
当多个消息应用已连接,且各自应回复特定会话时,Meta 建议使用。若只有一个应用接收并回复,默认行为即可满足需求。
应用会将会话控制权保持多久?
直到应用释放控制权,或会话在用户最后一条消息之后 24 小时进入空闲状态为止。extend_thread_control 可增加时长,最长 7 天。
粉丝专页收件箱的回复会送达其他应用吗?
订阅 message_echoes 的应用会以回声形式收到该回复,其 app_id 为粉丝专页收件箱的 263902037430900,正如 Meta 针对 Graph API v12.0 及更高版本的更新日志所描述。
当用户从收件箱回复时,easyCoexistence 的回复会怎样?
开启 Conversation Routing 后,收件箱会接管控制权;在控制权归还之前,用户的消息只会以 standby 方式到达 easyCoexistence 的应用,而该应用并未订阅 standby。未开启路由时,两者都会继续收到消息。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间