CTI客户端接口说明.docVIP

CTI客户端接口说明 一、概述 本接口适用于采用B/S架构的业务系统。CTI客户端以框架的形式提供，在框架中嵌入了IE浏览器窗口，用于打开业务系统。 下图为CTI客户端框架的截图，程序分为以下几个部分： 需设计 工具条：登录、注销、离席、入席、转接、呼叫等CTI功能 主窗口：可用TAB方式打开多个预先设置的网址提供接口（CRM系统自主开发） CTI状态窗口：显示当前呼叫信息 弹屏窗口：当有新的呼叫进来时，可显示在电话的等待序列中 主窗口和弹屏窗口的网址可通过配置程序设置，而且它们之间共享Cookie信息，也就是如果在主窗口中登录后用Cookie验证用户信息，弹屏窗口会传递同样的Cookie到服务器，不会出现未登录的提示。 二、统一登录 通常情况，业务系统需要用户验证，而CTI系统在席位入席时也需要用户验证，为了避免出现两次登录的情况，CTI客户端系统提供了统一登录功能。统一登录有两种方式： CTI系统入席登录后自动打开业务系统的URL，在URL中附带用户信息，业务系统根据URL中的用户信息进行验证。例如：在呼叫中心客户端设置首页面URL为： HYPERLINK / /，当客户端登录成功时，客户端主窗口将自动打开首页面URL，并在URL后增加参数： HYPERLINK /?agentid=1user=101password=3B4D5C6D7E8F9A3B4D5C6D7E8F9 /?agentid=1user=101password=3B4D5C6D7E8F9A3B4D5C6D7E8F9 业务系统登录成功后，先重定向到一个特殊的URL，该URL的格式如下： http://localhost:180/cgi-bin/login.cgi?user=101pass=3B4D5C6D7E8F9A3B4D5C6D7E8F9url=http:%3F%3F%3Fmain 该URL是CTI席位端框架内嵌的Web服务器的URL，此URL仅能在本机访问。席位端根据URL后的参数进行用户认证，并实现CTI系统的入席登录，登录成功后主窗口页面自动调回url参数中的页面。 三、弹屏 在CTI客户端的选项设置中，具体方法是点工具条最后一个图标，输入管理密码后将出现下面的窗口： 主页地址：这是在CTI客户端的主窗口中打开的地址。在没有登录前，直接访问此地址；登录成功后在此地址后增加两个参数，一个是工号user，另一个是sid，用于用户验证，业务软件应该记录sid，如：user=001sid=3B4D5C6D7E8F9A3B4D5C6D7E8F9 振铃时弹屏地址：这是当席位话机振铃时由CTI客户端程序访问的地址，页面是在弹出窗口中显示的，窗口大小可设置。也可以设置为在隐藏窗口中运行。这个地址一般用来记录呼叫日志。访问此地址时，有几个与呼叫相关的参数，如： origin=1callid=20091128101010001number=1234567890callerid=1234567890calledid=801groupid=1agentid=1empid=001sid=3B4D5C6D7E8F9A3B4D5C6D7E8F9 origin - 呼叫方向 1-呼入 2-呼出 called - 呼叫ID number - 客户电话号码 callerid - 主叫号码 calledid - 被叫号码 groupid - 席位组 agentid – 席位代号 empid - 工号 sid - SessionID，和登录成功是返回的sid一致。 摘机时弹屏地址：这是当席位话机摘机接听来电时由CTI客户端程序访问的地址，页面是在弹出窗口中显示的，窗口大小可设置。也可以设置为在隐藏窗口中运行。这个地址一般用来进行业务受理。访问此地址时的参数和上面一样。 挂机时弹屏地址：这是当席位话机结束通话挂机时由CTI客户端程序访问的地址，页面是在弹出窗口中显示的，窗口大小可设置。也可以设置为在隐藏窗口中运行。这个地址一般用来记录呼叫日志。访问此地址时的参数和上面一样。 四、接口 在业务受理系统中，通过嵌入、访问席位端提供的URL，实现外拨、转接电话。 1、外拨 在业务系统中嵌入URL： a href= HYPERLINK http://localhost:180/cgi-bin/call.cgi? number=123456789 http://localhost:180/cgi-bin/call.cgi? number=123456789” target=”_blank”呼叫a 点击上面的连接实现呼叫一个外部的电话，如果呼叫成功，弹出的窗口自动关闭，如果有错误，则显示错误信息。也可以在上面的连接中增加一个参数: url=，表示呼叫成功页面转到该URL，一般是呼出