文档>语音双向回拨

语音双向回拨

1.语音双向回拨

请通过HTTPS POST方式提交请求,有联云融合通讯开放平台收到请求后,将向两个电话终端发起呼叫,双方接通电话后进行通话。

请求

请求地址

/Accounts/{AccountSid}/Calls/callBack

请求包头

详情请查阅统一请求包头,并使用开发者账号进行验证。

请求包体

属性 类型 约束 说明
appId String 必选 应用Id
clientId String 必选 主叫clientNumber号码,clientNumber必须是绑定了主叫正常的电话号码。申请Client
callee String 必选 被叫正常电话号码。
caller String 必选 主叫正常电话号码。
callerDisplay String 可选 主叫侧显示的号码,只能显示400号码或固话。查阅显号规则
calleeDisplay String 可选 被叫侧显示的号码。可显示手机号码、400号码或固话。查阅显号规则

XML请求示例

/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callBack.xml?sig=C80B3CA83E40F3947C41B15BE0523FB2
Host:app.youlianyun.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8
Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY=
 
<?xml version="1.0" encoding="UTF-8"?>
 <appId>950a97bce77b885b747536a1e3887465</appId>
 <clientId>61207000000015</clientId>
 <callee>15012345678</callee>
 <caller>13823501990</caller>
 <callerDisplay>4001234567</callerDisplay>
 <calleeDisplay>4000004567</callerDisplay>

JSON请求示例

/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callBack?sig=C80B3CA83E40F3947C41B15BE0523FB2
Host:app.youlianyun.com
Accept:application/json
Content-Type:application/xml;charset=utf-8
Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY=
{
	 "appId" : "950a97bce77b885b747536a1e3887465",
 	 "clientId" : "61207000000015",
         "callee" : "15012345678",	
         "caller" : "13823501990",	
 	 "callerDisplay" : "4001234567",
 	 "calleeDisplay" : "4000004567"
}

响应

响应包体

属性 类型 约束 说明
respCode String 必选 请求状态码,取值200(success)
reason String 必选 回调结果
callId String 必选 呼叫的唯一标识

XML响应示例

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<respCode>200</respCode>   
<reason>success</reason>
<callId>60000000000008mRrDm254582</callId>

JSON响应示例

{
    "respCode"   : "200",
     "reason" : "success",
     "callId"   : "60000000000008mRrDm254582"
}

2.取消回拨

取消回拨是支持客户用于任意时间段结束双向回拨呼叫的能力接口。通过此REST API可以实现对误操作外呼的取消功能。 通过HTTPS GET方式提交请求,平台收到请求后,取消双向回拨通话。

请求

• 请求地址

/Accounts/{AccountSid}/Calls/callCancel

• 请求包头

请参阅统一请求包头,使用子账户进行验证

• 请求包体

属性 类型 约束 说明
appId String 必选 应用Id
callId String 必选 一个由32个字符组成的电话唯一标识符

• XML请求示例

https://app.youlianyun.com/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callCancel.xml?sig=C80B3CA83E40F3947C41B15BE0523FB2&appId=950a97bce77b885b747536a1e3887465&callId=ce199b9f4264684379311d9c87ffe7c4
Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY=

• JSON请求示例

https://app.youlianyun.com/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/callCancel?sig=C80B3CA83E40F3947C41B15BE0523FB2&appId=950a97bce77b885b747536a1e3887465&callId=5ac53758dbb79e0ec19e179756c84e25
Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY=

响应

• 响应包体

属性 类型 约束 说明
respCode String 必选 请求状态码,取值200(success)
reason String 必选 回调结果

• XML响应示例

<?xml version="1.0" encoding="UTF-8"?>
 <respCode>200</respCode>
 <reason>success</reason>

• JSON响应示例

{
	 "respCode" : "200"
	 "reason" : "success"
}

想了解更多信息,请咨询QQ : 12925489

免费咨询