队列管理 – 签入或签出坐席

批量签入或签出指定队列中的动态坐席。

请求 URL

GET {base_url}/{api_path}/queue/agent_login?access_token={access_token}

请求参数

参数 是否必填 类型 说明
ext_ids String 动态坐席的分机 ID。
注:
  • 可使用 搜索特定分机 接口查询坐席的分机 ID。
  • 使用半角逗号 , 分隔多个分机 ID。
queue_id Integer 队列的唯一 ID。
注: 可使用 搜索特定队列 接口查询队列的 ID。
operation String 签入或签出队列中的坐席。
取值范围
  • login:将动态坐席签入该队列。
  • logout:将动态坐席签出该队列。
is_paused Integer 签入队列中的动态坐席后,是否暂停其坐席服务。
取值范围
  • 0:签入后不暂停其坐席服务。
  • 1:签入后暂停其坐席服务。
注: 如果你没有设置该参数,则默认赋值 0
max_threshold_for_pause_time Integer 动态坐席暂停服务的时长 (单位:秒)。
取值范围
  • 0:保持暂停状态直到有新的请求使坐席恢复服务。
  • 10 或更大值:指定暂停的时长。超时后,坐席自动恢复服务。
max_threshold_for_logout_time Integer 动态坐席签出队列的时长 (单位:秒)。

取值范围

  • 0:保持签出状态直到有新的请求使坐席签入队列。
  • 10 或更大值:指定签出时长。超时后,自动将坐席签入队列。
reason String 暂停原因特征码。
取值范围:PBX 中已有暂停原因的特征码。
注:
  • 如果 PBX 未订阅 呼叫中心 服务,请勿传入此参数,否则会导致请求失败。
  • 可使用 查询暂停原因列表 接口查询暂停原因的特征码。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0:请求成功。
  • 非零值:请求失败。
注: 更多错误码和错误信息说明,请参见 错误码 & 错误信息
errmsg String 返回信息。
  • SUCCESS:请求成功。
  • FAILURE:请求失败。

示例

请求示例

将两名动态坐席 (分机 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"
}