使用Twilio+WhatsApp预审批模板发消息仍报错，请求协助排查

核心问题定位 #

你的请求里没有实际调用预审批的WhatsApp消息模板，而是直接发送了自由格式文本（Body=Here's that picture of an owl you requested.）——WhatsApp规则明确：24小时对话窗口外必须使用预审批模板发送消息，哪怕你有已审批模板，未按规范调用仍会触发报错。

具体修复步骤 #

1. 确认预审批模板信息
   先在Twilio控制台找到你已通过审批的模板，记录下它的TemplateSid（或TemplateName），同时确认模板是否支持媒体附件（如果要发送图片）、是否包含变量（若有变量需准备对应值）。

2. 调整请求参数，正确调用模板
   发送模板消息不能用Body参数，需替换为TemplateSid（或TemplateName），如果模板带变量还要加上TemplateData。以下是调整后的curl示例：

   curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json" \
   --data-urlencode "MediaUrl=https://demo.twilio.com/owl.png" \
   --data-urlencode "From=whatsapp:+14155238886" \
   --data-urlencode "To=whatsapp:+15017122661" \
   --data-urlencode "TemplateSid=你的预审批模板SID" \
   -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
   

   若模板包含变量，补充TemplateData参数：

   curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Messages.json" \
   --data-urlencode "MediaUrl=https://demo.twilio.com/owl.png" \
   --data-urlencode "From=whatsapp:+14155238886" \
   --data-urlencode "To=whatsapp:+15017122661" \
   --data-urlencode "TemplateSid=你的预审批模板SID" \
   --data-urlencode "TemplateData={\"变量键名\": \"变量值\"}" \
   -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
   

3. 验证对话窗口状态
   如果用户最近24小时内主动给你发送过消息，处于对话窗口内，可以直接发送自由文本；若窗口已过期，必须严格使用预审批模板。

4. 检查模板合规性

   • 确认模板是针对WhatsApp渠道审批通过的，而非其他渠道
   • 模板内容需与发送需求匹配，带媒体的模板要确保本身支持附件上传
   • 变量使用需与模板定义的位置、格式一致

额外排查点 #

• 检查From号码是否已绑定正确的WhatsApp发送者身份，且该身份有权限使用指定模板
• 确认TemplateSid/TemplateName拼写无误，大小写敏感

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