You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.15 06:13:10