坐席管理 – 签入或签出队列
为指定的动态坐席签入或签出单个或多个队列。
请求 URL
GET {base_url}/{api_path}/agent/login?access_token={access_token}
请求参数
参数 | 是否必填 | 类型 | 说明 |
---|---|---|---|
ext_id | 是 | Integer | 动态坐席的分机 ID。 注: 可使用 搜索特定分机 接口查询坐席的分机
ID。
|
queue_ids | 否 | String | 重要: 若未填写此参数,则默认签入或签出指定坐席的全部队列。
|
operation | 是 | String | 将坐席签入或签出指定队列。 取值范围:
|
is_paused | 否 | Integer | 在将动态坐席签入队列后,是否暂停其坐席服务。 取值范围:
注: 如果你没有设置该参数,则默认赋值
0 。 |
reason | 否 | String | 暂停原因特征码。 取值范围:PBX 中已有暂停原因的特征码。 注:
|
响应参数
参数 | 类型 | 说明 |
---|---|---|
errcode | Integer | 返回错误码。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息。
|
errmsg | String | 返回信息。
|
示例
请求示例
将动态坐席 (分机 ID:85) 签入其所在的全部队列,并且在签入后暂停其坐席服务。
GET /openapi/v1.0/agent/login?access_token=u6UfsayUeBpUrwwpaBs6hkDeCzEE6D6t&ext_id=85&operation=login&is_pause=1 HTTP/1.1
Host: yeastardocs.example.yeastarcloud.com
响应示例HTTP/1.1 200 OK
{
"errcode": 0,
"errmsg": "SUCCESS"
}