用户工具

呼叫中心:语音文件_ipcc

语音文件

语音文件包含上传和下载。 上传的语音文件是用于呼叫中心的各种语音播放,比如呼入彩铃,转坐席的保持音以及入队等待音。 该语音文件可以通过两种方式上传:
1、通过开发者账户管理页面的ivr语音文件上传页面上传。
2、通过语音文件上传接口上传。

语音文件上传后,需要通过审核才能够正式使用。

下载的语音文件主要是在通话过程中产生的录音文件,或者是用户留言的语音文件。

该节包含以下接口:

上传语音文件参数

上传语音文件需要通过multipart/form-data的形式提交
属性 类型 约束 说明
sid String 必选 主账户id,ucpaas平台生成,固定32位长度,可在开发者控制台查询
appId String 必选 应用唯一标识
token String 必选 主账号授权令牌token,可在开发者控制台查询
time String 必选 时间戳,当前系统时间( 24小时制),格式:yyyyMMddHHmmssSSS
sign String 必选 验证信息,使用MD5加密(主账户id+时间戳+账户授权令牌),共32位(小写)
file multipart/form-data 必选 语音文件,以文件流的形式上传,格式:MP3、wav,不能超过5MB,文件名字不能为中文,仅支持ascii码字符文件名

POST 请求

POST 请求

POST /fileserver/recordFileUpload HTTP/1.1
HOST: www.ucpaas.com
Content-Lenth: 18306
ContentType: multipart/form-data; boundary=aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942
 
Content-Disposition: form-data; name="sid"
12345678901234567890abcdefghijk0
--aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942
 
Content-Disposition: form-data; name="appId"
987654325810qwertyuiop
--aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942
 
Content-Disposition: form-data; name="token"
abcdefghijklmnopkrstuvwxyz123456
--aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942
 
Content-Disposition: form-data; name="file"; filename="C:/Users/2pn7p02/Music/yzxwait.wav"
Content-Type: application/octet-stream ...
--aa685c0a05d8f45e27c9981c34aab8289719cbb656e73ad4cf13b2873942--

下载语音文件参数

属性 类型 约束 说明
sid String 必选 主账户id,ucpaas平台生成,固定32位长度,可在开发者控制台查询
token String 必选 主账号授权令牌token,可在开发者控制台查询
fileid string 必选 通话结束时返回的fileidName字段携带的值
date string 必选 通话结束时返回的date字段携带的值
sig String 必选 md5加密,加密格式为sig= MD5(sid + fileid + token)不区分大小写

GET示例

GET示例

参数为:
sid:12345678901234567890abcdefghijk0
token:abcdefghijklmnopkrstuvwxyz123456
fileid:1452133430935205
date:20160107
转换后:
http://www.ucpaas.com/fileserver/record/12345678901234567890abcdefghijk0_1452133430935205_20160107?sig=b44531e6774ac9c505ddb600a5870ea5

一般响应对象

属性 类型 约束 说明
resp respCode String 必选 参见 响应码说明
respMsg String 必选 响应消息说明
fileId fileId String 可选 生成的语音ID号,云之讯语音文件标识,开发者可忽略

JSON响应示例

JSON响应示例

{
	"resp": {
		"respCode": "000000",
		"respMsg": "成功",
		"fileId": {
			"fileId": "2046"
		}
	}
}

上传语音文件接口

功能 上传所要播放的语音文件
URL http://www.ucpaas.com/maap/ipcc/voice/uploadFile
Method POST
Headers 简单的POST HEAD头域请求, 其中ContentType需要设置为multipart/form-data
Body 上传语音文件参数
Response 一般响应对象

下载语音文件接口

功能 下载留言文件或者录音文件
URL http://www.ucpaas.com/fileserver/record/ {sid}_{fileid}_{date}?sig={sig}
Method GET
Headers 简单的HTTP Get请求头
Parameter 下载语音文件参数
Response 文件的二进制流

页面工具