咨詢轉(zhuǎn)接通話到其他坐席或某個技能組隊(duì)列或外部號碼,咨詢轉(zhuǎn)接也叫關(guān)注轉(zhuǎn)或雙步轉(zhuǎn)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
請求參數(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)場景是咨詢轉(zhuǎn)接到外部號碼時,用此參數(shù)指定的號碼作為主叫,轉(zhuǎn)內(nèi)部坐席或技能組時,此參數(shù)無效,發(fā)起方由 UserId 指定。 | 無 |
Transferee | string | 是 | 被轉(zhuǎn)接方,可以是坐席 ID 或技能組 ID。 | agent2@ccc-test |
TimeoutSeconds | integer | 否 | 咨詢轉(zhuǎn)接超時時間,超過指定時間被轉(zhuǎn)接方?jīng)]有接起通話,則掛斷通話,此字段選填,默認(rèn) 30,單位秒。 | 60 |
JobId | string | 是 | 通話 ID。 | job-6538214103685**** |
CallPriority | integer | 否 | 轉(zhuǎn)接到技能組隊(duì)列時的排隊(duì)優(yōu)先級,取值范圍 0-9,0 優(yōu)先級最高,9 最低。 | 5 |
StrategyName | string | 否 | 轉(zhuǎn)接到技能組隊(duì)列時的座席分配策略名稱。 | MOST_IDLE,MOST_SKILLED,MOST_ACQUAINTED,CUSTOMIZED等 |
StrategyParams | string | 否 | 轉(zhuǎn)接到技能組隊(duì)列時的座席分配策略參數(shù)。 | 當(dāng)分配策略為CUSTOMIZED時,本參數(shù)的內(nèi)容為如下格式: { "functionId": "512fed64-e379-400f-a1a5-14d5730xxxxx", "functionName": "routing-strategy-test-2" } |
TransfereeType | string | 否 | 轉(zhuǎn)接目的類型,可選值為 AGENT,SKILL_GROUP 和 EXTERNAL。如果此參數(shù)不傳,則系統(tǒng)會根據(jù)轉(zhuǎn)接的目標(biāo)號碼的格式進(jìn)行判斷,如果發(fā)現(xiàn)有判不準(zhǔn)確的情況,則需要指定此參數(shù)。 枚舉值:
| SKILL_GROUP |
RoutingType | string | 否 | 話務(wù)分配類型,可選參數(shù)為自動分配(Automatic)或者手動分配(Manual)。如果此參數(shù)為空,則默認(rèn)為自動分配的方式,這也是當(dāng)前系統(tǒng)的默認(rèn)行為。選擇手動分配方式時,需要您自己配合調(diào)用 ClaimCall 等接口把電話分給指定的座席。 | Automatic |
Tags | string | 否 | 隨路數(shù)據(jù),主要用于擴(kuò)展需求,普通用戶無需關(guān)心。 | a=b |
QueuingTimeoutSeconds | long | 否 | 當(dāng)轉(zhuǎn)接目標(biāo)是技能組隊(duì)列時排隊(duì)超時時間,單位為秒。 | 10 |
QueuingOverflowThreshold | long | 否 | 當(dāng)轉(zhuǎn)接目標(biāo)是技能組隊(duì)列時排隊(duì)溢出閾值。默認(rèn)值為 0,表示不溢出。 | 0 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "無",
"RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
"Params": [
"無"
],
"Data": {
"ContextId": 103655,
"CallContext": {
"CallType": "OUTBOUND",
"InstanceId": "ccc-test",
"JobId": "job-6538214103685****",
"ChannelContexts": [
{
"Index": 10,
"ReleaseInitiator": "1390501****",
"ChannelState": "ANSWERED",
"Destination": "1390501****",
"UserId": "agent@ccc-test",
"ChannelFlags": "MONITORING",
"SkillGroupId": "skillgroup@ccc-test",
"Timestamp": 1609138903315,
"ReleaseReason": "404 - No destination",
"CallType": "OUTBOUND",
"JobId": "job-6538214103685****",
"ChannelId": "ch:user:139xxxx0501->80326034:1609138902226:job-6538214103685****",
"UserExtension": "8032****",
"Originator": "0830019****"
}
]
},
"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"
]
}
}
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | Parameter.Blank | The parameter %s may not be null or blank. | 該參數(shù)不能為null或含有空白符的字符串。 |
400 | InvalidOperation.ChannelState | The operation is not allowed. Channel stats (%s) does not meet expectations (%s). | - |
400 | InvalidOperation.UserState | The operation is not allowed. User state (%s) does not meet expectations (%s). | 非法操作,用戶狀態(tài)不符合預(yù)期。 |
404 | NotExists.ChannelId | The specified channel %s does not exist in call %s. | 通話中不存在指定的Channel信息。 |
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ù)錯誤。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-04-01 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-10-26 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-04-25 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-04-12 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |