使用Twilio发送WhatsApp模板消息报错63016求助

错误原因 #

错误码63016的核心原因是你用普通文本消息的发送逻辑调用了模板消息：直接把替换占位符后的完整文本写在body参数里，这种方式不会触发Twilio的模板匹配机制，系统会判定你在发送未经审核的自定义内容，因此报错。

正确的模板消息发送方式 #

发送带占位符的审核通过模板，必须使用Twilio专属的模板调用参数，而非body参数。具体步骤如下：

1. 获取模板Content SID：在Twilio控制台的「Content Library」或「WhatsApp Templates」页面，找到你已通过审核的模板，复制其Content SID（格式示例：HXxxxxxx）。
2. 调整代码参数：用contentSid指定模板标识，用contentVariables传入占位符变量（需为JSON字符串格式）。

修正后的代码示例 #

const accountSid = process.env.ACCOUNTSID;
const authToken = process.env.AUTHTOKEN;
const client = require('twilio')(accountSid, authToken);

client.messages
.create({
    from: 'whatsapp:MY_NUMBER',
    // 替换为你的模板Content SID
    contentSid: 'HX_YOUR_APPROVED_TEMPLATE_SID',
    // 对应模板中的{{1}}占位符，键名需和占位符编号一致
    contentVariables: JSON.stringify({
        "1": "Joe"
    }),
    to: 'whatsapp:DESTINATION_NUMBER'
})
.then(message => console.log(message.sid))
.catch(error => console.error(error));

额外验证要点 #

• 确认contentSid与审核通过的模板完全匹配，无复制错误；
• contentVariables的键名要和模板占位符编号一一对应（比如模板是{{1}}，变量键就是"1"），数量也要一致；
• 发送方from号码必须和模板绑定的WhatsApp Business账号关联；
• 确保模板状态为「Approved」（已通过审核），而非待审核或被拒状态。

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