指定模板群发短信

最近更新时间:2019-12-17 10:12:46

接口描述

功能描述

给用户群发通知类或营销类短信。
手机号码需全部为国内手机号码或全部为国际/港澳台手机号码,单次请求最多支持提交200个手机号,也支持单发短信。

URL 示例

POST https://yun.tim.qq.com/v5/tlssmssvr/sendmultisms2?sdkappid=xxxxx&random=xxxx    

其中,sdkappid请填写您在 短信控制台 添加应用后生成的实际 SDK AppID,random请填写成随机数。

请求参数

请求参数如下表所示。

参数 必选 类型 描述
ext string 用户的 session 内容,腾讯 server 回包中会原样返回,可选字段,不需要就填空
extend string 短信码号扩展号,格式为纯数字串,其他格式无效。默认没有开通,开通请联系 sms helper
params array 模板参数,该字段需结合tpl_id字段使用。若模板没有自定义变量参数,请设置为空数组
sig string App 凭证,具体计算方式请参见下方 说明
sign string 短信签名内容,使用 UTF-8 编码,必须填写审核通过的签名
签名信息可登录 短信控制台 查看
tel array 群发号码数组,群发时一次最多不要超过200个手机号
time number 请求发起时间,UNIX 时间戳(单位:秒),如果和系统时间相差超过10分钟则会返回失败
tpl_id number 模板 ID,必须填写审核通过的模板 ID
模板信息可登录 短信控制台 查看

数组tel元素参数:

参数 必选 类型 描述
mobile string 手机号码
nationcode string 国家(或地区)码

说明:

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;

请求示例:

{
    "ext": "",
    "extend": "",
    "params": [
        "验证码",
        "1234",
        "4"
    ],
    "sig": "be66bb4aeb54701ed0637d0996a0b75111d5b8eda9b3a71bdc579a3d26f3edfb",
    "sign": "腾讯云",
    "tel": [
        {
            "mobile": "13788888888",
            "nationcode": "86"
        },
        {
            "mobile": "13788888889",
            "nationcode": "86"
        }
    ],
    "time": 1457336869,
    "tpl_id": 19
}

响应参数

响应参数如下表所示。

参数 必选 类型 描述
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,标识一次短信下发记录

响应示例:

{
    "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"
        }
    ]
}

DEMO

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