Facebook Leadgen Webhook返回模拟数据而非真实线索问题排查

你收到的响应是Facebook线索事件的基础通知元数据，而非用户填写的实际线索内容——这是真实线索的正常推送逻辑（测试线索为了方便调试会直接返回字段数据）。要获取完整线索信息，需按以下步骤处理：

一、核心原因 #

Facebook Webhook的leadgen事件推送仅返回线索的标识性元数据（如leadgen_id、form_id等），实际用户填写的表单字段需要通过Graph API主动调用来获取，这是真实线索的标准流程，和测试线索的调试逻辑存在差异。

二、解决步骤 #

1. 确认页面权限授权有效性 #

• 进入目标Facebook页面的「设置」→「高级」→「页面角色」→「已授权的应用」，确认你的应用已被添加，且leads_retrieval权限处于有效状态。
• 确保授权应用的用户拥有该页面的管理员/编辑角色，避免因权限层级不足导致后续API调用失败。

2. 通过Graph API拉取完整线索数据 #

拿到Webhook推送中的leadgen_id后，调用以下Graph API端点获取完整线索内容：

GET /{leadgen_id}?fields=field_data,created_time,page_id,ad_id

其中field_data字段会返回用户填写的所有表单信息，示例响应如下：

{
  "field_data": [
    {"name": "full_name", "values": ["张三"]},
    {"name": "email", "values": ["zhangsan@example.com"]}
  ],
  "created_time": "2024-08-29T08:44:06+0000",
  "page_id": "444444444444",
  "ad_id": "444444444",
  "id": "444444444444"
}

3. 排查额外配置问题 #

• 检查Webhook订阅的leadgen事件是否关联了正确的页面：进入Facebook开发者后台→你的应用→Webhooks→页面，确认订阅列表包含产生真实线索的目标页面。
• 确认leads_retrieval权限的高级访问范围：在应用的「权限与功能」中，查看该权限的高级访问是否覆盖目标页面所属的业务账号。

三、注意事项 #

• 真实线索的Webhook通知存在数分钟延迟（测试线索为即时推送），若未立即收到可等待或检查Webhook的重试机制。
• 调用API需使用有效的页面访问令牌或应用访问令牌，且令牌需包含leads_retrieval权限。

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