WhatsApp Business API嵌入注册后Webhook无消息及号码异常求助

问题1：Webhook订阅后无法接收消息事件 #

• 确认事件订阅配置：登录Meta开发者后台，检查Webhook的订阅事件列表，必须勾选messages、message_statuses等你需要接收的事件类型。仅完成Webhook验证但未订阅事件的话，只会收到验证请求，不会触发消息相关的推送。
• 验证POST请求处理逻辑：Webhook验证用的是GET请求，而消息事件是POST请求。要确保你的服务器端点能正确解析POST请求的JSON payload，并且在10秒内返回200 OK响应。可以用Postman或curl模拟POST请求测试端点是否正常工作。
• 检查网络拦截规则：服务器的防火墙、安全组或CDN可能拦截了Meta的Webhook请求。需要将Meta官方公布的Webhook IP范围加入白名单，确保请求能到达你的服务器。
• 验证Access Token权限：确认订阅Webhook时使用的access_token有效且拥有whatsapp_business_messaging权限。可以调用GET /{phone-number-id}接口，通过返回结果判断token是否正常。
• 核实号码绑定状态：在Meta商务平台查看注册号码的状态，确保号码已成功绑定到目标WhatsApp Business Account，且状态为ACTIVE。如果号码处于未激活或受限状态，消息事件不会被推送。

问题2：注册号码失效、新号码提示“请1小时后重试” #

• 使用合规实体号码：必须使用真实的、未关联过其他WhatsApp Business Account的实体手机号，虚拟号码、网络电话号会被Meta风控系统直接标记，导致号码失效或无法注册。
• 停止异常操作并等待：短时间内多次注册同一账号、同一IP频繁尝试注册会触发风控。严格按照提示等待1小时，期间不要重复操作，同时更换一个未用于过注册的IP地址。
• 重置WhatsApp Business App：卸载并重新安装WhatsApp Business App，清除本地缓存，避免残留的异常注册数据影响新号码的验证流程。
• 检查账号限制状态：登录Meta商务平台查看你的Business Account是否存在违规或限制记录。如果有，需要提交申诉说明情况，解除限制后再尝试注册新号码。
• 确保企业信息真实一致：注册时填写的企业信息必须真实有效，且与号码的所属主体一致。虚假信息或主体不匹配会导致号码被标记失效，触发重试限制。

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