Twilio Flow模板消息体指定位置及WhatsApp模板使用报错求助

排查与修复步骤 #

• 确认组件模板配置方式：
  使用「Send Message」组件时，必须在「Message Body」区域选中「Use a template」选项，再粘贴模板SID，不能选「Write your own message」后填入SID。后者会被系统判定为自定义消息，因未提供有效内容触发报错。
• 核对模板SID准确性：
  从Twilio控制台「Messaging > Templates」页面复制完整的模板SID（格式为HXXXXXX开头），不要复制模板名称或描述字段，避免SID不匹配。
• 验证模板状态与适用范围：
  确认模板处于「Approved」状态，且适用国家/地区覆盖目标用户的号码归属地。待审核（Pending）或已拒绝（Rejected）的模板无法正常调用。
• 填充模板变量（若有）：
  如果模板包含占位变量（如{{1}}），必须在组件的「Template Variables」区域为每个变量赋值。未填充变量会导致系统无法生成完整消息体，引发报错。
• 检查执行日志细节：
  在Twilio控制台「Studio > Flows > 对应Flow > Logs」中，查看报错记录的请求参数，确认TemplateSid已正确传入，同时检查To号码格式是否带国家代码（如+1XXXXXXXXX）。

快速测试方案 #

若以上步骤无效，可创建一个极简测试Flow：仅保留一个「Send Message」组件，使用无变量的已审核模板测试发送。若测试Flow正常运行，说明原Flow存在其他逻辑干扰了消息发送。

内容的提问来源于stack exchange，提问作者Pieter le Roux