文档中心 API 中心 短信 短信API 指定模板群发短信

指定模板群发短信

最近更新时间:2019-05-05 09:54:28

接口描述

功能描述

给用户群发通知类或营销类短信。
手机号码需全部为国内或者海外手机号码(单次提交不超过200个手机号),也支持单发短信。

URL 示例

POST https://yun.tim.qq.com/v5/tlssmssvr/sendmultisms2?sdkappid=xxxxx&random=xxxx
:sdkappid 请填写您在腾讯云上申请到的,random 请填成随机数。

请求参数

{
    "ext": "",
    "extend": "",
    "params": [
        "验证码",
        "1234",
        "4"
    ],
    "sig": "be66bb4aeb54701ed0637d0996a0b75111d5b8eda9b3a71bdc579a3d26f3edfb",
    "sign": "腾讯云",
    "tel": [
        {
            "mobile": "13788888888",
            "nationcode": "86"
        },
        {
            "mobile": "13788888889",
            "nationcode": "86"
        }
    ],
    "time": 1457336869,
    "tpl_id": 19
}
参数 必选 类型 描述
ext string 用户的 session 内容,腾讯 server 回包中会原样返回,可选字段,不需要就填空
extend string 短信码号扩展号,格式为纯数字串,其他格式无效。默认没有开通,开通请联系 腾讯云短信技术支持
params array 模板参数,若模板没有参数,请提供为空数组
sig string App 凭证,具体计算方式见下注
sign string 短信签名,此处应填写审核通过的签名内容,非签名ID,如果使用默认签名,该字段可缺省
tel array 群发号码数组,群发时一次最多不要超过200个手机号
time number 请求发起时间,UNIX 时间戳(单位:秒),如果和系统时间相差超过10分钟则会返回失败
tpl_id number 模板 ID,在 控制台 审核通过的模板 ID
  • 数组tel元素参数:
参数 必选 类型 描述
mobile string 手机号码
nationcode string 国家码

  1. tpl_id 字段需填写审核通过的模板 ID
    例如,模版 ID 对应的模板内容为:“您的{1}是{2},请于{3}分钟内填写。如非本人操作,请忽略本短信。”,则上面请求参数组合后下发的内容为:“【腾讯云】您的验证码是1234,请于4分钟内填写。如非本人操作,请忽略本短信。”
    如果您有多个短信签名,请将需要的短信签名填入sign字段,例如您有“腾讯科技”和“腾讯云”两个签名,但想以“腾讯云”签名发送短信,则sign字段可赋值为:“腾讯云”
  2. 第一个申请的国内短信签名会作为默认签名,如果有已经申请通过的签名,当实际发送的签名没有申请或者申请未审批时会被替换为副签,若需要返回签名错误(1012)请联系 sms helper
    例如,申请通过的签名为:“腾讯科技”,未通过签名为:“腾讯云”,模板内容为:“您的验证码是1234。”
    • 以“腾讯科技”作为签名发送,实际送达为:“【腾讯科技】您的验证码是1234。”
    • 以“腾讯云”作为签名发送,实际送达为:“【腾讯科技】[腾讯云]您的验证码是1234。”
  3. "sig" 字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成,其伪代码如下:
    string strMobile = "13788888888,13788888889"; //tel 的 mobile 字段的参数值以 "," 分割
    string strAppKey = "5f03a35d00ee52a21327ab048186a2c4"; //sdkappid 对应的 appkey,需要业务方高度保密
    string strRand = "7226249334"; //URL 中的 random 字段的值
    string strTime = "1457336869"; //UNIX 时间戳
    string sig = sha256(appkey=5f03a35d00ee52a21327ab048186a2c4&random=7226249334&time=1457336869&mobile=13788888888,13788888889)
            = be66bb4aeb54701ed0637d0996a0b75111d5b8eda9b3a71bdc579a3d26f3edfb;

    响应参数

{
    "result": 0,
    "errmsg": "OK",
    "ext": "",
    "detail": [
        {
            "errmsg": "OK",
            "fee": 1,
            "mobile": "13788888888",
            "nationcode": "86",
            "result": 0,
            "sid": "xxxxxxx"
        },
        {
            "errmsg": "OK",
            "fee": 1,
            "mobile": "13788888889",
            "nationcode": "86",
            "result": 0,
            "sid": "xxxxxxx"
        }
    ]
}
参数 必选 类型 描述
result number 错误码,0表示成功(计费依据),非0表示失败
errmsg string 错误消息,result 非0时的具体错误信息
ext string 用户的 session 内容,腾讯 server 回包中会原样返回
detail array 结果详细
  • 数组detail元素参数:
参数 必选 类型 描述
result number 错误码,0表示成功(计费依据),非0表示失败,参考 错误码
errmsg string 错误消息,result 非0时的具体错误信息
fee number 短信计费的条数,计费规则请参考 国内短信内容长度计算规则国际短信内容长度计算规则
mobile string 手机号码
nationcode string 国家码
sid string 本次发送标识 ID,标识一次短信下发记录

DEMO

腾讯云短信服务为您提供了 Java SDKPHP SDKPython SDKNode.js SDKC# SDK 供您参考,欢迎查阅。