语音文件外呼

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

提交方式:

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

功能:

外呼语音内容播放medianame下的全部语音文件,实现语音功能播放用户自己的语音文件,可支持多个文件名,用;分隔,按顺序播放。语音文件通过接口上传并审核通过或手动上传至大汉平台(3tong.net)后才可使用。
文件格式要求:wav格式的文件,位速 128kbps,音频采样大小16位,频道 1(单声道),音频采样级别 8 kHz,音频格式 PCM,这样能保证放音的清晰度。

请求参数:

参数值说明:以下json内容为提交请求数据格式

{
    "account":"dh8528",
    "password":"3fd3c885feb7457dab56c9a9678a123",
    "data":[{
        "msgid":"49a5f1d78ab84b90a963beac04867b73",
        "callee":"157****6131",
        "medianame":"a81dfae08b4b478cbc266d77aefbbb01;a81dfae08b4b478cbc266d77aefbbb02",
        "calltype":2,
        "playmode":1
        },{
        "msgid":"49a5f1d78ab84b90a963beac04867b74",
        "callee":"157****6132",
        "medianame":"a81dfae08b4b478cbc266d77aefbbb03",
        "calltype":2,
        "playmode":1
        }]
    }

示例解释:
上述请求一共提交了两条外呼语音文件的消息内容。1576131手机用户将听到a81dfae08b4b478cbc266d77aefbbb01和a81dfae08b4b478cbc266d77aefbbb02两个语音文件的声音,而1576132用户将只听到a81dfae08b4b478cbc266d77aefbbb03这一个语音文件的声音。

参数名称 约束 说明
account 必须(String) 用户账号
password 必须(String) 用户密码,需采用MD5加密(32位小写)
needallresp 非必须(String) 当值为字符串true时,响应中包含所有提交的msgid
下列为一次请求中携带的具体消息参数(可多条):
msgid 必须(String) 消息编号ID,必须唯一,不可为空,最大长度64位
callee 必须(String) 被叫号码。可以有多个号码(英文逗号隔开)
medianame 必须(String) 待播放的语音文件名,上传后在页面上可以看到,多个文件时用英文分号隔开(不带扩展名)
playmode 必须(int) 放音模式:1-只播放语音文件
calltype 必须(int) 外呼类型:2-语音文件呼叫

返回示例:

{
    "result":"DH:1004",
    "desc":"存在无效号码/限制运营商号码",
    "data":[{
        "status":"DH:1004",
        "desc":"存在无效号码/限制运营商号码",
        "msgid":"49a5f1d78ab84b90a963beac04867b74",
        "callee":"157****6132"
        }]
}
示例解释:外呼请求的响应一般只会返回result,只有存在错误数据时才会返回data,status是错误码(提交响应码),desc是错误描述。

返回参数说明:

参数名 说明
result 总的提交结果状态码
desc 提交结果描述下列为响应中可能携带的具体消息的参数(可多条)
status 状态码
desc 描述
msgid 消息编号
callee 被叫号码
文档更新时间: 2020-06-18 09:30   作者:admin