开发指南 > 

短信API > 

单发短信

联系我们

单发短信
更新时间:2017-03-22  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlssmssvr/sendsms?sdkappid=xxxxx&random=xxxx
接口说明给用户发短信验证码、短信通知,营销短信(内容长度不超过450字)。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体

Json格式时,参数如下:

复制
复制成功
{
"tel": { //如需使用国际电话号码通用格式,如:"+8613788888888" ,请使用sendisms接口见下注
"nationcode": "86", //国家码
"mobile": "13788888888" //手机号码
},
"type": 0, //0:普通短信;1:营销短信(强调:要按需填值,不然会影响到业务的正常使用)
"msg": "你的验证码是1234", //utf8编码 
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败
"extend": "", //通道扩展码,可选字段,默认没有开通(需要填空)。
//在短信回复场景中,腾讯server会原样返回,开发者可依此区分是哪种类型的回复
"ext": "" //用户的session内容,腾讯server回包中会原样返回,可选字段,不需要就填空。
}

注:
1、"msg"字段需要匹配审核通过的模板内容
如果您的模板是"你的验证码是{1}",则"msg"字段可赋值为:"你的验证码是xxxx"。(其中"xxxx"为下发的验证码)
如果您有多个短信签名,请将需要的短信签名放在短信内容前面
例如您有"【腾讯科技】","【腾讯云】"两个签名,但是想以"【腾讯云】"签名发送短信,
则"msg"字段可赋值为:"【腾讯云】你的验证码是xxxx"。(其中"xxxx"为下发的验证码)
2、"extend"字段的配置请联系腾讯云短信技术支持
3、sendisms接口,"tel"字段为国际电话号码通用格式,如:"+8613788888888"
4、"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成
伪代码如下:

复制
复制成功
string strMobile = "13788888888"; //tel的mobile字段的内容
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile);
3、应答包体

第三方业务收到回调请求下,需要按以下的格式给腾讯云短信业务应答

复制
复制成功
{
"result": 0, //0表示成功(计费依据),非0表示失败
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容,腾讯server回包中会原样返回
"sid": "xxxxxxx", //标识本次发送id,标识一次短信下发记录
"fee": 1 //短信计费的条数
}

注:
"fee"字段计费说明
result对应的错误码

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

指定模板单发短信
更新时间:2017-03-22  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlssmssvr/sendsms?sdkappid=xxxxx&random=xxxx
接口说明给用户发短信验证码、短信通知,营销短信(内容长度不超过450字)。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体

包体为json字符串,参数如下:

复制
复制成功
{
"tel": { //如需使用国际电话号码通用格式,如:"+8613788888888" ,请使用sendisms接口见下注
"nationcode": "86", //国家码
"mobile": "13788888888" //手机号码
},
"sign": "腾讯云", //短信签名,如果使用默认签名,该字段可缺省
"tpl_id": 19, //业务在控制台审核通过的模板ID
//假定这个模板为:您的{1}是{2},请于{3}分钟内填写。如非本人操作,请忽略本短信。
"params": [
"验证码",
"1234",
"4"
], //参数,分别对应上面假定模板的{1},{2},{3}
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败
"extend": "", //通道扩展码,可选字段,默认没有开通(需要填空)。
//在短信回复场景中,腾讯server会原样返回,开发者可依此区分是哪种类型的回复
"ext": "" //用户的session内容,腾讯server回包中会原样返回,可选字段,不需要就填空。
}

注:
1、"tpl_id"字段需填写审核通过的模板ID ,上面的请求参数组合后下发的内容为:
"【腾讯云】您的验证码是1234,请于4分钟内填写。如非本人操作,请忽略本短信。"
如果您有多个短信签名,请将需要的短信签名填入"sign"字段
例如您有"【腾讯科技】","【腾讯云】"两个签名,但是想以"【腾讯云】"签名发送短信,则"sign"字段可赋值为:"腾讯云"
2、"extend"字段的配置请联系腾讯云短信技术支持
3、sendisms接口,"tel"字段为国际电话号码通用格式,如:"+8613788888888"
4、"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成
伪代码如下:

复制
复制成功
string strMobile = "13788888888"; //tel的mobile字段的内容
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile);
3、应答包体
复制
复制成功
{
"result": 0, //0表示成功(计费依据),非0表示失败
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容,腾讯server回包中会原样返回
"sid": "xxxxxxx", //标识本次发送id,标识一次短信下发记录
"fee": 1 //短信计费的条数
}

注:
"fee"字段计费说明
result对应的错误码

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

群发短信
更新时间:2017-03-15  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlssmssvr/sendsms?sdkappid=xxxxx&random=xxxx
接口说明 给用户群发通知类或营销类短信。
该接口仅支持给国内手机群发短信(单次提交不超过200个手机号,内容长度不超过450字),也支持给国内手机单发短信。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体

包体为json字符串,参数如下:

复制
复制成功
{
"tel": [
{
    "nationcode": "86", //国家码
    "mobile": "13788888888" //手机号码
},
{
    "nationcode": "86", //国家码
    "mobile": "13788888889" //手机号码
}
],
"type": 0, //0:普通短信;1:营销短信(强调:要按需填值,不然会影响到业务的正常使用)
"msg": "你的验证码是1234", //utf8编码 
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败
"extend": "", //通道扩展码,可选字段,默认没有开通(需要填空)。
//在短信回复场景中,腾讯server会原样返回,开发者可依此区分是哪种类型的回复
"ext": "" //用户的session内容,腾讯server回包中会原样返回,可选字段,不需要就填空。
}

注:
1、群发时一次最多不要超过200个手机号
2、"msg"字段需要匹配审核通过的模板内容
如果您的模板是"你的验证码是{1}",则"msg"字段可赋值为:"你的验证码是xxxx"。(其中"xxxx"为下发的验证码)
如果您有多个短信签名,请将需要的短信签名放在短信内容前面
例如您有"【腾讯科技】","【腾讯云】"两个签名,但是想以"【腾讯云】"签名发送短信,
则"msg"字段可赋值为:"【腾讯云】你的验证码是xxxx"。(其中"xxxx"为下发的验证码)
3、"extend"字段的配置请联系腾讯云短信技术支持
4、"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成
伪代码如下:

复制
复制成功
string strMobile = "13788888888,13788888889"; //tel的mobile字段的参数值以","分割
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile);
3、应答包体
复制
复制成功
{
"result": 0, //0表示成功,非0表示失败,失败后没有detail列表信息
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容,腾讯server回包中会原样返回
"detail": [
{
    "result": 0, //0表示成功(计费依据),非0表示失败
    "errmsg": "OK", //result非0时的具体错误信息
    "mobile": "13788888888", //手机号码
    "nationcode": "86", //国家码
    "sid": "xxxxxxx", //标识本次发送id,标识一次短信下发记录
    "fee": 1 //短信计费的条数
},
{
    "result": 0, //0表示成功(计费依据),非0表示失败
    "errmsg": "OK", //result非0时的具体错误信息
    "mobile": "13788888889", //手机号码
    "nationcode": "86", //国家码
    "sid": "xxxxxxx", //标识本次发送id,标识一次短信下发记录
    "fee": 1 //短信计费的条数
}
]
}

注:
"fee"字段计费说明
result对应的错误码

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

指定模板群发短信
更新时间:2017-03-15  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlssmssvr/sendsms?sdkappid=xxxxx&random=xxxx
接口说明 给用户群发通知类或营销类短信。
该接口仅支持给国内手机群发短信(单次提交不超过200个手机号,内容长度不超过450字),也支持给国内手机单发短信。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体

Json格式时,参数如下:

复制
复制成功
{
"tel": [
{
    "nationcode": "86", //国家码
    "mobile": "13788888888" //手机号码
},
{
    "nationcode": "86", //国家码
    "mobile": "13788888889" //手机号码
}
],
"sign": "腾讯云", //短信签名,如果使用默认签名,该字段可缺省
"tpl_id": 19, //业务在控制台审核通过的模板ID
//假定这个模板为:您的{1}是{2},请于{3}分钟内填写。如非本人操作,请忽略本短信。
"params": [
"验证码",
"1234",
"4"
], //参数,分别对应上面假定模板的{1},{2},{3}
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败
"extend": "", //通道扩展码,可选字段,默认没有开通(需要填空)。
//在短信回复场景中,腾讯server会原样返回,开发者可依此区分是哪种类型的回复
"ext": "" //用户的session内容,腾讯server回包中会原样返回,可选字段,不需要就填空。
}

注:
1、群发时一次最多不要超过200个手机号
2、"tpl_id"字段需填写审核通过的模板ID ,上面的请求参数组合后下发的内容为:
"【腾讯云】您的验证码是1234,请于4分钟内填写。如非本人操作,请忽略本短信。"
如果您有多个短信签名,请将需要的短信签名填入"sign"字段
例如您有"【腾讯科技】","【腾讯云】"两个签名,但是想以"【腾讯云】"签名发送短信,则"sign"字段可赋值为:"腾讯云"
3、"extend"字段的配置请联系腾讯云短信技术支持
4、"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成
伪代码如下:

复制
复制成功
string strMobile = "13788888888,13788888889"; //tel的mobile字段的参数值以","分割
string strAppKey = "7226249334"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile);
3、应答包体
复制
复制成功
{
"result": 0, //0表示成功,非0表示失败,失败后没有detail列表信息
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容,腾讯server回包中会原样返回
"detail": [
{
    "result": 0, //0表示成功(计费依据),非0表示失败
    "errmsg": "OK", //result非0时的具体错误信息
    "mobile": "13788888888", //手机号码
    "nationcode": "86", //国家码
    "sid": "xxxxxxx", //标识本次发送id,标识一次短信下发记录
    "fee": 1 //短信计费的条数
},
{
    "result": 0, //0表示成功(计费依据),非0表示失败
    "errmsg": "OK", //result非0时的具体错误信息
    "mobile": "13788888889", //手机号码
    "nationcode": "86", //国家码
    "sid": "xxxxxxx", //标识本次发送id,标识一次短信下发记录
    "fee": 1 //短信计费的条数
}
]
}

注:
"fee"字段计费说明
result对应的错误码

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

短信下发状态通知
更新时间:2017-03-09  访问次数:80706

1、协议说明
协议HTTP JSON
编码格式UTF8
URL举例:https://yun.tim.qq.com/sms/smscallback
接口说明短信下发给用户后,腾讯云短信服务可以通过回调业务url的方式,通知业务方短信下发的状态。
2、请求包体

Json格式时,参数如下:

复制
复制成功
[
{
"user_receive_time": "2015-10-17 08:03:04", //用户实际接收到短信的时间
"nationcode": "86", //国家码
"mobile": "13xxxxxxxxx", //手机号码
"report_status": "SUCCESS", //实际是否收到短信接收状态。SUCCESS(成功)、FAIL(失败)
"errmsg": "DELIVRD", //用户接收短信状态码
"description": "用户短信送达成功", //用户接收短信状态描述
"sid": "xxxxxxx" //标识本次发送id
},
{ }…
]

注:
1、一次回调请求里可能有多次的短信请求结果
2、"errmsg"详见状态回执错误码说明

3、应答包体

第三方业务收到回调请求下,需要按以下的格式给腾讯云短信业务应答

复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK" //result非0时的具体错误信息
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

短信回复
更新时间:2017-03-09  访问次数:80706

1、协议说明
协议HTTP POST/GET/JSON
编码格式UTF8
URL举例:https://yun.tim.qq.com/sms/smscallback
接口说明用户收到短信后,回复短信,腾讯云短信服务可以通过回调业务url的方式,通知业务方用户回复了短信。
2、请求包体

Json格式时,参数如下:

复制
复制成功
{
"nationcode": "86", //国家码
"mobile": "13xxxxxxxxx", //手机号码
"text": "用户回复的内容",
"sign": "短信签名",
"time": 1457336869, //unix时间戳
"extend": "扩展码" //可选字段,通道扩展码,在发送短信的接口中,如果填写了"extend"字段,
    //在短信回复时,腾讯server会原样返回,开发者可依此区分是哪种类型的回复
}
3、应答包体

第三方业务收到回调请求下,需要按以下的格式给腾讯云短信业务应答

复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK" //result非0时的具体错误信息
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

拉取短信状态
更新时间:2017-03-15  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlssmssvr/pullstatus?sdkappid=xxxxx&random=xxxx
接口说明拉取短信状态(下发状态,短信回复等)。
拉取过的内容不会再重复返回,可以理解为消息队列机制。
此功能需要联系sms helper开通。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体
复制
复制成功
{
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会拉取失败
"type": 1, //0 1分别代表 短信下发状态,短信回复
"max": 10 //最大条数 最多100
}

注:
"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time)生成
伪代码如下:

复制
复制成功
string strAppkey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppkey&random=$strRand&time=$strTime);
3、应答包体
复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "ok", //result非0时的具体错误信息
"count": 3, //result为0时有效,返回的信息条数
"data": [... //具体内容见下注
]
}

注:
请求type 0时 data字段内容同短信下发状态通知
请求type 1时 data字段内容同短信回复

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

拉取单个手机短信状态
更新时间:2017-03-15  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlssmssvr/pullstatus4mobile?sdkappid=xxxxx&random=xxxx
接口说明拉取单个手机的短信状态(下发状态,短信回复等)。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体
复制
复制成功
{
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会拉取失败
"type": 1, //0 1分别代表 短信下发状态,短信回复
"max": 10, //最大条数 最多100
"begin_time": 1464624000, //unix时间戳,需要拉取的起始时间
"end_time": 1464706800, //unix时间戳,需要拉取的截止时间
"nationcode": "86", //国家码
"mobile": "13788888888" //手机号码
}

注:
"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time)生成
伪代码如下:

复制
复制成功
string strAppkey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppkey&random=$strRand&time=$strTime);
3、应答包体
复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "ok", //result非0时的具体错误信息
"count": 3, //result为0时有效,返回的信息条数
"data": [... //具体内容见下注
]
}

注:
请求type 0时 data字段内容同短信下发状态通知
请求type 1时 data字段内容同短信回复

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

发送语音验证码
更新时间:2017-03-15  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlsvoicesvr/sendvoice?sdkappid=xxxxx&random=xxxx
接口说明给国内用户发语音验证码(支持英文字母、数字及组合)。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体

包体为json字符串,参数如下:

复制
复制成功
{
"tel": {
"nationcode": "86", //国家码
"mobile": "13788888888" //手机号码
},
"msg": "1234", //验证码,支持英文字母、数字及组合;实际发送给用户时,语音验证码内容前会添加"您的验证码是"语音提示。
"playtimes": 2, //播放次数,可选,最多3次,默认2次
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败
"ext": "" //用户的session内容,腾讯server回包中会原样返回,可选字段,不需要就填空。
}

注:
1、"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成
伪代码如下:

复制
复制成功
string strMobile = "13788888888"; //tel的mobile字段的内容
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile);
3、应答包体
复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容,腾讯server回包中会原样返回
"callid": "xxxx" //标识本次发送id,标识一次下发记录
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

发送语音通知
更新时间:2017-07-12  访问次数:80706

1、协议说明
协议HTTP POST
编码格式UTF8
URL举例:https://yun.tim.qq.com/v5/tlsvoicesvr/sendvoiceprompt?sdkappid=xxxxx&random=xxxx
接口说明 给国内用户发语音通知(支持中文、英文字母、数字及组合,内容长度不超过100字)。
注:sdkappid请填写您在腾讯云上申请到的,random请填成随机数。
2、请求包体

包体为json字符串,参数如下:

复制
复制成功
{
"tel": {
"nationcode": "86", //国家码
"mobile": "13788888888" //手机号码
},
"prompttype": 2, //语音类型,目前固定为2
"promptfile": "语音内容文本", //通知内容,utf8编码,支持中文英文、数字及组合,需要和语音内容模版相匹配
"playtimes": 2, //播放次数,可选,最多3次,默认2次
"sig": "30db206bfd3fea7ef0db929998642c8ea54cc7042a779c5a0d9897358f6e9505", //app凭证,具体计算方式见下注
"time": 1457336869, //unix时间戳,请求发起时间,如果和系统时间相差超过10分钟则会返回失败
"ext": "" //用户的session内容,腾讯server回包中会原样返回,可选字段,不需要就填空。
}

注:
1、"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&mobile=$mobile)生成
伪代码如下:

复制
复制成功
string strMobile = "13788888888"; //tel的mobile字段的内容
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey,需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&mobile=$strMobile);
3、应答包体
复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK", //result非0时的具体错误信息
"ext": "", //用户的session内容,腾讯server回包中会原样返回
"callid": "xxxx" //标识本次发送id,标识一次下发记录
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

语音验证码状态通知
更新时间:2017-03-9  访问次数:80706

1、协议说明
协议HTTP JSON
编码格式UTF8
URL举例:https://yun.tim.qq.com/voice/voicecallback
接口说明语音验证码下发给用户后,腾讯云短信服务可以通过回调业务url的方式,通知业务方语音验证码下发的状态。
2、请求包体

Json格式时,参数如下:

复制
复制成功
{
"voicecode_callback": {
"result": "0", //0:用户正常接听 1:用户未接听 2:呼叫异常
"callid": "xxxxxx", //标识本次发送id
"mobile": "13xxxxxxxxx", //手机号码
"nationcode": "86", //国家码
"call_from": "075583763333", //呼入号码
"start_calltime": "1470196821", //开始发起语音验证呼叫时间
"end_calltime": "1470196843", //结束语音验证呼叫时间
"accept_time": "1470196835", //用户接听时间
"fee": "1" //计费时长,分钟
}
}
3、应答包体

第三方业务收到回调请求下,需要按以下的格式给腾讯云短信业务应答

复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK" //result非0时的具体错误信息
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

语音通知状态通知
更新时间:2017-03-9  访问次数:80706

1、协议说明
协议HTTP JSON
编码格式UTF8
URL举例:https://yun.tim.qq.com/voice/voicecallback
接口说明语音通知下发给用户后,腾讯云短信服务可以通过回调业务url的方式,通知业务方语音通知下发的状态。
2、请求包体

Json格式时,参数如下:

复制
复制成功
{
"voiceprompt_callback": {
"result": "0",  //0:用户正常接听 1:用户未接听 2:呼叫异常
"callid": "xxxxxx", //标识本次发送id
"mobile": "13xxxxxxxxx", //手机号码
"nationcode": "86", //国家码
"call_from": "", //呼入号码
"start_calltime": "1470197196", //开始发起语音通知呼叫时间
"end_calltime": "1470197221", //结束语音通知呼叫时间
"accept_time": "1470197211", //用户接听时间
"fee": "1"//计费时长,分钟
}
}
3、应答包体

第三方业务收到回调请求下,需要按以下的格式给腾讯云短信业务应答

复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK" //result非0时的具体错误信息
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

语音通知按键通知
更新时间:2017-03-9  访问次数:80706

1、协议说明
协议HTTP JSON
编码格式UTF8
URL举例:https://yun.tim.qq.com/voice/voicecallback
接口说明语音通知下发给用户后,腾讯云短信服务可以通过回调业务url的方式,通知业务方用户按下的键
2、请求包体

Json格式时,参数如下:

复制
复制成功
{
"voicekey_callback": {
"callid": "xxxxxx", //标识本次发送id
"mobile": "13xxxxxxxxx", //手机号码
"nationcode": "86", //国家码
"call_from": "", //呼入号码
"keypress": "2" //用户按下的键
}
}
3、应答包体

第三方业务收到回调请求下,需要按以下的格式给腾讯云短信业务应答

复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK" //result非0时的具体错误信息
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

语音送达失败原因推送
更新时间:2017-03-9  访问次数:80706

1、协议说明
协议HTTP JSON
编码格式UTF8
URL举例:https://yun.tim.qq.com/voice/voicecallback
接口说明 对语音验证码、语音通知下发失败的号码推送下发失败的原因。
2、请求包体

Json格式时,参数如下:

复制
复制成功
{
"voice_failure_callback": {
"callid": "xxxxxx", //标识本次发送id 
"mobile": "13xxxxxxxxx", //手机号码  
"nationcode": "86", //国家码
"call_from": "075583763333", //呼入号码
"failure_code": 8, //失败错误码
"failure_reason": "空号" //失败原因
}
}
3、应答包体

第三方业务收到回调请求下,需要按以下的格式给腾讯云短信业务应答

复制
复制成功
{
"result": 0, //0表示成功,非0表示失败
"errmsg": "OK" //result非0时的具体错误信息
}

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

计费相关

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

审核规范

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

业务开发

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

问题定位

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!

联系我们

以上信息是否解决您的问题?

很抱歉未能解决您的问题,我们会继续努力做到更好! 非常感谢您的反馈,我们会继续努力做到更好!