指定模板群发短信-短信-文档中心-腾讯云

接口描述

功能描述

给用户群发通知类或营销类短信。
手机号码需全部为国内手机号码或全部为国际/港澳台手机号码，单次请求最多支持提交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 SDK、PHP SDK、Python SDK、Node.js SDK 和 C# SDK 供您参考，欢迎查阅。