跳到主要内容

Facebook Messenger

接入对象是 Facebook Page：Messenger 消息通过签名 Webhook 到达 Anyy，回复由 Page Access Token 授权发送。当前只提供私信，不提供 Facebook 群聊。

平台和回调都要准备​

在 Meta App 启用 Messenger，准备 Page ID、App ID、Page Access Token、App Secret，以及自己设置的 Webhook Verify Token。完成 Page 消息事件订阅与 Messaging 权限；App Review 和测试角色要求以官方入门文档为准。

按共享 Webhook 设置开启 Anyy 的独立监听并配置公网 HTTPS。回调路径为：

/channels/facebook/ACCOUNT_ID/webhook

默认账号 ID 为 page；Meta 和 Anyy 中的 Verify Token 必须一致。代理不能改写验签请求体或丢掉签名 Header。

在 Anyy 保存连接​

Dashboard 渠道 → 添加 → Facebook 的 Messenger Webhook 接入填写两项标识和三项凭据。策略默认 pairing；策略选择通过 anyy setup channel 的 CLI 向导处理，凭据页没有这些输入。

当前 DM 策略值为 pairing/open/allowlist/disabled。配对可以授权已核对身份的发送者；现有公开表单不提供此平台名单条目编辑，见消息平台。

anyy channel pairing list --channel facebook
anyy channel pairing approve --request REQUEST_ID

用有资格的账号测试​

anyy channel reload
anyy channel doctor facebook

应用尚未对外发布时，先用 Meta App/Page 角色账号测试，分别检查 Challenge、签名事件、配对和回复。

  • 回调无法验证：HTTPS 可达性与 Verify Token。
  • 签名被拒绝：App Secret 和代理保留的原 Body/Header。
  • 能收不能发：Page Token、Page 身份与 Messaging 权限。
  • 只有管理员能用：平台 App 模式、审核与订阅范围。

平台接受一次发送也不表示用户已读；不明结果的处理见渠道健康说明。