1 彈屏原理說明
深海捷呼叫(jiào)中心系統的彈屏是基于事(shì)件驅動的，當有電話呼入或者呼出的時候呼叫(jiào)中心的服務器會(huì)産生一個彈屏的消息，客戶端通過(guò)socket連接上呼叫(jiào)中心的服務器之後(hòu)，注冊彈屏事(shì)件，當服務器産生彈屏消息時會(huì)主動推送到客戶端。深海捷第三方開(kāi)發(fā)手冊的“電話彈屏”接口已經(jīng)封裝了對(duì)彈屏消息的處理，對(duì)接方隻需加載彈屏的接口地址，并傳入對(duì)應的參數，即可觸發(fā)彈屏。
根據傳入的pop_type參數可以控制是在電話開(kāi)始振鈴（RING）的時候開(kāi)始彈屏，還(hái)是在電話接通（LINK）之後(hòu)彈屏。另外根據傳入的open_type參數可以控制是直接打開(kāi)一個新窗口（當open_type爲1時），還(hái)是觸發(fā)JS函數（當open_type爲2時）。彈屏中其他的參數請參考3.1.2.
2 彈屏調用說明
功能(néng)描述：第三方系統加載彈屏接口後(hòu)，當指定的分機通話(或振鈴)時，系統將(jiāng)自動彈屏或進(jìn)行JS回調。
接口地址：http://www.mixcall.cn/admin/?m=interface&c=api&a=popscreen
調用方式：加載JS方式，需要jQuery支持，jQuery版本不得低于1.3.2。
接口參數：
u extension：分機号碼，指定要彈屏的分機号碼，必填。如果想監聽多個分機彈屏事(shì)件，多個分機之間使用英文逗号分隔，如果想監聽所有分機彈屏事(shì)件，參數值設置爲all即可。
u pop_url：彈屏地址，如果沒(méi)有傳遞該參數，則使用接口配置頁面(miàn)設置的彈屏地址。
u pop_type：彈屏時機，如果沒(méi)有傳遞該參數，則使用接口配置頁面(miàn)設置的參數，有效值爲RING(振鈴時彈屏)、LINK(接通時彈屏)。
u pop_out：呼入彈屏還(hái)是呼出彈屏，如果沒(méi)有傳遞該參數，則使用接口配置頁面(miàn)設置的參數，有效值爲ALL(呼入呼出都(dōu)彈屏)、DialIn(僅呼入彈屏)、DialOut(僅呼出彈屏)。
u open_type：彈屏方式，如果沒(méi)有傳遞該參數，則使用接口配置頁面(miàn)設置的參數，有效值爲1(彈出新窗口)、2(注冊JS回調函數)。
u mixcallback：JS回調函數名，如果沒(méi)有傳遞該參數，則使用接口配置頁面(miàn)設置的參數，隻有當彈屏方式爲注冊JS回調函數時才有效。彈屏時，彈信息字符串(Event=Popscreen&Poptime=Link&Callerid=7205&CallerIDName=&CID=61865551&Calleeid=15602963704&CalleeIDName=&Recordfile=OUT7205-15602963704-20140507-092849-1399426129.14295.WAV&Uniqueid=1399426129.14295&DateTime=2014-05-07
09:28:58&Server=localhost&Method=Dialout)將(jiāng)作爲參數傳遞給JS回調函數。
u 返回值：彈屏或JS回調，參數說明如下：
Ø Callerid：主叫(jiào)号碼
Ø Calleeid：被(bèi)叫(jiào)号碼
Ø RecordFile：本次通話的錄音文件名
Ø Uniqueid：唯一标識，是一個流水号
Ø DateTime：日期時間
Ø Method：呼入還(hái)是呼出，Dialout爲呼出，Dialin爲呼入
Ø CID：出局CID号碼，呼出彈屏具備此參數
Ø DID：被(bèi)叫(jiào)号碼，即公司的外線号碼，呼入彈屏時具備此參數
3 彈屏接口演示頁面(miàn)
呼叫(jiào)中心提供彈屏演示頁面(miàn)，該演示界面(miàn)是彈屏接口調用的實例，彈屏演示界面(miàn)的參數是通過(guò)接口配置頁面(miàn)進(jìn)行配置的，實現的效果與向(xiàng)彈屏接口傳遞參數時一緻。
彈屏演示界面(miàn)，測試彈屏時extension參數是必需的：
4 轉接彈屏參數說明
備注：座席系統D18以上版本、座席系統後(hòu)台管理中心D23以上版本适用。
當轉接的時候産生的彈屏消息中，主叫(jiào)号碼Callerid和被(bèi)叫(jiào)号碼Calleeid均爲呼叫(jiào)中心内部分機，此時在彈屏消息中增加了MixExtVar參數，該參數值包含外線客戶的手機号碼。MixExtVar的值由多個字段組成(chéng)，每個字段用“|”連接，例如：MixExtVar:
XFRCallerID=15323736837|AutocallCustomfield=42900419870301095X。其中XFRCallerID是轉接時的真實主叫(jiào)号碼。
5彈屏中獲取主動外呼自定義字段說明
備注：座席系統D18以上版本、座席系統後(hòu)台管理中心D23以上版本适用。
自動外呼應用到某些特殊的應用場景的時候，除了需要將(jiāng)手機号碼在彈屏中顯示出來，可能(néng)還(hái)需要將(jiāng)當次呼叫(jiào)的訂單号、客戶的身份證等信息在彈屏中顯示出來。在向(xiàng)主動外呼任務中添加數據時指定自定義字段參數（座席系統D18以上版本具備該選項），此時在彈屏消息中增加了MixExtVar參數，該參數值將(jiāng)包含自定義字段的值。MixExtVar的值由多個字段組成(chéng)，每個字段用“|”連接，例如：MixExtVar:
XFRCallerID=15323736837|AutocallCustomfield=429004198703010950。其中AutocallCustomfield是彈屏自定字段的值。
6 彈屏參數配置
在調用呼叫(jiào)中心接口時，可以向(xiàng)接口傳遞參數，也可以在“接口參數配置頁面(miàn)”直接配置彈屏參數，實現的效果是相同的，在實際調用接口的過(guò)程中，建議直接向(xiàng)接口傳遞參數，避免其他人爲誤操作修改了彈屏參數造成(chéng)系統彈屏功能(néng)異常。
主要參數說明如下：
u 彈屏時機：用于控制彈屏的時間點。振鈴時彈屏是指電話開(kāi)始響鈴就(jiù)觸發(fā)彈屏。接通時彈屏是指電話接通時觸發(fā)彈屏。
u 呼入彈屏：用于控制用戶呼入的時候是否需要彈屏。
u 呼出彈屏：用于控制座席呼出的時候是否需要彈屏。
u 彈屏地址：當彈屏方式爲“彈出新窗口”時有效。
u js回調函數：當彈屏方式爲“注冊JS回調函數”時有效。
接口參數配置頁面(miàn)如下：
關于深海捷（singhead）
深圳市你我他網絡信息技術有限公司是一家專注15年的智能(néng)通訊服務商，爲企業提供一體化通訊方案，産品包含：客服呼叫(jiào)中心、智能(néng)語音機器人、在線客服系統、雲通訊（号碼隐私保護、一鍵呼叫(jiào)、語音SDK），已提供呼叫(jiào)中心系統服務坐席超過(guò)50000+，客戶超過(guò)3000+的呼叫(jiào)中心系統方案，專業提供政府、地産、醫療、保險、金融、互聯網、教育等行業呼叫(jiào)中心解決方案。
咨詢熱線：400-700-2505
