使用Webhook获取Meta/Facebook页面Leadgen线索时存在丢失问题

• 检查Webhook的重试机制与超时设置
  Meta的Webhook在首次请求失败（超时、5xx错误）时会触发重试，但如果你的端点响应时间超过Meta建议的10秒阈值，或者出现间歇性的5xx错误，Meta可能会终止重试流程，导致线索丢失。务必确认你的服务端响应稳定，日志中无超时或错误返回记录。

• 验证Webhook订阅配置与权限有效性
  确认你已正确订阅leadgen事件的所有子字段，且应用的pages_show_list、pages_manage_leadgen权限未过期。可以通过Graph API执行/{page-id}/subscribed_apps调用，核对当前订阅的事件列表是否完整。

• 查看Meta端Webhook错误日志
  登录Meta Business Manager，进入对应页面的Webhook设置，查看错误报告模块。这里会记录Meta推送失败的请求细节，比如HTTP状态码、连接超时原因，能帮你排查是否存在网络层面的拦截（如防火墙、DNS解析问题）。

• 核对线索统计维度与延迟推送情况
  Ads Manager的线索统计可能包含测试线索、未提交完成的表单，或统计范围与Webhook接收的范围不一致（如跨页面、跨广告系列的线索）。同时，部分线索可能因Meta内部处理存在延迟推送，需拉长统计时间范围再对比。另外检查你的系统是否存在误去重逻辑，导致合法线索被过滤。

• 测试真实网络环境下的推送
  虽然本地模拟请求正常，但可以使用工具模拟Meta服务器的IP段发起请求，验证是否存在网络访问限制。部分企业防火墙会拦截未知IP的请求，导致Meta的推送无法到达。

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