2024年4月6日发(作者：)

CTI接口协议

篇一：CTI客户端接口说明

CTI 客户端接口说明一、概述 本接口适用于采用 B/S 架构的

业务系统。CTI 客户端以框架的形式提供，在框架中嵌入了

IE 浏览 器窗口，用于打开业务系统。 下图为 CTI 客户端框

架的截图，程序分为以下几个部分： 需设计 ? ? ? 工具条：

登录、注销、离席、入席、转接、呼叫等 CTI 功能 主窗口：

可用 TAB 方式打开多个预先设置的网址提供接口（CRM 系统

自主开发） CTI 状态窗口：显示当前呼叫信息 ? 弹屏窗口：

当有新的呼叫进来时，可显示在电话的等待序列中主窗口和弹

屏窗口的网址可通过配置程序设置，而且它们之间共享

Cookie 信息，也就是如果在主 窗口中登录后用 Cookie 验证

用户信息，弹屏窗口会传递同样的 Cookie 到服务器，不会出

现未登录的 提示。 二、统一登录 通常情况，业务系统需要

用户验证，而 CTI 系统在席位入席时也需要用户验证，为了

避免出现两 次登录的情况，CTI 客户端系统提供了统一登录

功能。统一登录有两种方式： 1、 CTI 系统入席登录后自动

打开业务系统的 URL， URL 中附带用户信息， 在 业务系统

根据 URL 中 的 用 户 信 息 进 行 验 证 。 例 如 ： 在

呼 叫 中 心 客 户 端 设 置 首 页 面 URL 为 ： /，当客

户端登录成功时，客户端主窗口将自动打开首页面 URL， 并

在 URL 后增加参数：

/?agentid=1&user=101&password=3B4D5C6D7E8F9A3B4D5C

6D7E8F9 2、 业务系统登录成功后，先重定向到一个特殊的

URL，该 URL 的格式如下： ; url=:%3F%3F%3Fmain 该 URL

是 CTI 席位端框架内嵌的 Web 服务器的 URL，此 URL 仅能

在本机访问。席位端 根据 URL 后的参数进行用户认证，并实

现 CTI 系统的入席登录，登录成功后主窗口页面自动 调回

url 参数中的页面。 三、弹屏 在 CTI 客户端的选项设置

中，具体方法是点工具条最后一个图标 面的窗口： ，输入管

理密码后将出现下

1、 主页地址：这是在 CTI 客户端的主窗口中打开的地址。

在没有登录前，直接访问此地址；登录成 功后在此地址后增

加两个参数，一个是工号 user，另一个是 sid，用于用户验

证，业务软件应该记 录 sid，如：

user=001&sid=3B4D5C6D7E8F9A3B4D5C6D7E8F9 2、 振铃时弹

屏地址：这是当席位话机振铃时由 CTI 客户端程序访问的地

址，页面是在弹出窗口中显 示的，窗口大小可设置。也可以

设置为在隐藏窗口中运行。这个地址一般用来记录呼叫日志。

访 问此地址时，有几个与呼叫相关的参数，如：

origin=1&&callid=&number=&callerid=&calledid=801&

gro(转 载 于: 小 龙文 档 网:cti接口协

议)upid=1&agentid=1&empid=001&sid=3B4D5C6D7E8F9A3B4D5C

6D7E8F9 origin - 呼叫方向 called - 呼叫 ID number - 客

户电话号码 callerid - 主叫号码 calledid - 被叫号码

groupid - 席位组 agentid – 席位代号 empid - 工号 sid

- SessionID，和登录成功是返回的 sid 一致。 3、 摘机时

弹屏地址：这是当席位话机摘机接听来电时由 CTI 客户端程

序访问的地址，页面是在弹出 窗口中显示的，窗口大小可设

置。也可以设置为在隐藏窗口中运行。这个地址一般用来进行

业务 受理。访问此地址时的参数和上面一样。 4、 挂机时弹

屏地址：这是当席位话机结束通话挂机时由 CTI 客户端程序

访问的地址，页面是在弹出 窗口中显示的，窗口大小可设

置。也可以设置为在隐藏窗口中运行。这个地址一般用来记录

呼叫 日志。访问此地址时的参数和上面一样。 四、接口 在

业务受理系统中，通过嵌入、访问席位端提供的 URL，实现外

拨、转接电话。 1-呼入 2-呼出