直接轉(zhuǎn)接通話到其他坐席或某個(gè)技能組隊(duì)列或外部號(hào)碼，直接轉(zhuǎn)接也叫盲轉(zhuǎn)或單步轉(zhuǎn)。
調(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 |
| UserId | string | 是 | 發(fā)起直接轉(zhuǎn)接的坐席 ID。 | agent@ccc-test |
| DeviceId | string | 是 | 設(shè)備 ID，無意義，可以隨便填寫。 | ACC-YUNBS-1.0.10-**** |
| Transferor | string | 否 | 轉(zhuǎn)接發(fā)起方，當(dāng)場(chǎng)景是直接轉(zhuǎn)接到外部號(hào)碼時(shí)，用此參數(shù)指定的號(hào)碼作為主叫，轉(zhuǎn)內(nèi)部坐席或技能組時(shí)，此參數(shù)無效，發(fā)起方由 UserId 指定。 | 08314325**** |
| Transferee | string | 是 | 被轉(zhuǎn)接方，可以是坐席 ID 或技能組 ID。 | agent@ccc-test |
| TimeoutSeconds | integer | 否 | 直接轉(zhuǎn)接超時(shí)時(shí)間，超過指定時(shí)間被轉(zhuǎn)接方?jīng)]有接起通話，則掛斷通話，此字段選填，默認(rèn) 30，單位秒。 | 60 |
| JobId | string | 是 | 通話 ID。 | job-6538214103685**** |
| CallPriority | integer | 否 | 轉(zhuǎn)接到技能組隊(duì)列時(shí)的排隊(duì)優(yōu)先級(jí)，取值范圍 0-9，0 優(yōu)先級(jí)最高，9 最低。 | 5 |
| StrategyName | string | 否 | 轉(zhuǎn)接到技能組隊(duì)列時(shí)的座席分配策略名稱。 | MOST_IDLE，MOST_SKILLED，MOST_ACQUAINTED，CUSTOMIZED等 |
| StrategyParams | string | 否 | 轉(zhuǎn)接到技能組隊(duì)列時(shí)的座席分配策略參數(shù)。 | 當(dāng)分配策略為CUSTOMIZED時(shí)，本參數(shù)的內(nèi)容為如下格式： { "functionId": "512fed64-e379-400f-a1a5-14d5730xxxxx", "functionName": "routing-strategy-test-2" } |
| TransfereeType | string | 否 | 轉(zhuǎn)接目的類型，可選值為 AGENT，SKILL_GROUP，IVR 和 EXTERNAL_NUMBER。如果此參數(shù)不傳，則系統(tǒng)會(huì)根據(jù)轉(zhuǎn)接的目標(biāo)號(hào)碼的格式進(jìn)行判斷，如果發(fā)現(xiàn)有判不準(zhǔn)確的情況，則需要指定此參數(shù)。 | SKILL_GROUP |
| ContactFlowVariables | string | 否 | 傳遞給聯(lián)系流的變量，選填，這里配置的變量，可以在 IVR 流程中拿到并使用，格式為 JSON 字符串格式的鍵值對(duì)集合。 | {"name":"王先生","time":"19點(diǎn)20分","address":"某某中心"} |
| RoutingType | string | 否 | 話務(wù)分配類型，可選參數(shù)為自動(dòng)分配(Automatic)或者手動(dòng)分配(Manual)。如果此參數(shù)為空，則默認(rèn)為自動(dòng)分配的方式，這也是當(dāng)前系統(tǒng)的默認(rèn)行為。選擇手動(dòng)分配方式時(shí)，需要您自己配合調(diào)用 ClaimCall 等接口把電話分給指定的座席。 | Manual |
| Tags | string | 否 | 隨路數(shù)據(jù)，主要用于擴(kuò)展需求，普通用戶無需關(guān)心。 | 5295578135#WAEtqY5U&Biz_Package_Rexian_Zhuanjieanquanyungaojie_2527 |
| QueuingTimeoutSeconds | long | 否 | 當(dāng)轉(zhuǎn)接目標(biāo)是技能組隊(duì)列時(shí)排隊(duì)超時(shí)時(shí)間，單位為秒。 | 10 |
| QueuingOverflowThreshold | long | 否 | 當(dāng)轉(zhuǎn)接目標(biāo)是技能組隊(duì)列時(shí)排隊(duì)溢出閾值。默認(rèn)值為 0，表示不溢出。 | 0 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "無",
"RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
"Params": [
"無"
],
"Data": {
"ContextId": 103654,
"CallContext": {
"CallType": "OUTBOUND",
"InstanceId": "ccc-test",
"JobId": "job-6538214103685****",
"ChannelContexts": [
{
"ReleaseInitiator": "1390501****",
"ChannelState": "ANSWERED",
"Destination": "1390501****",
"UserId": "agent@ccc-test",
"ChannelFlags": "MONITORING",
"Timestamp": 1609138903315,
"ReleaseReason": "404 - No destination",
"CallType": "OUTBOUND",
"JobId": "job-6538214103685****",
"ChannelId": "ch:user:1390501****->8032****:1609138902226:job-653821410368****",
"Originator": "0830019****",
"UserExtension": "8032****"
}
]
},
"UserContext": {
"Extension": "8032****",
"Heartbeat": 1609136956378,
"WorkMode": "ON_SITE",
"DeviceId": "ACC-YUNBS-1.0.10-****",
"UserId": "agent@ccc-test",
"Reserved": 1609136956378,
"BreakCode": "Warm-up",
"InstanceId": "ccc-test",
"OutboundScenario": false,
"Mobile": "1324730****",
"JobId": "job-6538214103685****",
"UserState": "TALKING",
"SignedSkillGroupIdList": [
"skillgroup1@ccc-test"
]
}
}
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | 該參數(shù)不能為null或含有空白符的字符串。 |
| 400 | Parameter.Invalid | The parameter %s is invalid. %s. | 該參數(shù)無效。 |
| 404 | NotExists.InstanceId | The specified instance %s does not exist. | 指定的呼叫中心實(shí)例不存在。 |
| 404 | NotExists.JobId | The call %s does not exist. | 指定的通話信息不存在。 |
| 500 | InternalService.CTI | An internal CTI service error occurred. %s | 內(nèi)部CTI服務(wù)錯(cuò)誤。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-04-01 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-11-07 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-04-25 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-04-12 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |