WhatsApp Business API Webhook订阅正常但无法接收消息求助
排查WhatsApp Business API Webhook收不到消息通知的常见问题
- 确认Webhook绑定的业务号码:商务账户下可能关联多个号码,要检查Webhook是否明确绑定到用户发消息的那个具体号码,而非仅完成账户级订阅却未关联目标号码。
- 核查权限的应用范围:即便token拥有
whatsapp_business_management和whatsapp_business_messaging权限,也要确认权限是否覆盖当前业务号码——部分场景下权限仅绑定特定号码或沙箱环境,正式号码无法复用。 - 验证Webhook响应合规性:测试请求能到达服务器不代表响应符合要求,Meta要求收到通知后必须返回200 OK状态码,且响应体为
{"success": true},不符合规范会导致后续推送被终止。 - 检查业务号码状态:确认接收消息的号码处于已激活状态,未被限制或因沙箱到期、未付费导致功能暂停,这类状态下消息事件不会被推送。
- 查看Meta事件日志:在WhatsApp商务账户的Webhook设置中,查看事件日志记录,里面会显示推送失败的具体原因(如响应超时、格式错误等)。
- 确认消息子类型全勾选:开启
messages事件后,要确保所有消息子类型(text、image、audio等)都已勾选,仅勾选部分类型会导致对应消息无法触发通知。
内容的提问来源于stack exchange,提问作者user25694928
相关产品推荐
相关产品推荐

