使用Meta App Access Token无法获取线索的问题求助

应用开发中尝试获取线索测试工具创建的线索：

• 使用Page Access Token测试时一切正常；
• 使用App Access Token向https://graph.facebook.com/v17.0/发送GET请求时，触发错误：

(#3) Apps in dev mode should only access leads submitted from App special roles (testers, developers, admin)

• 应用已切换到Live模式，无法理解错误原因。
  预期按文档返回线索数据，实际收到上述OAuth错误响应。

1. 核心权限逻辑问题 #

App Access Token的定位是应用级操作凭证（比如管理应用设置、拉取应用全局统计），它本身不具备直接获取页面线索数据的权限——无论应用处于Dev还是Live模式，App Access Token都只能访问由应用特殊角色（开发者、测试者、管理员）提交的线索，这是Facebook API的硬限制，和应用是否上线无关。

而Page Access Token才是访问页面资产（包括线索数据）的正确凭证，只要它带有leads_retrieval或ads_management权限，且页面已授权给你的应用，就能正常获取所有合法线索（包括Live模式下普通用户提交的线索）。

2. 正确的调用方式 #

放弃用App Access Token获取线索，改用Page Access Token调用对应端点：

GET https://graph.facebook.com/v17.0/{page-id}/leadgen_forms/{form-id}/leads

替换路径中的{page-id}和{form-id}为你的实际页面ID和线索表单ID。

3. 额外排查点 #

• 验证Page Access Token权限：在Graph API Explorer中检查Token是否包含leads_retrieval权限，若缺失需重新让页面授权给应用；
• 测试线索来源：如果用线索测试工具创建线索，确保测试账号属于应用的特殊角色；若应用已Live，也可以用普通用户提交真实线索来验证获取逻辑。

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