## 座席彈屏
>[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] 僅供參考系統架構,彈屏頁面需要根據業務需求編寫。
