## 座席监控 >[info]**功能说明:** > 可以通过该接口实时获取座席状态，业务系统可以以图形化形式展示座席状态，也可以配合签入，签出，监听，挂断等接口对座席进行操作。 > 该接口在业务系统中建议具有一定权限的座席才可以使用，如班长，管理员等 > 该接口与“分机监控”接口的区别是：该接口只返回所有在线的座席的数据，而“分机监控”接口返回所有的分机的数据 ### **ajax轮询刷座状态** 业务系统不停的向呼叫中心服务器发送请求，服务器返回座席状态，但请求速度不能高于1000毫秒； * **请求地址** ``` {base_url}/{api_version}/monitorAgent ``` * **请求参数** | 参数 | 是否必选 | 类型 | 描述 | | --- | --- | --- | --- | | groupNum | 否 | string | 座席的工作组编号 | * **响应参数** | 参数 | 类型 | 描述 | | --- | --- | --- | | status | string | 请求结果：success：成功。failed：失败。| | busy | int | 当前通话的座席数量。| | idle | int | 当前空闲的座数量(等待接听电话的座席)。| | dnd | int | 当前置忙的座席数量。| | data对象 | json | 返回ext对应的座席的状态。| | data.ext | string | 座席的分机号码。| | data.groupNum | string | 座席工作组，“签入”接口中所传的值。| | data.agentName | string | 座席姓名，“签入”接口中所传的值。| | data.status | string | 座席状态，系统有：签入，签出，空闲，分机未注册，通话，话后，置忙。其他状态是由“座席置忙”API接口传的值，如：小休，就餐，培训，等等。| | data.time | string | 当前状态持续的时长。| * **响应示例** ``` { "status": "success", "busy": 0, "idle": 1, "dnd": 0, "data": [ { "ext": "8001", "groupNum": "6700", "agentName": "范冰冰", "status": "空闲", "time": "23:41:46" }, { ....... ....... ....... } ] } ``` * **效果图** 仅供参考