## 座席監控
>[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
}, {
......
......
......
}]
}
```
* **效果圖**
僅供參考
