调用SignOutGroup使坐席签出当前签入的技能组,即坐席下线操作。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| 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 |
| 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(坐席拒接导致的小休)。客户自定义状态码没有限制,客户可以根据业务需要自行定义。 枚举值:
|
Warm-up |
| InstanceId |
string |
实例 ID。 |
ccc-test |
| OutboundScenario |
boolean |
坐席是否处于仅外呼模式。 |
false |
| Mobile |
string |
坐席的个人电话号码。 |
1324730**** |
| JobId |
string |
通话 ID。 |
job-6538214103685**** |
| UserState |
string |
座席状态。 枚举值:
|
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. | 云联络中心实例中不存在指定的用户。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。