坐席管理 – 暂停或恢复队列服务

暂停或恢复坐席在单个或多个队列中的服务。

请求 URL

GET {base_url}/{api_path}/agent/pause?access_token={access_token}

请求参数

参数 是否必填 类型 说明
ext_id 是 Integer 坐席的分机 ID。
注： 可使用 搜索特定分机 接口查询坐席的分机 ID。
queue_ids 否 String
重要： 若未填写此参数，则默认暂停或恢复指定坐席在全部队列中的服务。
队列的唯一 ID，用于指定要暂停或恢复坐席在哪些队列中的服务。
注：
  • 使用半角逗号 , 分隔多个队列 ID。
operation 是 String 暂停或恢复该坐席在指定队列中的服务。
取值范围：
  • pause：暂停坐席服务。
  • unpause：恢复坐席服务。
max_threshold_for_pause_time 否 Integer 动态坐席暂停服务的时长 (单位：秒)。
取值范围：
  • 0：保持暂停状态直到有新的请求使坐席恢复服务。
  • 10 或更大值：指定暂停的时长。超时后，坐席自动恢复服务。
reason 否 String 暂停原因特征码。
取值范围：PBX 中已有暂停原因的特征码 。
注：
  • 如果 PBX 未订阅 呼叫中心 服务，请勿传入此参数，否则会导致请求失败。
  • 可使用 查询暂停原因列表 接口查询暂停原因的特征码。

响应参数

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

示例

请求示例

暂停坐席 (分机 ID：85) 在全部队列中的队列服务，暂停原因为 “Lunch” (特征码：*01)。

GET /openapi/v1.0/agent/pause?access_token=7TBj7xavDnMljNQXb8bVAxUgNrxE7u1r&ext_id=85&operation=pause&reason=*01 HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS"
}