1 弹屏原理说明

    深海捷呼叫中心系统的弹屏是基于事件驱动的，当有电话呼入或者呼出的时候呼叫中心的服务器会产生一个弹屏的消息，客户端通过socket连接上呼叫中心的服务器之后，注册弹屏事件，当服务器产生弹屏消息时会主动推送到客户端。深海捷第三方开发手册的“电话弹屏”接口已经封装了对弹屏消息的处理，对接方只需加载弹屏的接口地址，并传入对应的参数，即可触发弹屏。

    根据传入的pop_type参数可以控制是在电话开始振铃（RING）的时候开始弹屏，还是在电话接通（LINK）之后弹屏。另外根据传入的open_type参数可以控制是直接打开一个新窗口（当open_type为1时），还是触发JS函数（当open_type为2时）。弹屏中其他的参数请参考3.1.2.

2 弹屏调用说明

功能描述：第三方系统加载弹屏接口后，当指定的分机通话(或振铃)时，系统将自动弹屏或进行JS回调。

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

调用方式：加载JS方式，需要jQuery支持，jQuery版本不得低于1.3.2。

接口参数：

u  extension：分机号码，指定要弹屏的分机号码，必填。如果想监听多个分机弹屏事件，多个分机之间使用英文逗号分隔，如果想监听所有分机弹屏事件，参数值设置为all即可。

u  pop_url：弹屏地址，如果没有传递该参数，则使用接口配置页面设置的弹屏地址。

u  pop_type：弹屏时机，如果没有传递该参数，则使用接口配置页面设置的参数，有效值为RING(振铃时弹屏)、LINK(接通时弹屏)。

u  pop_out：呼入弹屏还是呼出弹屏，如果没有传递该参数，则使用接口配置页面设置的参数，有效值为ALL(呼入呼出都弹屏)、DialIn(仅呼入弹屏)、DialOut(仅呼出弹屏)。

u  open_type：弹屏方式，如果没有传递该参数，则使用接口配置页面设置的参数，有效值为1(弹出新窗口)、2(注册JS回调函数)。

u  mixcallback：JS回调函数名，如果没有传递该参数，则使用接口配置页面设置的参数，只有当弹屏方式为注册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)将作为参数传递给JS回调函数。

u  返回值：弹屏或JS回调，参数说明如下：

Ø  Callerid：主叫号码

Ø  Calleeid：被叫号码

Ø  RecordFile：本次通话的录音文件名

Ø  Uniqueid：唯一标识，是一个流水号

Ø  DateTime：日期时间

Ø  Method：呼入还是呼出，Dialout为呼出，Dialin为呼入

Ø  CID：出局CID号码，呼出弹屏具备此参数

Ø  DID：被叫号码，即公司的外线号码，呼入弹屏时具备此参数

3 弹屏接口演示页面

呼叫中心提供弹屏演示页面，该演示界面是弹屏接口调用的实例，弹屏演示界面的参数是通过接口配置页面进行配置的，实现的效果与向弹屏接口传递参数时一致。

弹屏演示界面，测试弹屏时extension参数是必需的：

4 转接弹屏参数说明

备注：座席系统D18以上版本、座席系统后台管理中心D23以上版本适用。

当转接的时候产生的弹屏消息中，主叫号码Callerid和被叫号码Calleeid均为呼叫中心内部分机，此时在弹屏消息中增加了MixExtVar参数，该参数值包含外线客户的手机号码。MixExtVar的值由多个字段组成，每个字段用“|”连接，例如：MixExtVar: XFRCallerID=15323736837|AutocallCustomfield=42900419870301095X。其中XFRCallerID是转接时的真实主叫号码。

5弹屏中获取主动外呼自定义字段说明

备注：座席系统D18以上版本、座席系统后台管理中心D23以上版本适用。

自动外呼应用到某些特殊的应用场景的时候，除了需要将手机号码在弹屏中显示出来，可能还需要将当次呼叫的订单号、客户的身份证等信息在弹屏中显示出来。在向主动外呼任务中添加数据时指定自定义字段参数（座席系统D18以上版本具备该选项），此时在弹屏消息中增加了MixExtVar参数，该参数值将包含自定义字段的值。MixExtVar的值由多个字段组成，每个字段用“|”连接，例如：MixExtVar: XFRCallerID=15323736837|AutocallCustomfield=429004198703010950。其中AutocallCustomfield是弹屏自定字段的值。

6 弹屏参数配置

    在调用呼叫中心接口时，可以向接口传递参数，也可以在“接口参数配置页面”直接配置弹屏参数，实现的效果是相同的，在实际调用接口的过程中，建议直接向接口传递参数，避免其他人为误操作修改了弹屏参数造成系统弹屏功能异常。

主要参数说明如下：

u  弹屏时机：用于控制弹屏的时间点。振铃时弹屏是指电话开始响铃就触发弹屏。接通时弹屏是指电话接通时触发弹屏。

u  呼入弹屏：用于控制用户呼入的时候是否需要弹屏。

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

u  弹屏方式：是指呼叫中心产生弹屏事件之后，是如何触发弹屏的。弹出新窗口是在新的窗口中打开弹屏页面。注册JS回调函数是指触发一个JS函数，函数名称可以在界面配置，函数体可以自定义。

u  弹屏地址：当弹屏方式为“弹出新窗口”时有效。

u  js回调函数：当弹屏方式为“注册JS回调函数”时有效。

接口参数配置页面如下：

       关于深海捷（singhead）

       深圳市深海捷科技有限公司是一家专注15年的智能通讯服务商，为企业提供一体化通讯方案，产品包含：客服呼叫中心、智能语音机器人、在线客服系统、云通讯（号码隐私保护、一键呼叫、语音SDK），已提供呼叫中心系统服务坐席超过50000+，客户超过3000+的呼叫中心系统方案，专业提供政府、地产、医疗、保险、金融、互联网、教育等行业呼叫中心解决方案。

       咨询热线：400-700-2505