SignOutGroup - 签出技能组

更新时间:
复制为 MD 格式

调用SignOutGroup使坐席签出当前签入的技能组,即坐席下线操作。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

实例 ID。

ccc-test

UserId

string

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

agent@ccc-test

DeviceId

string

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

device

返回参数

名称

类型

描述

示例值

object

Code

string

响应码。

200

HttpStatusCode

integer

HTTP 状态码。

200

Message

string

响应信息。

RequestId

string

请求 ID。

EEEE671A-3E24-4A04-81E6-6C4F5B39DF75

Params

array

响应参数列表。

string

响应参数。

Data

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 :

    振铃中

BREAK

SignedSkillGroupIdList

array

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

string

技能组 ID。

skillgroup1@ccc-test

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
  "Params": [
    "无"
  ],
  "Data": {
    "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": "BREAK",
    "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). 非法操作,用户状态不符合预期。
404 NotExists.InstanceId The specified instance %s does not exist. 指定的呼叫中心实例不存在。
404 NotExists.UserId The user %s does not exist in instance %s. 云联络中心实例中不存在指定的用户。

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

变更历史

更多信息,参考变更详情