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

呼叫中心坐席端控件(EasyAgc.ocx)使用说明为什么需要坐席端控件在一个完整的呼叫中心系统中，坐席端软件是一个重要的组成部分。

坐席人员通过坐席端软件与呼叫中心服务器（CCS）进行交互，完成对通讯设备的控制和相关信息的交换，如坐席的登录、注销、离席、复席、应答、呼出、转移等等动作，都是通过坐席端软件与CCS的通信完成的。

一般来说，坐席端软件与CCS之间的通信是建立在TCP/IP的基础上的。

具体的通信包格式可以自行定义。

为了降低坐席端软件的开发难度和加快坐席端软件的开发速度，通行的做法是把坐席端软件分成通信模块与业务模块两部分。

其中业务模块会随客户的需求变化而变化，一般都需要进行定制开发；而通信部分则相对变化较少，不论什么行业的呼叫中心，其坐席端软件一般都需要包括坐席的登录，注销，呼出，应答，挂断，转移等基本通信功能。

因此有必要把坐席软件的通信模块进行封装，以OCX控件的方式提供给最终用户，最终用户不需要了解坐席端与CCS之间的通信包格式，也不必学习Socket通信的开发技术，只需访问OCX控件公布的方法和属性，对OCX控件公布的事件进行响应，就可以完成坐席端软件通信模块的开发。

坐席端控件支持的开发语言北京同力信通软件公司坐席端控件符合Windows控件标准，理论上支持所有可以支持控件的开发语言，成功通过北京同力信通软件公司公司测试的语言包括：Delphi 7.0Visula Basic 6.0Visual C++ 6.0IE6.0-VBScript/Jscript坐席端控件的接口方法tlaOpentlaClosetlaLogintlaLogofftlaACWtlaWCAtlaOnhook tlaMakecall talTransfer tlaListen tlaStoplisten tlaPlay tlaStopplay tlaRecord tlaStoprecord tlaTransfertoivr tlaGetcallerid talGetcalleeid tlaGetuserdata tlaGettransferresult talGetcalloutresult tlaHold tlaUnholdtlaCut tlaQueryworkid tlaQuerystate tlaQueryinfo tlaGetcall tlaIntrudetlaKill tlaSetpriority tlaMute tlaUnmute tlaStoplog tlaStartlog tlaTransfertoivrEx tlaAnswerqueue tlaGetcrs属性无事件TLAECallin TLAEACW TLAELogoffTLAECalloutresult 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);功能：放音。

参数：strFileName：语音文件名。

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

备注：参数strFileName必须带完整路径，此文件应位于运行北京同力信通软件公司统一CTI 平台程序的服务器上。

[15] long tlaStopplay();功能：停止放音。

参数：无。

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

备注：无。

[16] long tlaRecord(BSTR strFileName, long nDuration);功能：录音。

参数：录音文件名，时长。

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

备注：录音文件保存在运行北京同力信通软件公司统一CTI平台程序的服务器上。

要求完整路径。

[17] long tlaStoprecord();功能：停止录音参数：无。

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

备注：无。

[18] BSTR tlaGetcallerid();功能：获取主叫号码参数：无。

返回：主叫号码。

备注：在收到TLAECallin事件后调用本方法得到主叫号码，在其他状态下调用本方法返回值没有意义。

[19] BSTR tlaGetcalleeid();功能：获取被叫号码参数：无。

返回：被叫号码。

备注：在收到TLAECallin事件后调用本方法得到被叫号码，在其他状态下调用本方法返回值没有意义。

[20] BSTR tlaGetuserdata();功能：获取从脚本传递过来的数据。

参数：无。

返回：用户数据。

备注：在收到TLAECallin事件后调用本方法得到用户数据，在其他状态下调用本方法返回值没有意义。

用户数据即脚本的转人工元件中用户数据属性的内容。

[21] long tlaGettransferresult();功能：获取转移结果。

参数：无。

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

备注：在收到TLAETransferresult事件后调用本方法判断转移是否真正成功。

[22] long tlaGetcalloutresult();功能：获取外呼结果。

参数：无。

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

备注：在收到TALECalloutresult事件后调用本方法判断外呼是否真正成功。

[23] long tlaHold();功能：保持。

参数：无。

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

备注：只有在座席与外线的通话中才可以调用tlaHold函数。

调用本函数成功后,座席处于空闲状态，外线播放等待音乐。

需要指出：座席不能重复保持，即：座席与外线A通话中先保持，然后再与外线B通话，此时座席再调用tlaHold就会失败。

[24] long tlaUnhold();功能：取消保持。

参数：无。

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

备注：座席与外线通话过程中，座席调用tlaHold函数把当前呼叫保持住。

再调用tlaUnhold 恢复与外线的通话。

如果在保持过程中被保持的外线已经挂机，则取消保持会失败。

[25] long tlaCut(long workid);功能：强拆。