Avaya Java TSAPI SDK

最近阶段性工作完成了，正好有点时间，就开始了之前比较好奇也比较感兴趣的一个工作，Avaya TSAPI JAVA SDK，做这个事情的初衷是因为看熟悉的人做Avaya CTI其中TSAPI协议的集成基本上都是用C语言的dll或者so文件，然后通过java jni做封装，avaya没有提供java版本的TSAPI SDK；有了JAVA TSAPI SDK 就可以很方便的去开发出基于Avaya的相关应用；

SDK 主要包含做了一下几个工作：

对所有请求响应做了同步处理，调用起来更方便，不需要通过invokeId来匹配；
在支持通话事件的同时，同时也接受AES发送的心跳，服务异常等事件，更方便的实现服务重连以及高可用；
简化了代码调用复杂性，提供简单的数据类型数据调用；
纯java代码，结构清晰，简单，跨平台不依赖任何其他插件
支持所有avaya aes 提供的接口和事件（只要服务端支持的请求和事件都实现了）
一个sdk可以支持500并发以上的坐席呼叫中心

呼叫&设备&坐席状态相关请求列表（字母顺序）：

alternateCall
answerCall
clearCall
clearConnection
conferenceCall
singleStepConferenceCall
consultationCall
deflectCall
pickupCall
holdCall
makeCall
makePredictiveCall
queryMwi
queryDnd
queryFwd
queryAgentState
queryDeviceInfo
reconnectCall
retrieveCall
setMwi
setDnd
setFwd
setAgentState
transferCall
singleStepTransferCall

呼叫&设备&坐席状态&路由相关事件（字母顺序）：

callClearedEvent
conferencedEvent
connectionClearedEvent
deliveredEvent
divertedEvent
establishedEvent
failedEvent
heldEvent
networkReachedEvent
originatedEvent
queuedEvent
retrievedEvent
serviceInitiatedEvent
transferredEvent
doNotDisturbEvent
forwardingEvent
loggedOnEvent
loggedOffEvent
privateEvent
routeSelect
routeUsedEvent
routeEndEvent

监控相关相关请求（字母顺序）：

monitorDevice
monitorCall
monitorCallsViaDevice
changeMonitorFilter
monitorStop
monitorEnded
snapshotDeviceReq
snapshotCallReq
escapeService

系统状态事件（字母顺序）：

escapeServiceConf
sysStatReq
sysStatStart
sysStatStop
changeSysStatFilter
sysStatEvent

下面是一个简单调用例子

package tsapi.client;


import com.avaya.jtapi.tsapi.csta1.CSTAGetAPICapsConfEvent;
import com.avaya.jtapi.tsapi.csta1.CSTAMakeCallConfEvent;
import com.avaya.jtapi.tsapi.csta1.CSTAQueryAgentStateConfEvent;
import com.avaya.jtapi.tsapi.csta1.LucentMakeCallConfEvent;

import tsapi.test.TsapiTestUnsolicitedHandler;
import tsapi.util.AgentStateEnum;
import tsapi.util.CSTAResponse;

public class TsapiClientTest {

	public static TsapiClient tClient;
	
	public static void main(String[] args){
		
		TsapiCustomUnsolicitedHandler eventHandler = new TsapiCustomUnsolicitedHandler();
		tClient = new TsapiClient("AVAYA#CM#CSTA#AES", "username1", "pwd1", eventHandler);
		tClient.init();
		tClient.monitorDevice("6810");
		/*
		tClient.monitorDevice("32171");
		tClient.agentLogout("16122", "6810", null, null);
		tClient.agentLogin("16122", "6810", null, null);
		tClient.agentNotReady("16122", "6810", null, null, (short)2);
		tClient.agentWorkNotReady("16122", "6810", null, null);
		*/
		CSTAResponse _evt = tClient.queryAgentState("16122");
		CSTAQueryAgentStateConfEvent _queryConf = (CSTAQueryAgentStateConfEvent) _evt.getResponseInfo().getEvent(); 
		System.out.println(AgentStateEnum.getAgentStateFromCode(_queryConf.getAgentState()));
		
		/*
		CSTAResponse _evt2 = tClient.getApiCaps();
		CSTAGetAPICapsConfEvent e = (CSTAGetAPICapsConfEvent) _evt2.getResponseInfo().getEvent();
		System.out.println(e.print());
		*/
		
		CSTAResponse _evt2 = tClient.makeCall("7810", "901811111111", "_test");
		CSTAMakeCallConfEvent _mkcE = (CSTAMakeCallConfEvent) _evt2.getResponseInfo().getEvent();
		LucentMakeCallConfEvent _mkcE2 = (LucentMakeCallConfEvent) _evt2.getResponseInfo().getPrivData();
		System.out.println("newcall " + _mkcE.getNewCall().getCallID());
		System.out.println("ucid " + _mkcE2.getUcid());
		
	}
}

下面是事件的简单处理例子

package tsapi.client;


import com.avaya.jtapi.tsapi.csta1.CSTAConnectionID;
import com.avaya.jtapi.tsapi.csta1.CSTAEstablishedEvent;
import com.avaya.jtapi.tsapi.csta1.CSTAEvent;
import com.avaya.jtapi.tsapi.csta1.CSTAServiceInitiatedEvent;
import com.avaya.jtapi.tsapi.tsapiInterface.TsapiUnsolicitedHandler;

import java.net.SocketException;
import org.apache.log4j.Logger;

public class TsapiCustomUnsolicitedHandler implements TsapiUnsolicitedHandler {
	private static Logger log = Logger.getLogger(TsapiCustomUnsolicitedHandler.class);

	public TsapiCustomUnsolicitedHandler() {
	}

	public void acsUnsolicited(CSTAEvent event) {
		System.out.println("TsapiLightweightUnsolicitedHandler acsUnsolicited saw unexpected event " + event);
	}

	public void cstaEventReport(CSTAEvent event) {
		System.out.println("TsapiLightweightUnsolicitedHandler cstaEventReport saw unexpected event " + event);
	}

	public void cstaRequest(CSTAEvent event) {
		System.out.println("TsapiLightweightUnsolicitedHandler cstaRequest saw unexpected event " + event);
	}

	public void cstaUnsolicited(CSTAEvent event) {
		//System.out.println("TsapiLightweightUnsolicitedHandler cstaUnsolicited saw unexpected event " + event);
		if(event.getEvent() instanceof CSTAServiceInitiatedEvent){
			CSTAServiceInitiatedEvent _evt = (CSTAServiceInitiatedEvent) event.getEvent();
			System.out.println(_evt.getInitiatedConnection().getCallID()); 
		}else if(event.getEvent() instanceof CSTAEstablishedEvent){
			CSTAEstablishedEvent _evt = (CSTAEstablishedEvent) event.getEvent();
			CSTAConnectionID cstaId = _evt.getEstablishedConnection();
			//System.out.println(cstaId.get);
			TsapiClientTest.tClient.singleStepTranferCall("7810", cstaId.getCallID(), "7819");
			
		}
	}

	public void eventDistributorException(Exception e) {
		if ((e instanceof SocketException)) {

			System.out.println("TsapiLightweightUnsolicitedHandler eventDistributorException: normal 'Socket closed'.");
		} else {
			System.out.println("TsapiLightweightUnsolicitedHandler eventDistributorException: unexpected exception received: "
					+ e);
			log.error(e.getMessage(), e);
		}

	}
}

因为开发也花了一定时间精力，所以就不无偿提供了，有需要的可以回复；

扫描二维码关注公众号，回复： 5078008 查看本文章

猜你喜欢