>[info]**功能说明:**
> 可以通过该接口实时获取分机的状态，业务系统可以根据该接口以图形化的形式展示分机状态，也可以配合，监听，挂断等接口对座席进行操作。
> 该接口在业务系统中建议具有一定权限的座席才可以使用，如班长，管理员等
> 该接口与“座席监控”接口的区别是：该接口返回所有分机数据，而“座席监控”接口只返回在线座席的数据。
### **ajax轮询刷座状态**
业务系统不停的向呼叫中心服务器发送请求，服务器返回分机状态，但请求速度不能高于1000毫秒；
* **请求地址**
```
{base_url}/{api_version}/monitorAgent
```
* **请求参数**
| 参数 | 是否必选 | 类型 | 描述 |
| --- | --- | --- | --- |
| groupNum | 否 | string | 座席的工作组编号 |
* **响应参数**
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| status | string | 请求结果：success：成功。failed：失败。|
| serverTime | int | 当前服务器系统时间戳，如果需要计算通话时长，使用服务器时间戳减分机开始通话时间戳。|
| data对象 | json | 分机的信息。|
| data.EXT | string | 分机号码。|
| data.EXT_REG_STATUS | string | 分机注册状态，注册成功：registered，注册失败：unregister、unregistered。|
| data.EXT_STATUS | string | 分机通话状态；busy表示在通话中，其他值为未通话。|
| data.DIRECTION | string | 呼叫方向；呼入：inbound，呼出：outbound。|
| data.PHONE | string | 当前与分机通话的号码（data.EXT_STATUS=busy时才有效）。|
| data.AGENT_NUM | string | 当前分机所绑定的座席工号（即“座席签入”接口中签入的座席工号）。|
| data.AGENT_NAME | string | 当前分机所绑定的座席姓名（即“座席签入”接口中签入的座席姓名）。|
| data.AGENT_STATUS | string | 当前分机所绑定的座席的状态；0分机未绑定座席；1座席空闲；9座席置忙（置忙是座席通过“座席置忙”接口进行的置忙操作）。|
| data.AGENT_DND_REASON | string | 如果座席是置忙状态，座席置忙的原因，如小休，就餐，培训等等；（座席置忙的原因是座席通过“座席置忙”接口进行的置忙操作）。|
| data.GROUP_NUM | string | 座席工作组（工作组是座席通过“座席签入”时绑定的） 。|
| data.IP | string | 分机话机的IP地址 。|
| data.EXT_BUSY_TIME | string | 分机通话的开始时间戳，如果需要计算通话时长，使用服务器时间戳减分机开始通话时间戳 。|
* **响应示例**
```
{
"status": "success",
"serverTime": 1612932055,
"data": [{
"EXT": "8000",
"EXT_REG_STATUS": "registered",
"EXT_STATUS": "idle",
"DIRECTION": "",
"PHONE": "",
"AGENT_NUM": "",
"AGENT_NAME": "",
"AGENT_STATUS": 0,
"AGENT_DND_REASON": "",
"GROUP_NUM": "6700",
"IP": "192.168.1.106:54017",
"EXT_BUSY_TIME": 1612092382
}, {
"EXT": "8001",
"EXT_REG_STATUS": "registered",
"EXT_STATUS": "idle",
"DIRECTION": "",
"PHONE": "",
"AGENT_NUM": "1001",
"AGENT_NAME": "范冰冰",
"AGENT_STATUS": 1,
"AGENT_DND_REASON": "",
"GROUP_NUM": "6700",
"IP": "192.168.1.107:53365",
"EXT_BUSY_TIME": 1612929530
}, {
"EXT": "8002",
"EXT_REG_STATUS": "unregistered",
"EXT_STATUS": "idle",
"DIRECTION": "",
"PHONE": "",
"AGENT_NUM": "",
"AGENT_NAME": "",
"AGENT_STATUS": 0,
"AGENT_DND_REASON": "",
"GROUP_NUM": "",
"IP": "",
"EXT_BUSY_TIME": 1598804167
}, {
......
......
......
}]
}
```
* **效果图**
仅供参考
