## 來電彈屏
>[info]**功能說明:**
> 電話分配座席后，座席在接聽前，座席電腦上應該會自動彈出本次電話的來電信息，一般會包含有：主叫號碼，主叫號碼歸屬地，主叫用戶信息（姓名，地址，歷史來電記錄，歷史溝通記錄等等）。
> 通過該接口即可實現座席電話振鈴同時座席電腦上自動彈出來電信息
> 該接口一般適用于客服場景（外呼或者電銷一般不使用彈屏，外呼或電銷可以參考“座席外呼”接口）
### **方式一：ajax輪詢刷座狀態**
業務系統不停的向呼叫中心服務器發送請求，服務器返回座席狀態，但請求速度不能高于1000毫秒(1秒)；
* **請求地址**
```
{base_url}/{api_version}/getAgentStatus
```
* **請求參數**
| 參數 | 是否必選 | 類型 | 描述 |
| --- | --- | --- | --- |
| ext | 是 | string | 座席的分機號碼 |
* **響應參數**
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| status | string | 請求結果：success：成功。failed：失敗。|
| msg | string | 如果返回failed，對失敗原因的描述。|
| data對象 | json | 返回ext對應的座席的狀態。|
| data.agentNum | string | 座席工號，“簽入”接口中所傳的值。也可用于判斷座席是否簽入，如果為空則未簽入。|
| data.agentName | string | 座席姓名，“簽入”接口中所傳的值。|
| data.agentGroup | string | 座席工作組，“簽入”接口中所傳的值。|
| data.status | string | 座席狀態，系統有：簽入，簽出，空閑，分機未注冊，呼入，呼出，話后，置忙。其他狀態是由“座席置忙”API接口傳的值，如：小休，就餐，培訓，等等。|
| data.callid | string | 本次通話的唯一ID。|
| data.phone | string | 與座席通話的外線號碼。|
| data.callee | string | 被叫號碼，只有呼入才會有值。比如呼叫中心系統有多條個外線號碼，表示主叫撥打的是哪一個號碼 |
| data.calleeQueue | string | 被叫的隊列(組)號碼，只有呼入才會有值，如果在“簽入”接口中，座席同時簽入了多個隊列，該值表示本次接聽的號碼是哪一個隊列分配給座席的電話。|
| data.direction | string | 本次通話的呼叫方向，值：inbound，outbound，（來電彈屏一般是呼入才彈屏，呼出不 彈屏）。|
| data.icon | string | 座席狀態圖標，值：1，2，3 座席客戶端。座席客戶端界面狀態圖標顯示，一般3個顏色，1灰；2綠；3紅；1灰表示座席沒簽入系統；2綠表示隊列會給座席分配電話（空閑是綠）；3紅表示隊列不會給座席分配電話（簽入，置忙，通話，話后都是紅），該字段僅供參考，開發人員也可以根據座席狀態顯示業務上需要的狀態圖標。|
* **響應示例**
```
{
"status": "success",
"data": {
"agentNum":"1001",
"agentName":"Linda",
"agentGroup":"6700,6701",
"status":"空閑",
......
......
}
}
```
