遭遇WhatsApp Cloud API“Messaging may be unavailable”错误求助

• 先查测试号的状态和权限
  进Meta Business Manager的WhatsApp管理页，确认测试号是“已激活”状态，没被限制发送。新注册的号可能得先补全商业账户的基础验证信息，才能解锁发送功能。

• 目标号码必须符合要求

  • 目标号得是正常使用的WhatsApp注册号码，没被封禁。
  • 测试号只能给添加过的测试联系人发消息：去API测试配置里手动把目标号加进测试联系人列表，不然消息会被直接拦截。

• 核对API调用的参数
  要是用API发OTP，检查这几个点：

  • phone_number必须带国家代码（比如+86），不能有空格或特殊字符。
  • template得用Meta官方预审核的OTP模板，自定义模板没通过审核的话发不出去。
  • Authorization头里的API令牌要正确，没过期、权限够。

• 看Meta平台的通知
  进Meta开发者后台的“Notifications”页面，有没有关于测试号或API的限制通知——有时候“Messaging may be unavailable”是因为触发了反垃圾机制，这里会给具体原因。

• 测试API连通性
  用curl调用基础端点测连通性，比如获取测试号信息：

  curl -X GET "https://graph.facebook.com/v18.0/{你的测试号ID}" \
  -H "Authorization: Bearer {你的访问令牌}"
  

  返回正常信息说明连通没问题；要是报错，根据错误码查令牌或权限问题。

• 重置测试号
  前面都没用的话，删了当前测试号，重新生成一个新的，再走一遍配置流程——偶尔会碰到测试号初始化异常的情况。

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