>[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"
},
{
.......
.......
.......
}
]
}
```
* **效果圖**
僅供參考

