文本外呼
提交方式:
接口数据输入输出均采用JSON格式封装的字符串,编码(对整个请求的字符串编码)统一为UTF-8,采用post方式提交请求
功能:
直接播放文本内内容。
请求参数:
参数值说明:以下json内容为提交请求数据格式
{
"account":"dh****",
"password":"0243614f784a8cfa94a94b85cbee7540",
"data":[{
"msgid":"49a5f1d78ab84b90a963beac04867b74",
"callee":"157****6132",
"text":"这是一条TTS的测试消息",
"calltype":0,
"playmode":0,
"params":{"param1":"value1","param2":"value2"}
}]
}
参数名称 | 约束 | 说明 |
---|---|---|
account | 必须(String) | 用户账号 |
password | 必须(String) | 用户密码,需采用MD5加密(32位小写) |
needallresp | 非必须(String) | 当值为字符串true时,响应中包含所有提交的msgid |
下列为一次请求中携带的具体消息参数(可多条): | ||
msgid | 必须(String) | 消息编号ID,必须唯一,不可为空,最大长度64位 |
callee | 必须(String) | 被叫号码。可以有多个号码(英文逗号隔开,100个以内) |
text | 必须(String) | 待呼叫的文本内容(1000字以内) |
playmode | 必须(int) | 放音模式: 0-只播放文本 |
calltype | 必须(int) | 外呼类型:0-文本呼叫 |
playtimes | 可选 (int) | 播放次数:1~2次 |
speakper | 可选 (int) | 发声人类型(播放文本内容使用)汉小宇=B1, 汉小美=B0, 汉逍遥=B3, 汉丫丫=B4,不传使用默认发音人 |
params | 可选(Map对象) | 终端客户自定义参数params(总长度限制为1000) |
返回示例:
{
"result":"DH:1004",
"desc":"存在无效号码/限制运营商号码",
"data":[{
"status":"DH:1004",
"desc":"存在无效号码/限制运营商号码",
"msgid":"49a5f1d78ab84b90a963beac04867b74",
"callee":"157****6132"
}]
}
示例解释:外呼请求的响应一般只会返回result,只有存在错误数据时才会返回data,status是错误码(提交响应码),desc是错误描述。
返回参数说明:
参数名 | 说明 |
---|---|
result | 总的提交结果状态码;说明请参照:提交响应码 |
desc | 状态码 |
下列为响应中可能携带的具体消息的参数(可多条) | |
status | 状态码;说明请参照:提交响应码 |
desc | 描述 |
msgid | 消息编号 |
callee | 被叫号码 |
文档更新时间: 2024-08-28 09:08 作者:admin