双呼 - 云呼叫中心

双呼和传统的双方通话不同，主叫并不直接呼叫对方，而是通过一个背靠背代理(Back to Back Agent)，背靠背代理首先呼叫主叫方，接通后，再呼叫被叫方，然后把二者拉进一个会场。在这种方式下，由于每个呼叫的所有消息流经背靠背代理，因此服务提供商可以据此提供增值服务，比如计时、录音、隐藏真实号码等等。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	StartBack2BackCall	系统规定参数。取值：StartBack2BackCall。
Callee	String	是	1880134****	被叫号码。
Caller	String	是	1760066****	主叫号码。
InstanceId	String	是	9cfad875-6260-4a53-ab6e-b13e3fb3****	呼叫中心实例ID。背靠背代理所用电话号码需要归属于该呼叫中心实例。
WorkflowId	String	否	null	联系流ID。此联系流用来辅助建立双方通话，该字段是扩展用，请留空。
CallCenterNumber	String	否	0256604****	背靠背代理所用电话号码。该电话号码需要归属于instanceId指定的呼叫中心实例，若不指定，则会随机选一个指定实例下可用于外呼的号码。

返回数据


名称	类型	示例值	描述
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	15716647696706****	本次外呼产生的contactId(即:通话详单中的通话ID)，后续可以据此参数查询话务状态。
TimeStamp	String	2018-07-13 14:06:08	本次外呼的时间戳

示例

请求示例

http(s)://[Endpoint]/?Action=StartBack2BackCall
&Callee=1880134****
&Caller=1760066****
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb3****
&<公共请求参数>

正常返回示例

XML格式

<StatusDesc>Okay</StatusDesc>
<TaskId>15716647696706****</TaskId>
<Message>无</Message>
<RequestId>DE803553-8AA9-4B9D-9E4E-A82BC69EDCEE</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<StatusCode>200</StatusCode>
<Code>OK</Code>
<TimeStamp>2018-07-13 14:06:08</TimeStamp>
<Success>true</Success>

JSON格式

{
    "StatusDesc": "Okay",
    "TaskId": "15716647696706****",
    "Message": "无",
    "RequestId": "DE803553-8AA9-4B9D-9E4E-A82BC69EDCEE",
    "HttpStatusCode": 200,
    "StatusCode": 200,
    "Code": "OK",
    "TimeStamp": "2018-07-13 14:06:08",
    "Success": true
}

错误码

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