通过Facebook Graph API发布FB公共主页提及功能失效问题求助

核心原因 #

你遇到的提及被自动过滤的问题，90%以上是权限、功能开通、传参方式三个环节的问题，逐一排查即可：

1. 权限缺失：你当前持有的pages_read_engagement、pages_manage_posts权限不足以实现跨主页提及，还需要额外申请pages_manage_engagement权限，且该权限必须经过App Review审核通过才能生效。
2. 功能未开通：Facebook的「Page Mentioning」属于独立的高级功能，不是权限开通后就能用，需要你在应用后台的功能列表中单独提交申请，审核通过后才能调用。
3. 传参格式错误：你测试的几种直接把@写在message文本里的格式，是v2.8及更早版本API的用法，v11.0版本已经废弃该写法，必须通过结构化的mentions参数单独提交提及信息，直接写在文本里的@会被系统自动过滤。
4. 令牌类型错误：如果你使用的是用户访问令牌而非对应公共主页的Page Access Token发布内容，也会导致提及功能失效，仅能@自身主页。

排查及修复步骤 #

• 先到应用管理后台确认「Page Mentioning」功能已经审核通过，同时检查已获批权限包含pages_manage_posts、pages_read_engagement、pages_manage_engagement三项。
• 生成目标发布主页的长期Page Access Token，调用/debug_token接口确认令牌包含上述三个权限，且归属对象为目标主页而非个人用户。
• 调整发布请求的参数结构，不要将@标识直接写入message文本，将提及信息通过mentions参数提交，示例请求参数如下：

{
  "message": "This is great 示例主页名称",
  "mentions": [
    {
      "id": "109904187850644",
      "offset": 13,
      "length": 6
    }
  ],
  "published": true,
  "access_token": "你的主页访问令牌"
}

参数说明：offset为提及的主页名称在message文本中的起始索引位置，length为主页名称的字符长度，需要和message中的对应内容完全匹配。

• 优先使用你本人名下的其他公共主页作为测试提及对象，排除第三方主页的分类、隐私限制导致的提及失败。
• 若上述操作后仍未生效，可在发布请求中添加debug=all参数，查看接口返回的warning字段，会明确标注提及被过滤的具体原因。

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