文档首页/ 消息&短信 MSGSMS/ 产品介绍/ 使用须知/ 短信变量须知
更新时间：2024-11-08 GMT+08:00
查看PDF
分享

短信变量须知

变量为每次发送短信时的可修改的部分内容。

变量规范

变量为每次发送短信时的可修改的部分内容。

变量格式规范
  • 每个模板中最多包含20个变量。
  • 不支持连续变量和模板全变量。
  • 变量间包含文字则为不连续变量。

长度规范

若需扩展变量长度，请在申请短信模板时，详细备注使用场景、扩展原因、指明需要扩展长度的变量和扩展后的期望变量长度。

内容规范

以下两种变量格式等效，系统按${}解析识别变量，大括号中的序号标识/类型标识只是方便查阅，并无实际作用。需要为各变量设置变量属性，才能让相应变量规范生效。
当模板内容中设置了变量时，必须指定变量属性。小数点、字母、汉字、空格以及其他符号均按1个变量长度计算。

变量属性

变量类型

规范

电话号码

PHONE

长度限制：4-15个字符。

  • 可以传入座机号、95或400、800电话等。
  • 仅支持数字、"+"、"-"，且以数字结尾。

其他号码（如验证码、订单号等）

CHARDIGIT

长度限制：1-20个字符。

主要用途为验证码、订单号等。

  • 不允许出现手机号、QQ号、微信号、URL等联系方式。
  • 仅支持大小写字母、数字和下划线组合。

时间

DATETIME

长度限制：1-20个字符。

需要符合时间的表达方式，格式示例如下：

  • 日期：yyyyMMdd、yyyy-MM-dd、yyyy/MM/dd、yyyy年mm月dd日。
  • 时间：HH:mm:ss、HH:mm、HH点mm分、HH点mm。

如果需要同时指定日期和时间，请在模板中填充两个变量，一个变量传入日期，另一个变量传入时间。

  • 短信内容示例： 
    温馨提醒：2020-01-10 19:00-21:00的会议即将开始，请您准时参加。
  • 模板示例： 
    温馨提醒：${1} ${2}-${3}的会议即将开始，请您准时参加。

金额

MONEY

长度限制：1-20个字符。

  • 仅支持传入能够正常表达金额的数字、小数点或中文，例如壹、贰、叁、肆等。
  • 支持传入IP地址，例如：10.1.1.10。
说明：

“￥”和“$”等货币符号需要放在模板中，不支持变量传入。

其他（如名称、账号、地址等）

TEXT

长度限制：1-20个字符。

  • 可以设置为公司/产品/地址/姓名/内容/账号/会员名等。
  • 不允许出现QQ号/微信号（公众号）/手机号/网址/座机号等联系方式。如果确有需要，请将联系方式放入模板中。
  • 不允许在传入值中携带“.”、“。”、“ ' ”、“<”、“>”、“{”或“}”。否则，可能导致模板变量解析异常。
  • 不允许在传入值中携带“.”，即不支持传入IP地址，如变量取值为IP地址，请申请模板时选择变量属性为“金额”。
    须知：

    变量取值不能包含单引号和大括号（“{”或“}”）字符，否则会导致模板变量检验失败。

变量示例

变量格式

填写示例

说明

按序号标识

${1}、${2}、...、${20}
  • 长度限制：1-20个字符。
  • 中间数字应代表变量在模板内容中的位置顺序。即${1}表示模板内容中的第一个变量，${2}表示模板内容中的第二个变量，以此类推。
说明：

特殊内容（如网址、手机号等）不允许设置局部变量，如www.${1}.cn、186${2}1234等。

按类型标识

${PHONE}、${CHARDIGIT}、${DATETIME}、${MONEY}、${TEXT}

中间字符表示变量类型，各变量有默认长度限制，不支持自定义设置。

如有任何疑问，请联系华为云智能客服，将有专人为您解答。

父主题： 使用须知

相关文档