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