ChangeWorkMode - 改变坐席工作模式

调用ChangeWorkMode改变坐席的工作模式。

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
InstanceIdstring

实例 ID。

ccc-test
UserIdstring

坐席 ID,不填默认使用当前 RAM 账号映射的坐席。

agent@ccc-test
DeviceIdstring

设备 ID,浏览器 WebRTC 软电话或实体话机设备的标识 ID,同一时间只允许一种设备注册。

ACC-YUNBS-1.0.10-****
WorkModestring

工作模式。

枚举值:
  • ON_SITE场内模式
  • OFF_SITE场外模式
  • OFFICE_PHONE办公电话模式
ON_SITE
SignedSkillGroupIdListstring

需要签入的技能组列表。当修改工作模式到场外模式时,可以通过此参数指定场外座席需要签入的技能组列表。

["online-1@ccc-test","online-2@ccc-test","online-3@ccc-test","skg-default@ccc-test"]
Mobilestring

坐席的个人电话号码,该号码在场外模式下会用到,坐席可以使用该号码进行场外模式接听。

1382114****

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP 状态码。

200
Messagestring

响应信息。

RequestIdstring

请求 ID。

87731ED1-6224-48A5-99E3-6237FF9B1C00
Paramsarray

响应参数。

string

响应参数。

Dataobject

数据。

Extensionstring

座席分机号。

8001****
WorkModestring

工作模式。

枚举值:
  • ON_SITE场内模式
  • OFF_SITE场外模式
  • OFFICE_PHONE办公电话模式
ON_SITE
DeviceIdstring

设备 ID,浏览器 WebRTC 软电话或实体话机设备的标识 ID,同一时间只允许一种设备注册。

ACC-YUNBS-1.0.10-****
JobIdstring

通话 ID,如果该字段有值,说明坐席当前处于通话过程中。

UserIdstring

坐席 ID。

agent@ccc-test
BreakCodestring

小休状态码,分为系统定义的和客户定义的两种,系统定义的小休码包括:Warm-up (坐席上线后置闲前的临时小休状态)、RingingTimeout(坐席振铃超时导致的小休)、RejectCall(坐席拒接导致的小休)。客户自定义状态码没有限制,客户可以根据业务需要自行定义。

Warm-up
InstanceIdstring

实例 ID。

ccc-test
OutboundScenarioboolean

坐席是否开启了仅外呼模式。

false
UserStatestring

座席状态。

枚举值:
  • READY空闲
  • WORKING话后处理中
  • DIALING拨号中
  • BREAK小休
  • OFFLINE离线
  • TALKING通话中
  • RINGING振铃中
OFFLINE
SignedSkillGroupIdListarray

坐席签入的技能组 ID 列表。

string

技能组 ID。

skillgroup@ccc-test

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "87731ED1-6224-48A5-99E3-6237FF9B1C00",
  "Params": [
    "无"
  ],
  "Data": {
    "Extension": "8001****",
    "WorkMode": "ON_SITE",
    "DeviceId": "ACC-YUNBS-1.0.10-****",
    "JobId": "无",
    "UserId": "agent@ccc-test",
    "BreakCode": "Warm-up",
    "InstanceId": "ccc-test",
    "OutboundScenario": false,
    "UserState": "OFFLINE",
    "SignedSkillGroupIdList": [
      "skillgroup@ccc-test"
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400Parameter.EnumerationThe parameter %s must be one of the value of enumeration %s.该参数必须为系统限定的枚举值之一。
400Parameter.BlankThe parameter %s may not be null or blank.该参数不能为null或含有空白符的字符串。

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

变更历史

变更时间变更内容概要操作
暂无变更历史