为何Facebook Messenger Webhook仅单页面无法接收非贴纸类附件字段？

我之前帮几个开发者排查过类似的单个Facebook页面Webhook异常问题，结合你的描述，给你几个常见的排查方向和可能的原因：

1. 检查Webhook订阅的字段权限 #

这是最常见的诱因之一：你可能只给这个异常页面的Webhook订阅了基础的messages权限，没勾选messages_attachments这类附件相关的子字段。

• 打开Facebook开发者后台，找到对应应用的Webhook设置，定位到这个异常页面的订阅条目
• 确认messages字段的所有子权限（包括附件、多媒体相关）都已启用，保存后重新测试消息接收

2. 验证页面与应用的授权关系 #

有时候页面角色变更或者权限过期，会导致应用无法获取完整的消息附件信息：

• 检查该页面的角色设置，确保你的应用拥有pages_messaging权限，且对应的访问令牌有效、未过期
• 如果最近调整过页面权限，建议重新给应用授权该页面，确保权限范围覆盖多媒体消息读取

3. 核对API版本兼容性 #

不同版本的Facebook Graph API在消息返回格式上可能存在差异：

• 确认你当前使用的API版本是否和官方文档匹配，尝试切换到当前稳定版本（比如v18.0）重新配置Webhook
• 某些旧版本API可能对非贴纸类型附件的返回逻辑有调整，升级后可能解决问题

4. 排查自身服务的消息处理逻辑 #

有可能是你的Webhook接收服务在解析消息时误删了attachments字段：

• 直接抓取Facebook发送到你服务的原始请求包，确认平台是否真的没发送attachments字段，还是你的服务中间件/解析代码处理时丢失了
• 检查是否有自定义的过滤规则，不小心排除了图片、视频这类非贴纸附件的消息字段

问题背景回顾 #

自2020年10月29日起，我的应用关联的多个Facebook页面中，仅单个页面出现问题：Webhook接收的消息里，仅贴纸消息包含attachment字段，图片、视频、音频等其他类型附件消息均无该字段。

预期接收格式：

{
  "id": "682498302938465",
  "time": 1518479195594,
  "messaging": [
    {
      "sender": { "id": "<PSID>" },
      "recipient": { "id": "<PAGE_ID>" },
      "timestamp": 1518479195308,
      "message": {
        "mid": "mid.$cAAJdkrCd2ORnva8ErFhjGm0X_Q_c",
        "attachments": [
          {
            "type": "<image|video|audio|file>",
            "payload": { "url": "<ATTACHMENT_URL>" }
          }
        ]
      }
    }
  ]
}

实际接收格式：

{
  "object": "page",
  "entry": [
    {
      "id": "119320008135788",
      "time": 1604051633128,
      "messaging": [
        {
          "sender": { "id": "XXXXXX" },
          "recipient": { "id": "XXXXXX" },
          "timestamp": 1604051632953,
          "message": { "mid": "m_7DRP...." }
        }
      ]
    }
  ]
}

如果以上排查都无法解决问题，建议你到Facebook开发者支持平台提交工单，详细说明单个页面异常的情况（其他页面正常的对比信息很重要），大概率是平台侧针对该页面的配置出现了异常。

内容的提问来源于stack exchange，提问作者jay