队列管理 – 签入或签出坐席
批量签入或签出指定队列中的动态坐席。
请求 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 。 |
reason | 否 | String | 暂停原因特征码。 取值范围:PBX 中已有暂停原因的特征码。 注:
|
响应参数
参数 | 类型 | 说明 |
---|---|---|
errcode | Integer | 返回错误码。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息。
|
errmsg | String | 返回信息。
|
示例
请求示例
将两名动态坐席 (分机 ID:92 和 85) 签入队列 ( ID:3) ,并在签入后暂停其坐席服务。
GET /openapi/v1.0/queue/agent_login?access_token=gOcxZZjxZQ5B0c4aIecuGEqYpGiRSvjW&ext_ids=92,85&queue_id=3&operation=login&is_pause=1 HTTP/1.1
Host: yeastardocs.example.yeastarcloud.com
响应示例HTTP/1.1 200 OK
{
"errcode": 0,
"errmsg": "SUCCESS"
}