一、变量格式规范
- 使用
${变量名}
格式,如${code}
或${order}
- 变量名首字母必须为英文字母,仅支持字母、数字和下划线组合
- 禁止使用纯数字变量名,禁用敏感词如mobile、email等
正确示例:您的验证码为:${code},有效期${time}分钟
二、模板创建步骤
- 登录阿里云控制台,进入短信服务模块
- 在模板管理页面点击添加模板
- 选择模板类型(验证码/通知/营销)并输入模板内容
- 在需要动态替换的位置插入变量表达式
- 提交审核并等待平台审批(通常需1-2工作日)
三、变量应用场景示例
典型应用场景包括:
- 验证码通知:
验证码:${code},5分钟内有效
- 订单提醒:
订单${order}已发货,物流单号:${logistics}
- 会议通知:
${time}在${place}召开${meeting}会议
四、审核常见问题
审核失败常见原因:
- 变量未明确使用场景(如未说明
${time}
的时间格式) - 变量属性未正确匹配(如将电话号码填入普通文本变量)
- 营销类短信未勾选支持拒收选项
五、API调用传参方法
发送短信时需通过JSON格式传递变量值:
PhoneNumbers": "13800138000", SignName": "阿里云", TemplateCode": "SMS_12345", TemplateParam": {"code":"1234","time":"5"}
注意变量名需与模板定义完全一致,区分大小写
正确使用短信模板变量需严格遵循平台规范,建议在正式发送前通过测试环境验证变量替换效果。开发过程中建议使用子账号AccessKey并配置环境变量确保安全。