坐席控件开发接口使用说明最新

呼叫中心坐席端控件(EasyAgc.ocx)使用说

明

为什么需要坐席端控件

在一个完整的呼叫中心系统中，坐席端软件是一个重要的组成部分。坐席人员通过坐席端软件与呼叫中心服务器（CCS）进行交互，完成对通讯设备的控制和相关信息的交换，如坐席的登录、注销、离席、复席、应答、呼出、转移等等动作，都是通过坐席端软件与CCS的通信完成的。一般来说，坐席端软件与CCS之间的通信是建立在TCP/IP的基础上的。具体的通信包格式可以自行定义。为了降低坐席端软件的开发难度和加快坐席端软件的开发速度，通行的做法是把坐席端软件分成通信模块与业务模块两部分。其中业务模块会随客户的需求变化而变化，一般都需要进行定制开发；而通信部分则相对变化较少，不论什么行业的呼叫中心，其坐席端软件一般都需要包括坐席的登录，注销，呼出，应答，挂断，转移等基本通信功能。因此有必要把坐席软件的通信模块进行封装，以OCX控件的方式提供给最终用户，最终用户不需要了解坐席端与CCS之间的通信包格式，也不必学习Socket通信的开发技术，只需访问OCX控件公布的方法和属性，对OCX控件公布的事件进行响应，就可以完成坐席端软件通信模块的开发。

坐席端控件支持的开发语言

北京同力信通软件公司坐席端控件符合Windows控件标准，理论上支持所有可以支持控件的开发语言，成功通过北京同力信通软件公司公司测试的语言包括：

Delphi 7.0

Visula Basic 6.0

Visual C++ 6.0

IE6.0-VBScript/Jscript

坐席端控件的接口

方法

tlaOpen

tlaClose

tlaLogin

tlaLogoff

tlaACW

tlaWCA

tlaOnhook tlaMakecall talTransfer tlaListen tlaStoplisten tlaPlay tlaStopplay tlaRecord tlaStoprecord tlaTransfertoivr tlaGetcallerid talGetcalleeid tlaGetuserdata tlaGettransferresult talGetcalloutresult tlaHold tlaUnhold

tlaCut tlaQueryworkid tlaQuerystate tlaQueryinfo tlaGetcall tlaIntrude

tlaKill tlaSetpriority tlaMute tlaUnmute tlaStoplog tlaStartlog tlaTransfertoivrEx tlaAnswerqueue tlaGetcrs

属性

无

事件

TLAECallin TLAEACW TLAELogoff

TLAECalloutresult TLAETransferresult TLAECallreleased TLAEAnswer TLAEHoldcallreleased TLAEInfo TLAEKeepcallreleased TLAEQueue TLAEQuitqueue

[1] long tlaOpen(BSTR strServerIP);

功能：连接服务器。

参数：服务器IP地址。

返回：0成功，非0失败。

备注：在调用控件的其他任何方法之前，必须先成功调用本方法。

[2] long tlaClose();

功能：关闭与服务器的连接。

参数：无。

返回：0成功非0失败。

备注：在程序退出前调用的最后一个方法。

[3] long tlaLogin(long nTelLineNo, long nWorkID, long nGroupID);

功能：登录。通知北京同力信通软件公司统一CTI平台程序有坐席登录，可以把电话呼叫分配到相应的坐席电话上。

参数：坐席电话线编号，坐席工号，坐席组号。

返回：0成功非0失败。

备注：除tlaOpen和tlaClose方法之外，所有其他方法都必须在本方法成功调用之后才能调用。

[4] long tlaLogoff();

功能：注销。通知北京同力信通软件公司统一CTI平台程序坐席注销，不要再向相应的坐席电话上分配电话呼叫。

参数：无。

返回：0成功，非0失败。

备注：无。

[5] long tlaACW();

功能：离席。在坐席人员需要临时离开工位时，调用本方法通知北京同力信通软件公司统一CTI平台程序有坐席临时离开，暂时不要把电话呼叫分配到相应的坐席电话上。

参数：无。

返回：0成功，非0失败。

备注：无。

[6] long tlaWCA();

功能：复席。在坐席人员回到工位时，调用本方法通知北京同力信通软件公司统一CTI平台程序坐席已经回来，可以把电话呼叫分配到相应的坐席电话上。

参数：无。

返回：0成功，非0失败。

备注：无。

[7] long tlaAnswer();

功能：应答分配过来的呼叫。

参数：无。

返回：0成功，非0失败。

备注：坐席人员也可以直接拿起坐席电话机手柄来应答，此时坐席控件会触发TLAEAnswer 事件。

[8] long tlaOnhook();

功能：挂机。

参数：无。

返回：0成功，非0失败。

备注：在坐席通话过程中调用本方法将结束通话。

[9] long tlaMakecall(long nCallMode, BSTR strCallee, BSTR strCaller, long nCOID);

功能：呼叫。既可以呼叫外线，也可以呼叫内线（其他坐席）

参数：nCallMode：呼叫模式1表示呼叫内线；2表示呼叫外线。

strCallee：被叫号码。如果是呼叫外线，此参数是被叫电话号码；如果是呼叫内线，此参数是被叫坐席工号。

strCaller：主叫号码。呼叫内线时被忽略。

nCOID：局向编号，在呼叫外线时有效，配合easytq.ini配置文件内容。此参数可以用0表示任意局向。

返回：0成功，非0失败。

备注：本方法是异步的，调用返回成功（0）表示已经成功开始外呼，真正的呼出结果要在收到TLAECalloutresult之后调用tlaGetcalloutresult得到。

[10] long tlaTransfer(long nTransMode, BSTR strCallee, BSTR strCaller, long nCOID);

功能：转移。

参数：nTransMode：转移模式1表示转移到内线（其他坐席）；2表示转移到外线。

strCallee：被叫号码。如果是转移到外线，此参数是被叫电话号码；如果是转移到内线，此参数是被叫坐席工号。

strCaller：主叫号码。转移到内线时被忽略。

nCOID：局向编号，在转移到外线时有效，配合easytq.ini配置文件内容。此参数可以用0表示任意局向。

返回：0成功，非0失败。

备注：只有坐席在与外线通话时可以转移，其他状态下调用本方法无效。本方法是异步的，调用返回成功（0）表示已经成功开始转移，真正的转移结果要在收到TLAETransferresult 之后调用tlaGettansferresult得到。

[11] long tlaTransfertoivr(BSTR strFileName,BSTR strParameter);

功能：转回到IVR。

参数：strFileName：转回IVR后执行的脚本文件名；strParameter：传递给脚本的参数，可以为空。

返回：0成功，非0失败。

备注：strParameter的值会被保存在脚本变量@PA中。

[12] long tlaListen(long nWorkID);

功能：监听。

参数：被监听坐席的工号。

返回：0成功，非0失败。

备注：被监听坐席必须处于通话状态，否则监听失败。

[13] long tlaStoplisten();

功能：停止监听。

参数：无。

返回：0成功，非0失败。

备注：无。

[14] long tlaPlay(BSTR strFileName);

功能：放音。