混合呼叫

访问地址:http://voice.3tong.net/json/voiceSms/SubmitVoc

提交方式:

接口数据输入输出均采用JSON格式封装的字符串,编码(对整个请求的字符串编码)统一为UTF-8,采用post方式提交请求

功能:

语音文件外呼和文本外呼的混合使用

请求参数:

参数值说明:以下json内容为提交请求数据格式
{
    "account":"dh****",
    "password":"0243614f784a8cfa94a94b85cbee7540",
    "data":[{
        "msgid":"49a5f1d78ab84b90a963beac04867b74",
        "callee":"157****6132",
        "medianame":"a81dfae08b4b478cbc266d77aefbbb03",
        "text":"这是一条TTS的测试消息",
        "calltype":3,
        "playmode":2,
        "params":{"param1":"value1","param2":"value2"}
        }]
    }
参数名称 约束 说明
account 必须(String) 用户账号
password 必须(String) 用户密码,需采用MD5加密(32位小写)
needallresp 非必须(String) 当值为字符串true时,响应中包含所有提交的msgid
下列为一次请求中携带的具体消息参数(可多条):
msgid 必须(String) 消息编号ID,必须唯一,不可为空,最大长度64位
callee 必须(String) 被叫号码。可以有多个号码(英文逗号隔开)
medianame 必须(String) 待播放的语音文件名称,多个文件时用英文分号隔开(不带扩展名)。
text 必须(String) 待呼叫的文本内容
playmode 必须(int) 放音模式:2—先播放文本再文件,3—先播放文件再文本
calltype 必须(int) 外呼类型:3-文本、文件混合呼叫
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