1 彈屏原理說明

    深海捷呼叫中心系統(tǒng)的彈屏是基于事件驅(qū)動的，當有電話呼入或者呼出的時候呼叫中心的服務(wù)器會產(chǎn)生一個彈屏的消息，客戶端通過socket連接上呼叫中心的服務(wù)器之后，注冊彈屏事件，當服務(wù)器產(chǎn)生彈屏消息時會主動推送到客戶端。深海捷第三方開發(fā)手冊的“電話彈屏”接口已經(jīng)封裝了對彈屏消息的處理，對接方只需加載彈屏的接口地址，并傳入對應(yīng)的參數(shù)，即可觸發(fā)彈屏。

    根據(jù)傳入的pop_type參數(shù)可以控制是在電話開始振鈴（RING）的時候開始彈屏，還是在電話接通（LINK）之后彈屏。另外根據(jù)傳入的open_type參數(shù)可以控制是直接打開一個新窗口（當open_type為1時），還是觸發(fā)JS函數(shù)（當open_type為2時）。彈屏中其他的參數(shù)請參考3.1.2.

2 彈屏調(diào)用說明

功能描述：第三方系統(tǒng)加載彈屏接口后，當指定的分機通話(或振鈴)時，系統(tǒng)將自動彈屏或進行JS回調(diào)。

接口地址：http://www.mixcall.cn/admin/?m=interface&c=api&a=popscreen

調(diào)用方式：加載JS方式，需要jQuery支持，jQuery版本不得低于1.3.2。

接口參數(shù)：

u  extension：分機號碼，指定要彈屏的分機號碼，必填。如果想監(jiān)聽多個分機彈屏事件，多個分機之間使用英文逗號分隔，如果想監(jiān)聽所有分機彈屏事件，參數(shù)值設(shè)置為all即可。

u  pop_url：彈屏地址，如果沒有傳遞該參數(shù)，則使用接口配置頁面設(shè)置的彈屏地址。

u  pop_type：彈屏時機，如果沒有傳遞該參數(shù)，則使用接口配置頁面設(shè)置的參數(shù)，有效值為RING(振鈴時彈屏)、LINK(接通時彈屏)。

u  pop_out：呼入彈屏還是呼出彈屏，如果沒有傳遞該參數(shù)，則使用接口配置頁面設(shè)置的參數(shù)，有效值為ALL(呼入呼出都彈屏)、DialIn(僅呼入彈屏)、DialOut(僅呼出彈屏)。

u  open_type：彈屏方式，如果沒有傳遞該參數(shù)，則使用接口配置頁面設(shè)置的參數(shù)，有效值為1(彈出新窗口)、2(注冊JS回調(diào)函數(shù))。

u  mixcallback：JS回調(diào)函數(shù)名，如果沒有傳遞該參數(shù)，則使用接口配置頁面設(shè)置的參數(shù)，只有當彈屏方式為注冊JS回調(diào)函數(shù)時才有效。彈屏時，彈信息字符串(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)將作為參數(shù)傳遞給JS回調(diào)函數(shù)。

u  返回值：彈屏或JS回調(diào)，參數(shù)說明如下：

?  Callerid：主叫號碼

?  Calleeid：被叫號碼

?  RecordFile：本次通話的錄音文件名

?  Uniqueid：唯一標識，是一個流水號

?  DateTime：日期時間

?  Method：呼入還是呼出，Dialout為呼出，Dialin為呼入

?  CID：出局CID號碼，呼出彈屏具備此參數(shù)

?  DID：被叫號碼，即公司的外線號碼，呼入彈屏時具備此參數(shù)

3 彈屏接口演示頁面

呼叫中心提供彈屏演示頁面，該演示界面是彈屏接口調(diào)用的實例，彈屏演示界面的參數(shù)是通過接口配置頁面進行配置的，實現(xiàn)的效果與向彈屏接口傳遞參數(shù)時一致。

彈屏演示界面，測試彈屏時extension參數(shù)是必需的：

4 轉(zhuǎn)接彈屏參數(shù)說明

備注：座席系統(tǒng)D18以上版本、座席系統(tǒng)后臺管理中心D23以上版本適用。

當轉(zhuǎn)接的時候產(chǎn)生的彈屏消息中，主叫號碼Callerid和被叫號碼Calleeid均為呼叫中心內(nèi)部分機，此時在彈屏消息中增加了MixExtVar參數(shù)，該參數(shù)值包含外線客戶的手機號碼。MixExtVar的值由多個字段組成，每個字段用“|”連接，例如：MixExtVar: XFRCallerID=15323736837|AutocallCustomfield=42900419870301095X。其中XFRCallerID是轉(zhuǎn)接時的真實主叫號碼。

5彈屏中獲取主動外呼自定義字段說明

備注：座席系統(tǒng)D18以上版本、座席系統(tǒng)后臺管理中心D23以上版本適用。

自動外呼應(yīng)用到某些特殊的應(yīng)用場景的時候，除了需要將手機號碼在彈屏中顯示出來，可能還需要將當次呼叫的訂單號、客戶的身份證等信息在彈屏中顯示出來。在向主動外呼任務(wù)中添加數(shù)據(jù)時指定自定義字段參數(shù)（座席系統(tǒng)D18以上版本具備該選項），此時在彈屏消息中增加了MixExtVar參數(shù)，該參數(shù)值將包含自定義字段的值。MixExtVar的值由多個字段組成，每個字段用“|”連接，例如：MixExtVar: XFRCallerID=15323736837|AutocallCustomfield=429004198703010950。其中AutocallCustomfield是彈屏自定字段的值。

6 彈屏參數(shù)配置

    在調(diào)用呼叫中心接口時，可以向接口傳遞參數(shù)，也可以在“接口參數(shù)配置頁面”直接配置彈屏參數(shù)，實現(xiàn)的效果是相同的，在實際調(diào)用接口的過程中，建議直接向接口傳遞參數(shù)，避免其他人為誤操作修改了彈屏參數(shù)造成系統(tǒng)彈屏功能異常。

主要參數(shù)說明如下：

u  彈屏時機：用于控制彈屏的時間點。振鈴時彈屏是指電話開始響鈴就觸發(fā)彈屏。接通時彈屏是指電話接通時觸發(fā)彈屏。

u  呼入彈屏：用于控制用戶呼入的時候是否需要彈屏。

u  呼出彈屏：用于控制座席呼出的時候是否需要彈屏。

u  彈屏方式：是指呼叫中心產(chǎn)生彈屏事件之后，是如何觸發(fā)彈屏的。彈出新窗口是在新的窗口中打開彈屏頁面。注冊JS回調(diào)函數(shù)是指觸發(fā)一個JS函數(shù)，函數(shù)名稱可以在界面配置，函數(shù)體可以自定義。

u  彈屏地址：當彈屏方式為“彈出新窗口”時有效。

u  js回調(diào)函數(shù)：當彈屏方式為“注冊JS回調(diào)函數(shù)”時有效。

接口參數(shù)配置頁面如下：

       關(guān)于深海捷（singhead）

       深圳市深海捷科技有限公司是一家專注15年的智能通訊服務(wù)商，為企業(yè)提供一體化通訊方案，產(chǎn)品包含：客服呼叫中心、智能語音機器人、在線客服系統(tǒng)、云通訊（號碼隱私保護、一鍵呼叫、語音SDK），已提供呼叫中心系統(tǒng)服務(wù)坐席超過50000+，客戶超過3000+的呼叫中心系統(tǒng)方案，專業(yè)提供政府、地產(chǎn)、醫(yī)療、保險、金融、互聯(lián)網(wǎng)、教育等行業(yè)呼叫中心解決方案。

       咨詢熱線：400-700-2505