使用Twilio内容模板通过Zapier发WhatsApp消息报错21619求助

问题详情 #

使用Twilio文本模板发送WhatsApp消息，模板内容如下：

Thank you for your order, please download your video:
{{1}}

通过Zapier发起application/x-www-form-urlencoded格式请求，请求体：

To=whatsapp:+61*********&From=whatsapp:+61*********&ContentSid=HX***********52&ContentVariables={"1":"Test"}

收到400错误响应，错误码21619，提示：A text message body or media urls must be specified.

解决方案 #

1. 对ContentVariables进行URL编码 #

请求采用application/x-www-form-urlencoded格式时，JSON结构的ContentVariables必须经过URL编码，否则Twilio无法正确解析变量，会判定为未提供有效内容。

编码后的ContentVariables参数为：%7B%221%22%3A%22Test%22%7D，完整请求体如下：

To=whatsapp:+61*********&From=whatsapp:+61*********&ContentSid=HX***********52&ContentVariables=%7B%221%22%3A%22Test%22%7D

2. 切换为JSON格式请求 #

若不想处理URL编码，可将请求的Content-Type改为application/json，直接使用JSON结构作为请求体，无需编码：

{
  "To": "whatsapp:+61*********",
  "From": "whatsapp:+61*********",
  "ContentSid": "HX***********52",
  "ContentVariables": {"1": "Test"}
}

在Zapier配置请求时选择JSON格式即可。

3. 验证模板状态 #

确认对应ContentSid的WhatsApp模板已通过审核，未审核的模板无法正常发送，也可能触发该错误。

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