更新时间:2023-12-28 GMT+08:00

短信服务

短信服务连接器用于对接华为云短信服务,可以通过短信服务发送短信。

前提条件

使用短信服务连接器时,需要开通短信服务

创建短信服务连接

  1. 登录新版ROMA Connect控制台。
  2. 在左侧导航栏选择“连接器”,在连接器页面单击“新建连接”。
  3. 选择“短信服务”连接器。
  4. 在弹窗中配置连接器信息,完成后单击“确定”。

    参数

    说明

    连接名称

    填写连接器实例名称。

    App Key

    接入密钥。创建消息&短信应用时,平台会自动生成APP_Key和APP_Secret,用于调用短信API时的鉴权。

    App Secret

    接入密钥。创建消息&短信应用时,平台会自动生成APP_Key和APP_Secret,用于调用短信API时的鉴权。

    描述

    填写连接器的描述信息,用于识别不同的连接器。

支持的动作

发送短信

配置参数

参数

说明

区域

短息服务所在的区域。

项目

短息服务所在的项目。

通道号码

填写短息发送的通道号码。

  • 国内短信填写为短信平台为短信签名分配的通道号码,请在申请短信签名时获取签名通道号,如:csms100000001,且通道号码对应的签名类型和模板ID对应的模板类型必须相同。
  • 国际/港澳台短信填写为创建短信应用时分配的通道号,如:isms100000001。 请在短信控制台“国内短信>签名管理”内查看签名的通道号,签名和模板为对应关系,模板所属签名可在“国内短信>模板管理”查看。

短信发送方式

选择短息的发送方式,支持选择“自定义内容”和“使用模板”

消息内容

仅当“短信发送方式”选择“自定义内容”时需要配置

填写要发送的短信内容,最大长度为2000字节,国内短信必须在短信内容中携带短信签名,如:【短信通知】欢迎您使用短信服务。

模板ID

仅当“短信发送方式”选择“使用模板”时需要配置

填写短信模板ID,用于唯一标识短信模板,请在申请短信模板时获取模板ID。“模板ID”需要与“模板变量值列表”配合使用。

模板变量值列表

仅当“短信发送方式”选择“使用模板”时需要配置

填写短信模板变量值。列表中变量值的个数及长度必须和“模板ID”对应模板内容中定义的变量个数及长度保持一致。

例如“模板ID”对应的模板内容有2个变量且变量长度分别为5和6,则此处需要设置2个变量值且内容长度分别小于等于5和6。 如模板内容为“您有${1}件快递请到${2}领取”时,该参数可填写为'["3","公园正门"]'。

接收方号码

填写短信接收方的号码。

  • 发送国内短信:接收号码为国内手机号码时,所填号码可以不带+86,系统默认添加86,其他号码需符合标准号码格式:+{国家码}{地区码}{终端号码}。示例:+861234***5555,+86123****6666。
  • 发送国际/港澳台短信:不区分接收号码类型,所填号码都必须符合标准号码格式:+{国家码}{地区码}{终端号码}。示例:+2412****00(加蓬号码),+3366****212(法国号码)。 如果携带多个接收方号码,则以英文逗号分隔。每个号码最大长度为21位,最多允许携带500个号码。

回调地址

填写短信发送的回调地址,用于接收短信状态报告,如:http://xx.com/receiveSMSReport。

扩展参数

填写短信发送的扩展参数,在状态报告中会原样返回。 不允许携带以下字符:{,}(即大括号)。

签名名称

填写短信的签名名称,必须是已审核通过的,与模板类型一致的签名名称。

仅在模板ID指定的模板类型为通用模板时生效且必填,用于指定在通用模板短信内容前面补充的签名。 国际/港澳台短信无需关注此参数。