求助：WhatsApp Cloud API Webhook未返回messages对象

问题场景 #

我的WhatsApp Cloud API应用突发故障，Webhook接收不到messages对象，返回结果如下：

{
"object": "whatsapp_business_account",
"entry": [
    {
        "id": "1900820329959633",
        "changes": [
            {
                "value": {
                    "messaging_product": "whatsapp",
                    "metadata": {
                        "display_phone_number": "16315551234",
                        "phone_number_id": "16315551234"
                    },
                    "statuses": []
                },
                "field": "messages"
            }
        ]
    }
  ]
}

官方Postman集合中正常返回messages对象，且排查发现：

• Facebook开发者健康检查页面显示异常
• 另一开发者账号的Cloud API Webhook可正常返回messages对象
• 其他用户也出现相同问题

排查与解决步骤 #

1. 确认平台服务状态 #

既然已有其他用户反馈同类问题，且官方健康页显示异常，优先确认服务状态：

• 查看开发者后台的服务通知栏，是否有API故障、维护或功能调整的公告
• 同步同区域用户的故障情况，判断是否为区域性或全局服务问题

2. 验证Webhook配置 #

即使另一账号正常，仍需检查当前应用的Webhook设置：

• 确认Webhook订阅的messages字段已正确勾选，未被误取消
• 重新触发Webhook验证流程，确保回调URL能正确返回hub.challenge参数，验证服务连通性
• 检查应用权限，确认whatsapp_business_messaging相关权限已启用且未过期

3. 检查号码与应用关联状态 #

• 确认当前使用的phone_number_id已正确绑定到对应WhatsApp Business Account，未被移除或标记异常
• 查看号码状态，是否存在违规限制、未完成身份验证等情况

4. 提交官方支持工单 #

若以上排查均无问题，直接在Facebook开发者后台提交技术支持工单：

• 描述故障现象、返回示例、已完成的排查步骤及其他用户的反馈情况
• 提供应用ID、phone_number_id等关键信息，帮助官方快速定位问题

5. 临时业务保障方案 #

若故障持续影响业务，可临时切换到已验证的可用开发者账号，确保业务正常运行，待原账号故障修复后再切回

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