InitiateAttendedTransfer_云联络中心_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

请求速率为2000/1(s)。更多流控信息,请前往配额中心查看

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
InstanceIdstring

实例 ID。

示例值:ccc-test参考取值来源:
    ListInstances
UserIdstring

发起咨询转接的坐席 ID。

示例值:agent@ccc-test参考取值来源:
    GetUser
    ListUsers
    CreateUser
DeviceIdstring

设备 ID,无意义,可以随便填写。

示例值:ACC-YUNBS-1.0.10-****
Transferorstring

转接发起方,当场景是咨询转接到外部号码时,用此参数指定的号码作为主叫,转内部坐席或技能组时,此参数无效,发起方由 UserId 指定。

示例值:
Transfereestring

被转接方,可以是坐席 ID 或技能组 ID。

示例值:agent2@ccc-test
TimeoutSecondsinteger<int32>

咨询转接超时时间,超过指定时间被转接方没有接起通话,则挂断通话,此字段选填,默认 30,单位秒。

示例值:60
JobIdstring

通话 ID。

示例值:job-6538214103685****
CallPriorityinteger<int32>

转接到技能组队列时的排队优先级,取值范围 0-9,0 优先级最高,9 最低。

示例值:5
StrategyNamestring

转接到技能组队列时的座席分配策略名称。

示例值:MOST_IDLE,MOST_SKILLED,MOST_ACQUAINTED,CUSTOMIZED等
StrategyParamsstring

转接到技能组队列时的座席分配策略参数。

示例值:当分配策略为CUSTOMIZED时,本参数的内容为如下格式: { "functionId": "512fed64-e379-400f-a1a5-14d5730xxxxx", "functionName": "routing-strategy-test-2" }
TransfereeTypestring

转接目的类型,可选值为 AGENT,SKILL_GROUP 和 EXTERNAL。如果此参数不传,则系统会根据转接的目标号码的格式进行判断,如果发现有判不准确的情况,则需要指定此参数。

示例值:SKILL_GROUP枚举值:AGENTEXTERNALSKILL_GROUP
RoutingTypestring

话务分配类型,可选参数为自动分配(Automatic)或者手动分配(Manual)。如果此参数为空,则默认为自动分配的方式,这也是当前系统的默认行为。选择手动分配方式时,需要您自己配合调用 ClaimCall 等接口把电话分给指定的座席。

示例值:Automatic枚举值:ManualAutomatic参考取值来源:
    GetChatRoutingProfile
Tagsstring

随路数据,主要用于扩展需求,普通用户无需关心。

示例值:a=b参考取值来源:
    ListCallTags
QueuingTimeoutSecondsinteger<int64>

当转接目标是技能组队列时排队超时时间,单位为秒。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:10
QueuingOverflowThresholdinteger<int64>

当转接目标是技能组队列时排队溢出阈值。默认值为 0,表示不溢出。

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:0

返回参数

字段名称字段详情
Codestring

响应码。

示例值:OK
HttpStatusCodeinteger<int32>

HTTP 状态码。

示例值:200
Messagestring

响应信息。

示例值:
RequestIdstring

请求 ID。

示例值:EEEE671A-3E24-4A04-81E6-6C4F5B39DF75
Paramsarray<string>

响应参数列表。

Dataobject

数据。

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
Parameter.Blank
The parameter %s may not be null or blank.诊断
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).诊断
404
NotExists.ChannelId
The specified channel %s does not exist in call %s.诊断
404
NotExists.InstanceId
The specified instance %s does not exist.诊断
404
NotExists.JobId
The call %s does not exist.诊断
500
InternalService.CTI
An internal CTI service error occurred. %s诊断

变更历史

变更时间变更内容概要操作
2024-04-01
新增请求参数TransfereeType
新增请求参数RoutingType
新增请求参数Tags
新增请求参数QueuingTimeoutSeconds
新增请求参数QueuingOverflowThreshold
2023-10-26
变更请求参数DeviceId
2023-04-25
新增请求参数StrategyName
新增请求参数StrategyParams
2023-04-12
新增请求参数CallPriority

相关示例