已配置正确权限仍无法通过Graph API发送消息的问题排查

问题背景 #

已为应用配置以下权限：email、pages_show_list、business_management、pages_messaging、pages_messaging_subscriptions、instagram_basic、instagram_manage_comments、instagram_manage_insights、instagram_content_publish、instagram_manage_messages、pages_read_engagement、pages_manage_metadata、pages_read_user_content。

两名应用管理员用户均拥有对应Facebook主页及关联的企业Instagram账号，但其中一位用户调用Graph API发送消息时返回403错误，错误详情如下：

error Data: {
  error: {
    message: '(#200) Please check if access token has enough IG permissions granular scopes for IG to send API, or if IGSID is valid.',
    type: 'OAuthException',
    code: 200,
    error_subcode: 2534067,
    fbtrace_id: 'AouX27HuHoQBu65bb6rBUal'
  }
}
Error Status: 403
Error Headers: AxiosHeaders {
  vary: 'Origin',
  'access-control-allow-origin': '*',
  'cross-origin-resource-policy': 'cross-origin',
  'x-app-usage': '{"call_count":5,"total_cputime":0,"total_time":3}',
  'content-type': 'application/json',
  'www-authenticate': 'OAuth "Facebook Platform" "insufficient_scope" "(#200) Please check if access token has enough IG permissions granular scopes for IG to send API, or if IGSID is valid."',
  'facebook-api-version': 'v19.0',
  'strict-transport-security': 'max-age=15552000; preload',
  pragma: 'no-cache',
  'cache-control': 'no-store',
  expires: 'Sat, 01 Jan 2000 00:00:00 GMT',
  'x-fb-request-id': 'AouX27HuHoQBu65bb6rBUal',
  'x-fb-trace-id': 'ERIKbq1Rjf7',
  'x-fb-rev': '1012935256',
  'x-fb-debug': 'mVMrRrBF3H+nrrHR45BNeWtyqALnup35FrQb9RD8JNQCpmH3n8NhTPYqWVns6Snt1oY6x7RCHIvGzO1cJLP9UQ==',
  date: 'Sat, 20 Apr 2024 18:38:20 GMT',
  'proxy-status': 'http_request_error;  
......... <some other headers>
'x-fb-connection-quality': 'EXCELLENT; q=0.9, rtt=5, rtx=0, c=10, mss=1380, tbw=372, tp=-1, tpl=-1, uplat=514, ullat=0',
  'alt-svc': 'h3=":443"; ma=86400',
  connection: 'close',
  'content-length': '241'
}

尝试创建新应用仅添加问题用户后，错误依旧；添加正常用户并使用其页面令牌则可正常发送消息，需解决所有管理员账号均可正常发送消息的问题。

可能的原因及解决方案 #

1. 问题用户的访问令牌缺少细分权限 #

错误信息明确提示insufficient_scope和granular scopes，即使应用已配置权限，用户授权时可能未同意全部细分项：

• 让问题用户重新走授权流程，确保授权弹窗中勾选所有与Instagram消息相关的权限（重点确认instagram_manage_messages的细分权限）
• 使用Facebook官方的访问令牌调试功能，检查问题用户的令牌是否包含instagram_manage_messages权限，且令牌状态为有效

2. 问题用户的Instagram账号与Facebook主页关联异常 #

表面关联正常不代表底层绑定无问题：

• 让问题用户进入Facebook主页设置 → 关联的账户 → Instagram，解除关联后重新绑定企业账号
• 确认问题用户在Facebook主页内拥有完全控制或消息管理权限，仅应用管理员角色不足以操作主页关联的Instagram消息功能

3. 应用测试用户或权限审批状态问题 #

如果应用处于开发模式，正常用户可能是测试用户而问题用户不是：

• 检查应用状态：若为开发模式，将问题用户添加到应用的测试用户列表中
• 若应用已提交审核，确认instagram_manage_messages权限已通过审核，且问题用户的账号在权限覆盖范围内

4. 访问令牌类型错误 #

确保使用的是页面访问令牌而非用户访问令牌：

• 引导问题用户按正确流程获取令牌：先获取用户访问令牌，再交换为对应Facebook主页的页面访问令牌
• 调用/{page-id}/accounts接口，验证页面令牌是否已关联到目标Instagram账号

5. 错误子码2534067的特定排查 #

该子码对应Instagram消息权限的细分范围问题：

• 检查问题用户的Instagram账号是否因违反社区规范被限制消息功能
• 确认API调用端点正确：发送Instagram消息需使用/{ig-user-id}/messages端点，而非Facebook页面消息端点

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