## 座席弹屏
>[info] **功能说明**
> 1:座席弹屏页面由甲方的业务系统提供,CTI平台在使用iframe的方式嵌入弹屏页面,该方案的优点是既保证数据安全,又在业务发生变化时甲方自己就可以完成,不需要CTI平台做任何调整;
>:2:CTI平台在打开业务系统时,会传所需产生,业务系统可以根据参数弹出被叫详细信息;
> 3:业务系统应具备座席直接提交表单的功能,即座席直接在弹出页面录入信息,直接提交即可,如沟通记录,承诺还款日期,等等;
* **请求地址**
```
甲方提供弹屏的URL地址
```
* **请求参数**
```
CTI带上参数直接在iframe中显示弹屏页面的内容,所以参数都是以get的方式传参。在“获取外呼数据”接口中获取到的data对象参数,会自动加"data_",如下
获取外呼数据得到的数据如果为:
{
"status": "success",
"phone": "13590688803",
"msg": "",
"callbackDomain": "http://www.baidu.com",
"data": {
"CID": "260997",
"UID": "153769"
}
}
iframe中的url则为:
http://url?data_CID=260997&data_UID=153769&agent_num=1001&agent_id=123&token=d4vwi0ckp8fm8itlqbjlw98f95jqu96s&group_id=queue001&ext=8001&phone=13590688803&type=outbound&callid=49b98696-2451-437f-b1bd-abf29a6f8302
```
| 参数 | 是否必选 | 类型 | 描述 |
| --- | --- | --- | --- |
| agentNum | 是 | string | 座席工号,即座席在登录时输入的用户名。 |
| agentId | 否 | string | “座席登录”接口中返回的agentId。 |
| token | 否 | string | “座席登录”接口中返回的token。 |
| groupNum | 是 | string | 本次通话的被叫的组,是“获取外呼数据”接口中请求的“groupNum”,注意这不是座席的groupNum,因为座席有可能属于多个组(见座席登录)。当然如果一个座席只属于一个组,那么这里也可以作为座席的groupNum。 |
| ext | 是 | string | 座席通话的分机号码。 |
| phone | 是 | string | 本次通话的被叫号码。 |
| type | 是 | string | 呼叫方向,即呼入还是呼出(inbound/outbound)。 |
| callid | 是 | string | 本次呼叫的唯一编号,如果业务系统记录后可以根据calldi查询话单或者播放录音,见“高级接口”中的“话单查询”,“播放录音”。 |
* **响应参数**
直接返回html代码,CTI系统会在iframe中显示弹屏页面
* **弹屏页面**
>[warning] 仅供参考系统架构,弹屏页面需要根据业务需求编写。
![](https://img.kancloud.cn/14/56/14562ae56672d2798c9a354d41ae581e_1318x664.png)