調(diào)用StartBack2BackCall發(fā)起雙呼。
接口說(shuō)明
雙呼和傳統(tǒng)的雙方通話不同，主叫并不直接呼叫對(duì)方，而是通過(guò)一個(gè)背靠背代理（Back to Back Agent），背靠背代理首先呼叫主叫方，接通后，再呼叫被叫方，然后把二者拉進(jìn)一個(gè)會(huì)場(chǎng)。在這種方式下，由于每個(gè)呼叫的所有消息流經(jīng)背靠背代理，因此服務(wù)提供商可以據(jù)此提供增值服務(wù)，比如計(jì)時(shí)、錄音、隱藏真實(shí)號(hào)碼等等。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 實(shí)例 ID。 | ccc-test |
| Caller | string | 是 | 主叫號(hào)碼。 | 1391814**** |
| Callee | string | 是 | 被叫號(hào)碼。 | 1372168**** |
| TimeoutSeconds | integer | 否 | 雙呼超時(shí)時(shí)間，呼叫在經(jīng)過(guò)該參數(shù)指定的時(shí)間仍然未接通的情況下，則主動(dòng)掛斷，非必填，默認(rèn) 30，單位秒。 | 30 |
| Broker | string | 是 | 中間號(hào)碼，需要是實(shí)例下可用的外呼號(hào)碼，雙呼時(shí)會(huì)使用該號(hào)碼先后呼叫主叫和被叫。 | 0102157**** |
| AdditionalBroker | string | 否 | 附加中間號(hào)碼，如果該參數(shù)存在，則呼叫主叫時(shí)使用中間號(hào)碼，呼叫被叫時(shí)使用該參數(shù)指定的號(hào)碼，非必填， 默認(rèn)空。 | 0102156**** |
| Tags | string | 否 | 隨路數(shù)據(jù)，不能超過(guò) 128 字節(jié)，主要用于擴(kuò)展需求，普通客戶無(wú)需關(guān)心。 | 無(wú) |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "無(wú)",
"RequestId": "26A34338-5CD9-4C95-A7A6-5BDCE76C6B94",
"Params": [
"無(wú)"
],
"Data": {
"CallContext": {
"CallType": "BACK2BACK",
"InstanceId": "ccc-test",
"JobId": "job-1034159089076****",
"ChannelContexts": [
{
"ReleaseInitiator": "無(wú)",
"ChannelState": "NONE",
"Destination": "1372168****",
"UserId": "無(wú)",
"ChannelFlags": "MONITORING",
"Timestamp": 1618217874062,
"ReleaseReason": "無(wú)",
"CallType": "BACK2BACK",
"JobId": "job-1034159089076****",
"ChannelId": "ch:user:1390501****->8032****:1609138902226:job-653821410368****",
"Originator": "0102157****",
"UserExtension": "8001****"
}
]
},
"UserContext": {
"Extension": "8020****",
"Heartbeat": 1618217872911,
"WorkMode": "ON_SITE",
"DeviceId": "ACC-YUNBS-1.0.10-****",
"UserId": "agent@ccc-test",
"Reserved": 1618217794599,
"BreakCode": "Warm-up",
"InstanceId": "ccc-test",
"OutboundScenario": false,
"DeviceState": "無(wú)",
"Mobile": "1324730****",
"JobId": "job-1034159089076****",
"UserState": "OFFLINE",
"SignedSkillGroupIdList": [
"skillgroup1@ccc-test"
]
}
}
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | 該參數(shù)不能為null或含有空白符的字符串。 |
| 404 | NotExists.InstanceId | The specified instance %s does not exist. | 指定的呼叫中心實(shí)例不存在。 |
| 404 | NotExists.Number | The specified number %s does not exist in instance %s. | 呼叫中心實(shí)例中不存在指定的號(hào)碼。 |
| 500 | InternalService.CTI | An internal CTI service error occurred. %s | 內(nèi)部CTI服務(wù)錯(cuò)誤。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|