调用StartBack2BackCall发起双呼。
双呼和传统的双方通话不同,主叫并不直接呼叫对方,而是通过一个背靠背代理(Back to Back Agent), 背靠背代理首先呼叫主叫方,接通后,再呼叫被叫方,然后把二者拉进一个会场。在这种方式下,由于每个呼叫的所有消息流经背靠背代理,因此服务提供商可以据此提供增值服务,比如计时、录音、隐藏真实号码等等。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | StartBack2BackCall |
系统规定参数。取值:StartBack2BackCall。 |
Callee | String | 是 | 18801341452 |
被叫号码。 |
Caller | String | 是 | 17600668806 |
主叫号码。 |
InstanceId | String | 是 | 9cfad875-6260-4a53-ab6e-b13e3fb31f7d |
呼叫中心实例ID。 背靠背代理所用电话号码需要归属于该呼叫中心实例。 |
AccessKeyId | String | 否 | xxx |
您的AccessKey ID。 |
CallCenterNumber | String | 否 | 02566040852 |
背靠背代理所用电话号码。 该电话号码需要归属于instanceId指定的呼叫中心实例,若不指定,则会随机选一个指定实例下可用于外呼的号码。 |
WorkflowId | String | 否 | null |
联系流ID。 此联系流用来辅助建立双方通话,该字段是扩展用,请留空。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | OK |
响应码 |
HttpStatusCode | Integer | 200 |
HTTP状态码 |
Message | String | 无 |
响应信息 |
RequestId | String | DE803553-8AA9-4B9D-9E4E-A82BC69EDCEE |
请求ID |
StatusCode | String | 200 |
外呼返回状态码 |
StatusDesc | String | Okay |
外呼返回状态描述 |
Success | Boolean | true |
是否成功 |
TaskId | String | 157166476967063733 |
本次外呼产生的contactId(即:通话详单中的通话ID),后续可以据此参数查询话务状态。 |
TimeStamp | String | 2018-07-13 14:06:08 |
本次外呼的时间戳 |
示例
请求示例
http(s)://ccc.cn-shanghai.aliyuncs.com/?Action=StartBack2BackCall
&Callee=18801341452
&Caller=17600668806
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&<公共请求参数>
正常返回示例
XML
格式
<StartBack2BackCallResponse>
<StatusCode>200</StatusCode>
<TimeStamp>2018-07-13 14:06:08</TimeStamp>
<HttpStatusCode>200</HttpStatusCode>
<StatusDesc>Okay</StatusDesc>
<RequestId>DE803553-8AA9-4B9D-9E4E-A82BC69EDCEE</RequestId>
<TaskId>157166476967063733</TaskId>
<Success>true</Success>
<Code>OK</Code>
</StartBack2BackCallResponse>
JSON
格式
{
"TimeStamp":"2018-07-13 14:06:08",
"StatusCode":200,
"HttpStatusCode":200,
"StatusDesc":"Okay",
"RequestId":"DE803553-8AA9-4B9D-9E4E-A82BC69EDCEE",
"TaskId":"157166476967063733",
"Success":true,
"Code":"OK"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交