呼叫中心坐席端控件(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坐席端控件的接口方法tlaOpentlaClosetlaLogintlaLogofftlaACWtlaWCAtlaAnswertlaOnhooktlaMakecalltalTransfertlaListentlaStoplistentlaPlaytlaStopplaytlaRecordtlaStoprecordtlaTransfertoivrtlaGetcalleridtalGetcalleeidtlaGetuserdatatlaGettransferresulttalGetcalloutresulttlaHoldtlaUnholdtlaCuttlaQueryworkidtlaQuerystatetlaQueryinfotlaGetcalltlaIntrudetlaKilltlaSetprioritytlaMutetlaUnmutetlaStoplogtlaStartlogtlaTransfertoivrExtlaAnswerqueuetlaGetcrs属性无事件TLAECallinTLAEACWTLAELogoffTLAEClosedTLAECalloutresultTLAETransferresultTLAECallreleasedTLAEAnswerTLAEHoldcallreleasedTLAEInfoTLAEKeepcallreleasedTLAEQueueTLAEQuitqueue方法详细说明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);功能：强拆。参数：一个：被拆座席的工号。返回：0成功，非0失败。备注：本函数把参数指定工号的座席通话强行拆掉。如果目标座席没有处于通话/呼叫中，则强拆失败。26 long tlaQueryworkid(long index);功能：查询座席工号。参数：一个：座席序号。返回：-1没有找到序号对应的座席，=0座席工号。备注：配合tlaQueryinfo函数使用，利用tlaQuer