## 来电弹屏
>[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":"空闲",
......
......
}
}
```
