语音通知对接流程图

开发者账号

注册或者登录开发者账号流程说明请参考登录注册>>

创建应用及申请上线

创建应用及申请上线流程说明请参考创建应用及申请上线>>

资质认证（可选）

资质认证流程说明可参考账号认证>>

上传语音通知（可选）

1.上传语音通知文件—上传音频文件

点击“应用管理”→“语音库管理” →“语音通知”中的“添加语音”。
如下所示：

注：

语音通知铃声，每个应用下可上传多个语音。
语音的格式必须是wav或mp3(不支持直接改后缀名)，文件大小不能超过1M。

接口对接

1.语音通知对接—API

URL格式

https://api.ucpaas.com/{SoftVersion}/

URL参数属性说明

属性
SoftVersion		云之讯REST API版本号，当前版本号为：2014-06-30
Account		此参数为默认固定值
accountSid		注册云之讯官网，在控制台中即可获取此参数
function		业务功能
operation		业务操作，业务功能的各类具体操作分支
SigParameter		请求URL必须带有此参数

HTTP标准包头字段(必填)

属性		说明
Accept		客户端响应接收数据格式：application/xml、application/json
Content-Type		类型：application/xml;charset=utf-8、application/json;charset=utf-8
Authorization		验证信息
Content-Length		包体长度

2.短信对接—API

接口文档连接请参见附录
toSerNum：
企业认证用户才支持显号功能。未开启显号功能则呼叫会随机显号，设置此参数无效。
type：
0-文本(接口调用成功后，文本内容需人工审核，审核通过后合成语音进行外呼，及时性比较低）
1-语音id (先在管理中心上传语音文件，语音文件需进行人工审核，审核通过后用户可以直接调用接口传入语音ID进行外呼，无须再次审核，及时性比较高，适用于内容相同情况)

JSON 请求示例

POST/2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Calls/voiceNotify? sig=4D3C2549D3A487841CB3D84EA7421FCD 
Host:api.ucpaas.com 
Accept:application/json 
Content-Type:application/json;charset=utf-8   
Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxODQ3MzQ=
 {
 "voiceNotify" : { 
	"appId" : "e462aba25bc6498fa5ada7eefe1401b7", 
	"to" : "18612345678", 
	"type" : "0",
	 “content” : “您好，您有一个通知！", 
	"toSerNum" : "075512345678", 
	"playTimes" : "3“
	 }
 }

JSON 响应示例

{"resp":{
"respCode":"000000",
"voiceNotify" : { 
"callId" : "31d7ca243c406a81611910db21b68876", 
"createDate" : 20140623184729 } 
}
}
}

XML请求示例

POST/2014-06-30/Accounts/e03bc9106c6ed0eaebfce8c368fdcd48/Calls/voiceNotify.xml? sig=841D35E63BB81C1D13918B4DD6CD988E 
Host:api.ucpaas.com 
Accept:application/xml 
Content-Type:application/xml;charset=utf-8 Authorization:ZTAzYmM5MTA2YzZlZDBlYWViZmNlOGMzNjhmZGNkNDg6MjAxNDA2MjMxODQ1MjM=   
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<voiceNotify> 
<appId>e462aba25bc6498fa5ada7eefe1401b7</appId>
<to>18612345678</to> 
<type>0</type> 
<content>您好，您有一条消息。</content> 
<toSerNum>075512345678</toSerNum>
<playTimes>3</playTimes> 
</voiceNotify>

XML 响应示例

<?xml version="1.0" encoding="utf-8" standalone="yes"?> 
<resp> 
<respCode>000000</respCode>
 <voiceNotify> 
<callId>48dcc7d44fb274f316924bedd7696645</callId> <createDate>20140623184518</createDate> 
</voiceNotify> 
</resp>

附录—常见问题

1.接口错误码说明>>

  http://localhost/doku.php?id=rest_error

2.调用接口返回100699 系统内部错误

  a.查看接口参数sig是否拼写正确  sig= md5(账户Id + 账户授权令牌 + 时间戳)共32位， md5加密后转大写
  b.查看接口参数Authorization是否拼写正确 Authorization=base64(账户Id +冒号+ 时间戳) 时间戳是当前系统时间（24小时制） yyyyMMddHHmmss

3.调用接口返回100005 访问ip不合法

  创建应用时，基础配置中的服务器白名单清空下，如果配置了服务器白名单调用接口
  必须在白名单上调用，否则就会报此错。

4.企业用户如何显示400号码

  应用管理-应用列表-找到对应的应用-管理-号码管理 添加需要显示的400号码，400号码审核需要提供资料：3证信息（营业执照、组织机构代码证、税务登记证）+400开户合同+400授权书（云之讯提供，须加盖公司公章）发送到fangyundan@ucpaas.com