调用InitiateAttendedTransfer API发起咨询转接-云联络中心-阿里云-云联络中心(Cloud Contact Center)-阿里云帮助中心

咨询转接通话到其他坐席或某个技能组队列或外部号码，咨询转接也叫关注转或双步转。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	ccc-test
UserId	string	否	发起咨询转接的坐席 ID。	agent@ccc-test
DeviceId	string	否	设备 ID，无意义，可以随便填写。	ACC-YUNBS-1.0.10-****
Transferor	string	否	转接发起方，当场景是咨询转接到外部号码时，用此参数指定的号码作为主叫，转内部坐席或技能组时，此参数无效，发起方由 UserId 指定。	无
Transferee	string	是	被转接方，可以是坐席 ID 或技能组 ID。	agent2@ccc-test
TimeoutSeconds	integer	否	咨询转接超时时间，超过指定时间被转接方没有接起通话，则挂断通话，此字段选填，默认 30，单位秒。	60
JobId	string	是	通话 ID。	job-6538214103685****
CallPriority	integer	否	转接到技能组队列时的排队优先级，取值范围 0-9，0 优先级最高，9 最低。	5
StrategyName	string	否	转接到技能组队列时的座席分配策略名称。	MOST_IDLE，MOST_SKILLED，MOST_ACQUAINTED，CUSTOMIZED等
StrategyParams	string	否	转接到技能组队列时的座席分配策略参数。	当分配策略为CUSTOMIZED时，本参数的内容为如下格式： { "functionId": "512fed64-e379-400f-a1a5-14d5730xxxxx", "functionName": "routing-strategy-test-2" }
TransfereeType	string	否	转接目的类型，可选值为 AGENT，SKILL_GROUP 和 EXTERNAL。如果此参数不传，则系统会根据转接的目标号码的格式进行判断，如果发现有判不准确的情况，则需要指定此参数。枚举值： AGENT : 座席 EXTERNAL : 外部号码 SKILL_GROUP : 技能组	SKILL_GROUP
RoutingType	string	否	话务分配类型，可选参数为自动分配(Automatic)或者手动分配(Manual)。如果此参数为空，则默认为自动分配的方式，这也是当前系统的默认行为。选择手动分配方式时，需要您自己配合调用 ClaimCall 等接口把电话分给指定的座席。枚举值： Manual : 手动分配 Automatic : 自动分配	Automatic
Tags	string	否	随路数据，主要用于扩展需求，普通用户无需关心。	a=b
QueuingTimeoutSeconds	integer	否	当转接目标是技能组队列时排队超时时间，单位为秒。	10
QueuingOverflowThreshold	integer	否	当转接目标是技能组队列时排队溢出阈值。默认值为 0，表示不溢出。	0

返回参数

名称	类型	描述	示例值
	object
Code	string	响应码。	OK
HttpStatusCode	integer	HTTP 状态码。	200
Message	string	响应信息。	无
RequestId	string	请求 ID。	EEEE671A-3E24-4A04-81E6-6C4F5B39DF75
Params	array	响应参数列表。
	string	响应参数。	无
Data	object	数据。
ContextId	integer	系统自增 ID，客户无需关心。	103655
CallContext	object	话务上下文环境。
CallType	string	通话类型。枚举值： INBOUND : 呼入 BARGE : 强插 CONSULTANT : 咨询 CONFERENCE : 会议 MONITOR : 监听 INTERNAL : 内部通话 OUTBOUND : 呼出 INTERCEPT : 强拆 BACK2BACK : 双呼 PREDICTIVE : 预测式外呼 COACH : 辅导	OUTBOUND
InstanceId	string	实例 ID。	ccc-test
JobId	string	通话 ID。	job-6538214103685****
ChannelContexts	array<object>	话务通道列表。
	object	话务通道。
Index	integer	记录这个 Channel 在通话过程中创建的顺序。	10
ReleaseInitiator	string	话务通道的挂断方，表示该话务通道是谁首先发起的挂断。	1390501****
ChannelState	string	话务通道的状态。枚举值： CREATED : 已创建 ANSWERED : 已接通 RELEASED : 已挂断 RETIRED : 已失效 EARLY_MEDIA : 早媒体阶段 NONE : 初始状态 RINGING : 振铃中	ANSWERED
Destination	string	话务通道的被叫方。	1390501****
UserId	string	话务通道关联的坐席 ID，如果是客户的话务通道，该字段为空。	agent@ccc-test
ChannelFlags	string	话务通道标志。枚举值： COACHING : 辅导中 MONITORING : 监听中 MONITORED : 被监听 COACHED : 被辅导 HOLD : 保持 MUTED : 静音	MONITORING
SkillGroupId	string	话务通道关联的技能组 ID，呼入场景下，关联的技能组 ID 由 IVR 中转人工模块配置的技能组决定，呼出场景下，关联的技能组 ID 为座席签入的第一个技能组的 ID。	skillgroup@ccc-test
Timestamp	integer	话务通道最近一次状态变化的时间戳，格式是 Unix 时间戳，单位毫秒。	1609138903315
ReleaseReason	string	话务通道的挂断原因，表示当前话务通道为什么会被挂断，取值来自 SIP 协议中定义的响应码，请客户参考 SIP 协议分析挂断原因。	404 - No destination
CallType	string	话务通道的通话类型。	OUTBOUND
JobId	string	通话 ID。	job-6538214103685****
ChannelId	string	通道 ID。	ch:user:139xxxx0501->80326034:1609138902226:job-6538214103685****
UserExtension	string	话务通道关联的坐席的分机号。	8032****
Originator	string	话务通道的主叫方。	0830019****
UserContext	object	坐席上下文环境。
Extension	string	坐席分机号。	8032****
Heartbeat	integer	上次收到坐席心跳的时间，格式为 Unix 时间戳，单位毫秒。	1609136956378
WorkMode	string	工作模式。枚举值： ON_SITE : 场内模式 OFF_SITE : 场外模式 OFFICE_PHONE : 办公电话模式	ON_SITE
DeviceId	string	设备 ID，浏览器 WebRTC 软电话或实体话机设备的标识 ID，同一时间只允许一种设备注册。	ACC-YUNBS-1.0.10-****
UserId	string	坐席 ID。	agent@ccc-test
Reserved	integer	坐席最近一次被预定的时间，被预定意味着马上将有来电分配给该坐席，格式为 Unix 时间戳，单位毫秒。	1609136956378
BreakCode	string	小休状态码，分为系统定义的和客户定义的两种，系统定义的小休吗包括：Warm-up （坐席上线后置闲前的临时小休状态）、RingingTimeout（坐席振铃超时导致的小休）、RejectCall（坐席拒接导致的小休）。客户自定义状态码没有限制，客户可以根据业务需要自行定义。枚举值： RingingTimeout : 坐席振铃超时导致的小休 RejectCall : 坐席拒接导致的小休 Warm-up : 坐席上线后置闲前的临时小休状态	Warm-up
InstanceId	string	实例 ID。	ccc-test
OutboundScenario	boolean	坐席是否处于仅外呼模式。	false
Mobile	string	坐席的个人电话号码。	1324730****
JobId	string	通话 ID。	job-6538214103685****
UserState	string	座席状态。枚举值： READY : 空闲 WORKING : 话后处理中 DIALING : 拨号中 BREAK : 小休 OFFLINE : 离线 TALKING : 通话中 RINGING : 振铃中	TALKING
SignedSkillGroupIdList	array	坐席签入的技能组 ID 列表。
	string	技能组 ID。	skillgroup1@ccc-test

示例

正常返回示例

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.	该参数不能为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).	非法操作，用户状态不符合预期。
500	InternalService.CTI	An internal CTI service error occurred. %s	内部CTI服务错误。
404	NotExists.ChannelId	The specified channel %s does not exist in call %s.	通话中不存在指定的Channel信息。
404	NotExists.InstanceId	The specified instance %s does not exist.	指定的呼叫中心实例不存在。
404	NotExists.JobId	The call %s does not exist.	指定的通话信息不存在。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。