WhatsApp Cloud API webhook无法接收部分消息问题咨询

问题背景 #

我正在尝试接入WhatsApp Cloud API，目前已完成Meta Business Account创建、WhatsApp应用配置，同时完成webhook配置并订阅了messages事件（配置截图如下）：

我通过如下API请求成功发送了测试消息：

curl -i -X POST \
  https://graph.facebook.com/v13.0/103690452403982/messages \
  -H 'Authorization: Bearer MY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "messaging_product": "whatsapp", "to": "MY_NUMBER", "type": "template", "template": { "name": "hello_world", "language": { "code": "en_US" } } }'

当前已验证的正常链路：

• 可正常收到该API发出的消息，且消息会正常推送到webhook
• 针对该条API消息的回复内容，也可正常通过webhook接收

问题现象 #

其他WhatsApp账号（非通过API触发会话）向绑定的业务号码主动发送消息时，WhatsApp终端可正常收到消息，但webhook不会被触发调用。

个人初步猜测：使用其他手机号向业务号码发消息时，聊天窗口会显示E2E端到端加密提示，而API发起的会话聊天窗口无该提示，推测是否因为E2E加密消息仅收件人可解密，因此无法推送到webhook？
希望帮忙指出可能遗漏的配置点。

解答 #

E2E端到端加密提示和webhook不触发完全无关。所有走Cloud API的消息Meta服务端都可正常解析推送，两类会话的加密提示只是前端展示差异，不影响推送链路。

按优先级排查以下配置点即可解决：

1. 补全Webhook订阅层级
   90%以上的这类问题都是只在应用层配置了webhook订阅，没有在WhatsApp Business Account（WABA）层级绑定webhook并订阅messages事件：
   • 应用层的webhook仅能收到应用主动发起会话的相关事件、用户对这类会话的回复事件
   • 用户主动发起的入站消息属于WABA层级事件，必须进入WABA管理后台，在「集成」-「Webhook」板块绑定和应用层一致的回调地址，同时勾选messages相关订阅字段，才能收到这类推送。
2. 检查号码接管冲突
   确认你绑定到Cloud API的业务号码，没有同时登录/绑定其他WhatsApp端，包括：
   • 个人版WhatsApp、WhatsApp Business App移动端
   • 其他第三方WhatsApp托管服务、自建本地部署的WhatsApp Business API实例
     多端同时绑定同一个号码时，入站消息会按优先级路由到非Cloud API的端，Meta不会生成对应webhook推送任务。
3. 校验测试号白名单配置
   如果你当前还在使用测试阶段的号码（未完成正式商业注册），需要确认主动发消息的账号已经被添加到测试号的「允许发送消息的联系人」白名单中。测试阶段非白名单用户主动发的消息，只会投递到终端，不会触发webhook推送。
4. 排查webhook服务适配问题
   • 先确认Webhook订阅的Graph API版本和你发消息用的v13.0版本一致，低于v12.0的webhook订阅不支持用户主动发起会话的消息推送。
   • 去Meta开发者后台的Webhook日志板块，查对应时间点有没有主动入站消息的投递记录：如果有投递记录且显示投递失败，检查你的服务是否对Meta的Webhook出口IP做了拦截，同时确认你的接口收到这类消息时返回了200 OK状态码——如果连续多次返回非200状态码，Meta会自动暂停该类事件的推送。
   • 注意用户主动发起的消息payload结构和API会话回复的结构有差异，不要写死payload校验逻辑过滤掉这类请求。
5. 关闭WABA侧的消息接管功能
   进入WABA设置页，检查是否开启了离线消息托管、自动回复代理这类官方增值功能，开启这类功能后主动入站消息会被Meta侧服务接管，不会推送到自定义webhook。

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