ChangeVisibility - 修改座席可见性

调试

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

授权信息

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

请求参数

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

呼叫中心实例 ID。

szpczf
UserIdstring

坐席 ID。

sam@szpczf
Invisibleboolean

是否切换为隐身状态。隐身状态和仅外呼含义一致。

true

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP 状态码。

200
Messagestring

响应信息

Internal service issue. Detail:.
RequestIdstring

请求 ID。

24BE19E8-BF7D-4992-A35E-15EBA874F2E5
Paramsarray

响应参数。

Paramstring

响应参数。

Dataobject

数据。

Extensionstring

座席分机号。

8001****
WorkModestring

工作模式。

ON_SITE
DeviceIdstring

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

Yealink SIP-T23G 44.84.203.6
JobIdstring

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

job-330557290544431104
UserIdstring

座席 ID。

sam@szpczf
BreakCodestring

小休代码。

会议
InstanceIdstring

实例 ID。

szpczf
OutboundScenarioboolean

坐席是否为仅外呼状态。

False
UserStatestring

用户状态。

Ready
SignedSkillGroupIdListarray

技能组 ID。

SkillGroupIdstring

技能组 ID。

skillgroup@ccc-test

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "Internal service issue. Detail:.",
  "RequestId": "24BE19E8-BF7D-4992-A35E-15EBA874F2E5",
  "Params": [
    "无"
  ],
  "Data": {
    "Extension": "8001****",
    "WorkMode": "ON_SITE",
    "DeviceId": "Yealink SIP-T23G 44.84.203.6",
    "JobId": "job-330557290544431104",
    "UserId": "sam@szpczf",
    "BreakCode": "会议",
    "InstanceId": "szpczf",
    "OutboundScenario": true,
    "UserState": "Ready",
    "SignedSkillGroupIdList": [
      "skillgroup@ccc-test"
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidOperation.ChannelStateThe operation is not allowed. Channel stats (%s) does not meet expectations (%s).-
400InvalidOperation.UserStateThe operation is not allowed. User state (%s) does not meet expectations (%s).非法操作,用户状态不符合预期。
404NotExists.InstanceIdThe specified instance %s does not exist.指定的呼叫中心实例不存在。
404NotExists.UserIdThe user %s does not exist in instance %s.呼叫中心实例中不存在指定的用户。

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