UComm使用说明.doc

UComm使用说明EVENT说明事件名称作用GetBill获取话单GetWake获取叫醒状态GetLeaveStatus获取房态信息为旧版本下位机程序保留的事件GetLeaveStatusBCD获取房态ConnectStatus获取交换机连接状态GetTelStatus获取话机端口状态GetConsoleStatus获取话务台状态GetCCBStatusMod 获取CCB状态GetConfirmStatus获取座席认定状态(成功或失败)ShowFlexCode获取弹编参看函数GetFlexCode2011.01.08收取话单：有新话单上传，会触发此事件GetBill(int modNum,int sendPortNo,int recvPortNo,LPCSTR sendCode, LPCSTR sendDate, LPCSTR recvCode, long timeLong, int billType, int feeCode, int officeNo, int signal, int circuitGroup,int fwpj,int isunrecv)参数说明modNum 层号 0-7sendPortNo 主叫端口号recvPortNo 被叫端口号sendCode 主叫号sendDate 时间recvCode 被叫号timeLong 时长billType 话单类型 (1 本局， 2 出局，3 入局，4 汇接)feeCode 计费码 (通常是0)officeNo 局向号signal 信令点circuitGroup 电路群号fwpj 服务评价 需在参数设置中开启服务评价业务 2009.08.29新增isunrecv 未接话单标识 2010.06.19新增 未接话单只有当交换机处于cti模式时才会产生叫醒状态：有新叫醒状态上传，会触发此事件GetWake(string telNo, int status, string firstTime, string secondTime)telNo 电话号码status 叫醒状态firstTime 第一叫醒时间secondTime 第二叫醒时间注: 此事件开关由SetWakeStatusSwitch函数设定房态：有新房态上传，触发此事件GetLeaveStatusBCD(LPCSTR telNo, LPCSTR statusBCD)telNo 电话号码 status 所拨号码(可接收0-9,*,#) 最长为8位GetLeaveStatus(string telNo, int status)telNo 电话号码 status 所拨号码 0-9 此事件已作废,只为旧版本的下位机程序保留注: 此事件开关由SetLeaveSwich函数设定连接状态：判断交换机连线与否，会触发此事件 (呼叫中心软件需用)ConnectStatus(int modNum)modNum 层号注:调用connect函数后会触发此事件分机状态：分机状态有变化，会触发此事件 (呼叫中心软件需用)GetTelStatus(string telNo, string status)telNo 电话号码status 状态 包括(空闲，振铃，通话，摘机,忙音,主叫保持,被叫保持)获取话务台状态GetConsoleStatus(LPCSTR telNo, int status0, LPCSTR tel0, int status1, LPCSTR tel1, int status2, LPCSTR tel2, int status3, LPCSTR tel3, int status4, LPCSTR tel4, int status5, LPCSTR tel5, int status6, LPCSTR tel6, int status7, LPCSTR tel7, int consoleNo)telNo 话务台电话号码 status0. status7 队列0-7状态(空闲,等待,通话,保留,回振)tel0.tel7 队列0-队列7的来电号码注:要接受此事件需定时调用ConsoleStatus函数CCB状态：有新的CCB变化产生，会触发此事件。(每个ccb号表示一个呼叫进程，从0到1023循环，呼叫中心调度都通过该ccb号，来识别。) (呼叫中心软件需用)GetCCBStatusNew(int modNum, int ccbNo, LPCSTR sendCode, LPCSTR status, LPCSTR recvCode, LPCSTR oriCode,int sendPort,int recvPort,LPCSTR statusRecv) modNum 层号0-7ccbNo ccb号sendCode 主叫号recvCode 被叫号oriCode 原始主叫号sendPort 主叫端口recvPort 被叫端口status 对于呼叫中心来说，最重要的状态是“入局呼叫起始”，表示外线已经打进电话，等待调度，这时需要分配座席。当“入局呼叫用户振铃”时表示分机已经振铃，“入局通话”表示分机正在通话。当“入局拆线”或者“ccb空闲时”，表示通话结束。另外，如果传上来的状态是“其它入局呼叫起始”，表示交换机没有工作在CTI状态，需要调用“StationUnknown”函数，交换机会自动处理。其他状态基本没有用到，红色标注的为可能需要用到的状态，主要状态列表如下：CCB空闲;CENTREX用户呼叫发起;CENTREX用户字冠分析;用户呼叫发起;用户首号字冠分析;接收用户出局后续号码;弹编发现;本局呼叫用户振铃;本局通话;本局拆线;出局呼叫回铃音;出局通话;出局拆线;入局呼叫起始;其它入局呼叫起始;CENTREX入局呼叫发起;CENTREX入局字冠分析;入局呼叫发起;入局首号字冠分析;接收汇接后续号码;CENTREX入局引导语音;CENTREX入局字冠分析;CENTREX入局忙提示;CENTREX入局空号提示;CENTREX入局无应答提示;入局字冠分析;接收汇接后续号码;入局忙提示;入局空号提示;入局无应答提示;弹编发现;入局呼叫用户振铃;入局通话;入局拆线;汇接呼叫回铃音;汇接通话;汇接拆线;汇接呼叫回铃音注: 此事件开关由SetCCBSwitch函数设定statusRecv 接收方状态: 2010.04.09新增占用发送号码接收通话被叫拆线正常挂机拆线被叫忙拆线 被叫无应答拆线(PRI信令环境)被叫缺席(PRI信令环境)呼叫被拒绝(PRI信令环境)被叫号码无效(PRI信令环境)座席认定状态，当执行StationConfirm或者StationTrans命令对座席调度后，会触发该事件 (呼叫中心软件需用)GetConfirmStatus(int ccbNo, int status)ccbNo ccb号status 状态 (10 呼叫成功，11 呼叫失败，PBX无有效资源或线路阻塞，需要重新调度，14 呼叫无效，该ccb号是无效的，通常是对方已经挂机)函数名称作用Start启动与交换机的通讯ReStart重启与交换机的通讯Stop结束与交换机通讯Connect测试与交换机连接是否正常SetCtiOnline设置交换机为CTI模式SetLamp设置留言灯SetWake设置叫醒服务SetPara设置参数SetParaTel设置参数Console话务台控制命令ConsoleStatus提取话务台状态Dial话机操作Flash话机操作SetBillSwitch话单事件开关SetRoomStatusSwitch房态事件开关SetWakeStatusSwitch叫醒状态事件开关SetCCBSwitchCCB状态事件开关SetLeaveSwich房态事件开关SetPortSwitch话机端口状态事件开关StationSendWaitMusic如果座席全忙放等待音乐StationSendMusic听等待音乐StationSendTone发送提示语音StationConfirm坐席认定StationTrans呼叫转移StationCut呼叫拆除StationUnknown呼叫未知StationRefuse呼叫拒绝PickUpByCCB按ccb号来提取通话2010.05.11IVRVoicePlayIVR语音播放函数2010.08.05IVRVoiceRecordIVR语音录入函数2010.08.05PlayNumVoice播报数字语音函数2010.08.05ClearRecvCode清空ccb被叫号码函数2010.09.29ModifyCCBRecvCode修改ccb被叫号码函数2010.10.13SetFlexCode根据端口设置弹编2011.01.08GetFlexCode根据端口上载弹编2011.01.08所有有返回值的函数,成功执行均返回 1函数说明：int Start(LPCSTR remoteHostName, int remotePort, int localPort, int modNum); (呼叫中心软件需用)启动服务remoteHostName 交换机IP地址remotePort 交换机端口号，默认是9499localPort 本机端口号，在9510-9515之间，任选一不冲突的就可以。modNum 层号 0-7int ReStart(LPCSTR remoteHostName, int remotePort, int localPort, int modNum); (呼叫中心软件需用)重启动服务remoteHostName 交换机IP地址remotePort 交换机端口号，默认是9499localPort 本机端口号，在9510-9515之间，任选一不冲突的就可以。modNum 层号 0-7void Stop();(呼叫中心软件需用)停止服务int SetLevel(LPCSTR telNo, int officeNo, int rightLevel);设置分机等级telNo 电话号码officNo 局向号 (0-7)rightLevel 局向内等级*256+局向外等级int SetLamp(LPCSTR telNo, int status); /0,关,1,开设置留言灯telNo 电话号码status 0表示关，1表示开int SetWake(LPCSTR telNo, LPCSTR firstTime, LPCSTR secondTime);设置叫醒telNo 电话号码firstTime 第一叫醒时间 格式必须是HHMMsecondTime 第二叫醒时间int Dial(int ctiType, LPCSTR sendCode, LPCSTR recvCode); 话机操作sendCode 主叫号recvCode 被叫号ctiType (16 拨打或转接电话， 18 强拆, 19 强插， 20 监听, 22 代接电话 ,49 远端插入，50远端监听，51，远端三方通话)int Flash(int ctiType, LPCSTR sendCode); 话机操作sendCode 主叫号ctiType (21 呼叫保留， 23 拍叉， 24 三方会议 ,25 挂断,32 耳麦话机应答,34 本机建立TSP三方会议)int Connect(int modNum); (呼叫中心软件需用)连接交换机，如果交换机通讯正常，会触发ConnectStatus事件。modNum 层号，一般是0此函数需定时(10s)调用,以检测与交换机间的通讯是否通畅,若连续6次调用为接收到ConnectStatus事件,则需要重启连接void SetBillSwitch(int isOpen);开启或关闭话单事件，如果isOpen为1，则有新话单来，会触发GetBill事件isOpne 1 打开 0 关闭void SetWakeStatusSwitch(int isOpen);开启或关闭叫醒事件，如果isOpen为1，则有新叫醒状态上来，会触发GetWake事件isOpne 1 打开 0 关闭void SetCCBSwitch(int isOpen); (呼叫中心软件需用)开启或关闭CCB事件，如果isOpen为1，则有新CCB来，会触发GetCCBStatus事件isOpne 1 打开 0 关闭void SetLeaveSwich(int isOpen);开启或关闭房态事件，如果isOpen为1，则有新的状态来，会触发GetLeaveStatusBCD事件isOpne 1 打开 0 关闭void SetPortSwitch(int isOpen); (呼叫中心软件需用)开启或关闭分机状态事件，如果isOpen为1，则有新的状态来，会触发GetTelStatus事件isOpne 1 打开 0 关闭void StationSendWaitMusic(int ccbNo); (呼叫中心软件需用)如果坐席全忙放等待音乐void StationSendMusic(int ccbNo); (呼叫中心软件需用)听等待音乐void StationSendTone(int ccbNo); (呼叫中心软件需用)发送提示语音void StationConfirm(int ccbNo, LPCSTR telNo); (呼叫中心软件需用)坐席认定telNo 待认定座席void StationTrans(int ccbNo, LPCSTR telNo); (呼叫中心软件需用)呼叫转移telNo 待认定座席void StationCut(int ccbNo); (呼叫中心软件需用)呼叫拆除void StationRefuse(int ccbNo); (呼叫中心软件需用)呼叫拒绝，一般用在拒绝黑名单用户void StationUnknown(int ccbNo); (呼叫中心软件需用)呼叫未知，如果交换机非处在CTI工作状态，那么有入局呼叫发起时，要调用此函数void SetCtiOnline(); (呼叫中心软件需用)设置cti在线状态，必须隔五秒定时发送，把交换机设置为CTI工作状态。int Console(int ctiType, LPCSTR sendCode, int queue);设置控制台命令ctiType 1 提取 2 保留sendCode 话务台号码queue 队列号 0-7int ConsoleStatus(int ctiType, LPCSTR telNo, int status);提取控制台状态sendCode 话务台号码int SetPara(int type, LPCSTR telNo, int status);设置参数ctiType 类型 96-设置免打扰开关 97-设置离位转移开关 98-设置遇忙转移开关 99-设置无应答转移开关 100-设置热线电话开关 104-设置联动开关telNo 要设置的分机号码status 1开启服务，0关闭服务int SetParaTel (int ctiType, LPCSTR telNo, LPCSTR paraTelNo);设置参数ctiType 类型 64-设置离位转移电话号码 65-设置遇忙转移电话号码 66-设置无应答转移电话号码 67-设置热线电话号码 76-设置联动号码telNo 要设置的分机号码paraTelNo 要设置的离位等号码当设置号码时 SetPara 和 SetParaTel 两个要依次调用，先打开服务，在设置服务号码。电话会议相关函数说明:一块电话会议板可以发起一个电话会议,如果需要同时进行多个电话会议,请增加电话会议板!groupNo 从 0 开始,根据电话会议板数量递增每发起一个电话会议要对应一个virtualNo(虚拟号码)int MeetingSet(int type, LPCSTR virtualNo, LPCSTR telNo, int groupNo)加入会议type 权限 64 发言 65 旁听 66 踢出会议virtualNo 虚拟号码telNo 要加入会议的电话号码groupNo从 0 开始,根据电话会议板数量递增int MeetingStop(LPCSTR virtualNo, int groupNo)停止会议virtualNo 虚拟号码groupNo从 0 开始,根据电话会议板数量递增int PickUpByCCB(int modNum,int ccbNo,LPCSTR sendCode)本机按CCB号提取保留的电话 函数modNum 层号 ccbNo ccb号 sendCode 本机号码int IVRVoicePlay(int modNum,int ccbNo, int VoiceNum)IVR语音播放函数modNum 层号 ccbNo ccb号 VoiceNum ivr语音段号 有效范围 1-100int IVRVoiceRecord(int VoiceNum, int SectionNum, LPCSTR VoiceStr)IVR语音录入函数VoiceNum ivr语音段号 有效范围 1-100SectionNum 该语音段的区块号 标准值1-7 如果是最后一段则要加128，如果是试听下载则再加64VoiceStr 转换成16进制后的文本 举例: 比如要下载 “IVR语音测试”Int VoiceNum = 1;byte ResultBytes;/最大值是64字节,大于64字节的要增加SectionNum,另外调用一次该函数ResultBytes = System.Text.Encoding.GetEncoding(GB2312).GetBytes(“IVR语音测试”);string VoiceStr =;for(int j=0;j ResultBytes.Length;j+)VoiceStr += ResultBytes(i-1)*64+j.ToString(X2);Int SectionNum = 1;SectionNum = 128+1;/因为这是最后一段,如果是试听下载则SectionNum = 128+64+1;/函数调用IVRVoiceRecord(VoiceNum, SectionNum, VoiceStr);Int PlayNumVoice(int modNum, int ccbNo, LPCSTR NumStr)播报数字语音函数modNum 层号 ccbNo ccb号 NumStr数字文本 长度最大64代表32个字支持的数字如下:数字语音内容：编码如下30零31一32二33三34四35五36六37七38八39九3A点3B分3C元3D毛