1 彈屏原理說(shuō)明

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

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

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

功能描述：第三方系統(tǒng)加載彈屏接口后，當(dāng)指定的分機(jī)通話(或振鈴)時(shí)，系統(tǒng)將自動(dòng)彈屏或進(jìn)行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：分機(jī)號(hào)碼，指定要彈屏的分機(jī)號(hào)碼，必填。如果想監(jiān)聽(tīng)多個(gè)分機(jī)彈屏事件，多個(gè)分機(jī)之間使用英文逗號(hào)分隔，如果想監(jiān)聽(tīng)所有分機(jī)彈屏事件，參數(shù)值設(shè)置為all即可。

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

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

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

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

u  mixcallback：JS回調(diào)函數(shù)名，如果沒(méi)有傳遞該參數(shù)，則使用接口配置頁(yè)面設(shè)置的參數(shù)，只有當(dāng)彈屏方式為注冊(cè)JS回調(diào)函數(shù)時(shí)才有效。彈屏?xí)r，彈信息字符串(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ù)說(shuō)明如下：

?  Callerid：主叫號(hào)碼

?  Calleeid：被叫號(hào)碼

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

?  Uniqueid：唯一標(biāo)識(shí)，是一個(gè)流水號(hào)

?  DateTime：日期時(shí)間

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

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

?  DID：被叫號(hào)碼，即公司的外線號(hào)碼，呼入彈屏?xí)r具備此參數(shù)

3 彈屏接口演示頁(yè)面

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

彈屏演示界面，測(cè)試彈屏?xí)rextension參數(shù)是必需的：

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

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

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

5彈屏中獲取主動(dòng)外呼自定義字段說(shuō)明

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

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

6 彈屏參數(shù)配置

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

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

u  彈屏?xí)r機(jī)：用于控制彈屏的時(shí)間點(diǎn)。振鈴時(shí)彈屏是指電話開(kāi)始響鈴就觸發(fā)彈屏。接通時(shí)彈屏是指電話接通時(shí)觸發(fā)彈屏。

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

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

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

u  彈屏地址：當(dāng)彈屏方式為“彈出新窗口”時(shí)有效。

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

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

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

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

       咨詢熱線：400-700-2505