队列管理 – 签入或签出坐席
批量签入或签出指定队列中的动态坐席。
请求 URL
GET {base_url}/{api_path}/queue/agent_login?access_token={access_token}
请求参数
参数 | 是否必填 | 类型 | 说明 |
---|---|---|---|
ext_ids | 是 | String | 动态坐席的分机 ID。 注:
|
queue_id | 是 | Integer | 队列的唯一 ID。 注: 可使用 搜索特定队列 接口查询队列的
ID。 |
operation | 是 | String | 签入或签出队列中的坐席。 取值范围:
|
is_paused | 否 | Integer | 签入队列中的动态坐席后,是否暂停其坐席服务。 取值范围:
注: 如果你没有设置该参数,则默认赋值
0 。 |
max_threshold_for_pause_time | 否 | Integer | 动态坐席暂停服务的时长 (单位:秒)。 取值范围:
|
max_threshold_for_logout_time | 否 | Integer | 动态坐席签出队列的时长 (单位:秒)。 取值范围:
|
reason | 否 | String | 暂停原因特征码。 取值范围:PBX 中已有暂停原因的特征码。 注:
|
响应参数
参数 | 类型 | 说明 |
---|---|---|
errcode | Integer | 返回错误码。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息。
|
errmsg | String | 返回信息。
|
示例
请求示例
将两名动态坐席 (分机 ID:21 和 24) 签入队列 (ID:1),并在签入后暂停两名坐席的服务 5 分钟。
GET /openapi/v1.0/queue/agent_login?access_token=pL1Xyk5cHf13p2eCkuJBX9i94O9OpMtf&ext_ids=21,24&queue_id=1&operation=login&is_paused=1&max_threshold_for_pause_time=300 HTTP/1.1
Host: 192.168.5.150:8088
响应示例HTTP/1.1 200 OK
{
"errcode": 0,
"errmsg": "SUCCESS"
}