调用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"
}

错误码

访问错误中心查看更多错误码。