>[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"
},
{
.......
.......
.......
}
]
}
```
* **效果图**
仅供参考
## 座席监控
