IVR外呼

云通讯平台为开发者提供了IVR外呼接口,以便开发者通过IVR方式开展业务。本接口发起外呼命令,执行后云通讯平台会向第三方发起IVR启动业务通知(详见IVR API > IVR 基础通知消息)。开发者可通过后续的IVR命令开展业务。

REST API: 语音通知

通过HTTPS POST方式提交请求,云通讯平台收到请求后,向对象电话终端发起呼叫,接通电话后播放指定语音。

接口Demo示例可在REST Server Demo中找到,开发者可根据使用的语言下载对应的Demo

1、请求

1.1 请求地址

/{SoftVersion}/Accounts/{accountSid}/ivr/dial
					

1.2 请求包头

请参阅:Rest 介绍》统一请求包头,使用主账户进行验证

1.3 请求包体

属性 类型 约束 说明
Appid
String 必选 应用Id
number
String 必选 待呼叫号码,为Dial节点的属性
userdata String
可选 用户数据,需要base64加密,在<startservice>通知中返回,为Dial节点的属性
record
String
可选
是否录音,可填项为true和false,默认值为false不录音,为Dial节点的属性
disnumber
String
可选
用户方的显号号码,根据平台侧显号规则控制。

注意:显号设置需要云平台开放相关权限,如需开通请联系云通讯商务人员或拨打400-610-1019

1.4 请求示例

POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/dial?sig=155EAA68C5DFB6B762A42D88F406ABCD HTTP/1.1
Accept:application/xml;
Host:192.168.0.1:8883
content-length: 139
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=

<?xml version="1.0" encoding="UTF-8"?>
<Request>
  <Appid>12345678</Appid>
  <Dial number="13812345678" userdata="1" record="true"></Dial>
</Request>

					

2、响应

2.1 响应包体

属性 类型 约束 说明
statusCode String 必选 请求状态码,000000为成功,其他错误码则为失败,错误码可参考Rest 错误代码
callSid String 必选 一个由32个字符组成的通话唯一标识符,需要应用侧进行保存以便提供给云通讯的技术支持进行相关问题的查询,云通讯根据这唯一标识符进行快速的问题定位,以便能更快的解决问题。

2.2 响应示例

HTTP/1.1 200 OK
Content-Length:586

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response>
  <statusCode>000000</statusCode>
  <callSid>a346467ca321c71dbd5e12f627123456</callSid>  
</Response>
					

文档更新时间:2016年11月10日