使用WhatsApp Business Platform测试账号发送非模板消息失败咨询

你遇到的问题是WhatsApp Business Platform沙箱（测试）环境的默认规则限制：

• 模板消息属于预审核通过的官方允许主动触达内容，因此可以直接发送成功
• 非模板文本消息，只有当目标手机号先给你的测试号码发送过任意一条消息后，你才能主动给对方发送这类消息。哪怕API返回成功响应，不符合这个条件的消息会被系统拦截，无法投递到用户手机

解决步骤 #

1. 用目标手机（91ZZZZZZZZZZ）给你的WhatsApp测试号码发一条任意消息（比如发送“hi”）
2. 再次调用你提供的非模板文本消息API请求，就能正常收到消息了

你的请求与响应对比 #

成功的模板消息请求 #

{
   "messaging_product":"whatsapp",
   "to":"91ZZZZZZZZZZ",
   "type":"template",
   "template":{
      "name":"hello_world",
      "language":{
         "code":"en_US"
      }
   }
}

模板消息响应 #

{
   "messaging_product":"whatsapp",
   "contacts":[
      {
         "input":"91ZZZZZZZZZZ",
         "wa_id":"91ZZZZZZZZZZ"
      }
   ],
   "messages":[
      {
         "id":"wamid.HBgMOTE3MjkwMDIxMzYwFQIAERgSMjZCRkQ3RDc0RjM0QkNEZZZZZZ=="
      }
   ]
}

非模板文本消息请求（格式正确但受规则限制） #

{
   "messaging_product":"whatsapp",
   "to":"91ZZZZZZZZZZ",
   "type":"text",
   "text":{
      "preview_url":false,
      "body":"Hello World Testing"
   }
}

非模板消息响应（请求合法但未投递） #

{
   "messaging_product":"whatsapp",
   "contacts":[
      {
         "input":"91ZZZZZZZZZZ",
         "wa_id":"91ZZZZZZZZZZ"
      }
   ],
   "messages":[
      {
         "id":"wamid.HBgMOTE3MjkwMDIxMzYwFQIAERgSQUJERkM2RUE1RTEwQTExZZZZZZ=="
      }
   ]
}

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