调用StartBack2BackCall发起双呼。

双呼和传统的双方通话不同,主叫并不直接呼叫对方,而是通过一个背靠背代理(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
}

错误码

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