发送语音通知

最近更新时间:2019-05-17 15:57:17

接口描述

功能描述

给国内用户发语音通知(支持中文、英文字母、数字及组合,内容长度不超过100字)。

URL 示例

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

请求参数

{
    "ext": "",
    "playtimes": 2,
    "promptfile": "语音内容文本",
    "prompttype": 2,
    "sig": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4",
    "tel": {
        "mobile": "13788888888",
        "nationcode": "86"
    },
    "time": 1457336869
}
参数 必选 类型 描述
ext string 用户的 session 内容,腾讯 server 回包中会原样返回。
playtimes number 播放次数,可选,最多3次,默认2次。
promptfile string 通知内容,utf8 编码,支持中文英文、数字及组合,需要和语音内容 模版 相匹配。
若使用数字则默认按照个十百千万进行播报,可通过在数字前添加英文逗号(,)改变播报方式,例如“5,6,7,8”。
prompttype number 语音类型,目前固定为2。
sig string App 凭证,具体计算方式见下注。
tel object 电话号码。
time number 请求发起时间,UNIX 时间戳,如果和系统时间相差超过10分钟则会返回失败。
  • 参数tel
参数 必选 类型 描述
mobile string 手机号码
nationcode string 国家码


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

string strMobile = "13788888888"; //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)
           = ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4;

响应参数

{
    "result": 0,
    "errmsg": "OK",
    "callid": "xxxx",
    "ext": ""
}
参数 必选 类型 描述
result number 错误码,0表示成功(计费依据),非0表示失败
errmsg string 错误消息,result 非0时的具体错误信息
callid string 标识本次发送 ID,标识一次下发记录
ext string 用户的 session 内容,腾讯 server 回包中会原样返回

DEMO

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