IVR 外呼_开发文档_容联云通讯

| 开发者中心

新用户指南 SDK文档 Rest API IVR API 云通讯首页

∨ 外呼通知

语音通知

IVR 外呼

状态通知接口

❀ 云通讯首页>>开发者中心>>Rest API>>外呼通知

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日