生产环境下WhatsApp Messaging Webhook无法正常工作求助

一、核心排查步骤 #

• 确认Webhook订阅事件范围：检查是否勾选了messages、message_received这类具体触发事件，仅勾选messaging可能无法覆盖用户消息的推送逻辑。
• 验证企业号与Meta App的关联关系：在Business Manager中确认WhatsApp企业ID已绑定到你的Meta App，且绑定状态未失效。
• 核对Graph API订阅权限：调用{business_id}/subscribed_apps时，确认你的Meta App已获取whatsapp_business_messaging权限，且权限状态为active。
• 测试生产环境端点可用性：用Postman等工具模拟Meta生产环境的Webhook请求（匹配官方消息事件结构），确认端点在生产环境下能正常返回200状态码——部分服务器会对生产环境请求设置额外防火墙或路由规则。

二、关于Meta App验证的说明 #

生产环境下接收用户发送的WhatsApp消息确实需要完成Meta App验证，无界面的Webhook应用也可按以下流程操作：

1. 准备验证材料：
   • 完善应用基本信息，明确标注应用仅作为后端Webhook接收WhatsApp消息，无前端界面。
   • 提交功能说明文档：详细描述Webhook的用途（多渠道消息汇总）、接收的事件类型、数据处理逻辑。
   • 提供有效技术联系人信息，确保Meta能对接审核问题。
2. 提交验证申请：
   • 在Meta开发者后台进入应用的「验证」页面，选择「Business验证」。
   • 按指引提交材料，无需提供登录说明，在备注中明确说明应用为纯后端Webhook服务。
3. 等待审核通过：审核完成后，生产环境Webhook即可正常接收用户消息。

三、额外检查项 #

• 确认WhatsApp企业号已完成号码验证，且处于活跃状态，无功能限制。
• 查看Meta开发者后台的应用日志，排查是否存在消息转发失败的错误记录，这类日志会直接提示权限或配置问题。

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