无法通过Webhook接收WhatsApp messages通知,求排查建议
WhatsApp Webhook无法接收messages通知的排查步骤
- 确认Webhook订阅字段权限:检查WhatsApp商务账户的Webhook配置,必须明确勾选messages相关的所有子字段(如messages、message_reactions等),不能仅勾选顶级的whatsapp_business_account项,务必展开子选项确认勾选状态。
- 验证测试消息触发逻辑:使用Meta测试手机号时,确保是从绑定的测试用户手机号发送消息给测试号,而非反向发送;点击Webhook测试按钮时,要确认选择的是「messages」事件类型,避免选错事件。
- 排查Glitch服务的请求处理逻辑:
- 检查服务是否正确解析messages事件的payload结构,确认代码中处理了
entry -> changes -> value -> messages的层级路径,不要只适配了account_alerts的解析逻辑。 - 确认服务对POST请求返回了200 OK响应,Meta要求Webhook必须返回200才会持续推送事件,若存在错误拦截或异常响应,会导致消息推送失败。
- 查看Glitch的服务日志,确认是否有messages事件的请求进入,若日志中完全无记录,说明Meta未推送请求;若有记录但处理报错,针对性修复代码逻辑。
- 检查服务是否正确解析messages事件的payload结构,确认代码中处理了
- 检查测试号状态:确认Meta提供的测试手机号未被限制,且已正确关联到当前配置Webhook的WhatsApp商务账户,在「测试号码」管理页面中能看到该号码且状态正常。
- 验证签名验证逻辑(若开启):如果Webhook开启了签名验证,确认Glitch服务中使用了正确的App Secret,且签名校验逻辑无误——若校验失败,服务可能直接拒绝请求,导致messages事件无法被接收。
内容的提问来源于stack exchange,提问作者floatingpurr
相关产品推荐
相关产品推荐

