Presentation is loading. Please wait.

Presentation is loading. Please wait.

Integrated Office Telephony System1 TSAPI APIs 沈婉婉

Similar presentations

Presentation on theme: "Integrated Office Telephony System1 TSAPI APIs 沈婉婉"— Presentation transcript:

1 Integrated Office Telephony System1 TSAPI APIs 沈婉婉

2 Integrated Office Telephony System2 Outline n CSTA n TSAPI Overview n IOTS TSAPI Overview n TSAPI Programming n IOTS TSAPI APIs

3 Integrated Office Telephony System3 CSTA (Computer Supported Telecommunications Applications) n by ECMA n Current version - Phase II n Client-server architecture

4 Integrated Office Telephony System4 CSTA Call Model n Objects  Device lines, trunks, stations, ACD, ACD groups...  Call  Connection a relationship between a call and a CSTA device n Each object has an identifier, state, other attributes

5 Integrated Office Telephony System5 CSTA Call Model (cont.) n Device, Call, Connection Call 1 Device 314 Connection 1 (connected) Device 315 Connection 2 (altering)

6 Integrated Office Telephony System6 Connection State Alerting Failed Hold Connected Queued Null Initiated

7 Integrated Office Telephony System7 Call State

8 Integrated Office Telephony System8 Device State

9 Integrated Office Telephony System9 CSTA Call Event Null Initiated Connected Alerting Null Service Initiated Originated Delivered Established Device D1Call C1Device D2 Time T1 T2 T3 T4 T5 CSTA Connection States CSTA Event Reports CSTA Connection States

10 Integrated Office Telephony System10 Agent State Model Agent Working After Call Agent Busy Agent Ready Agent Not Ready Agent Null

11 Integrated Office Telephony System11 Agent State Model (extended) Agent Working After Call Agent Busy Agent Ready Agent Not Ready Agent Null Agent Pending Agent Not Work Not Ready

12 Integrated Office Telephony System12 Voice Unit Operational Model Stop Record Play Suspend Play Review Suspend Record Speed Level Volume Level Speed Level Volume Position Set Speed Speed Level Volume Speed Level Volume Position Set Speed Position Set Speed next message Volume Level Speed

13 Integrated Office Telephony System13 Voice Unit Operational Model (partial) Stop Record Play

14 Integrated Office Telephony System14 TSAPI (Telephony Services Applications Programming Interface) n by Novell and AT&T. PBX Telephony Server

15 Integrated Office Telephony System15 TSAPI (cont.) n Client-server model n Support different client platforms  Microsoft Windows  Unix  Macintosh  OS/2 n No special voice cards, or other hardwares is necessary at a client’s desktop n Follow CSTA Phase I n Currently, only have switching functions n Current version - TSAPI Release 2.21

16 Integrated Office Telephony System16 TSAPI Introduction (cont.) Server-based Application Telephony Services Library CTI Link Hardware NetWare Telephony Services API Switch Driver. OA&M Server Functions. API Mapping. CTI Link Device Driver LAN Adapter Card Telephony Services Switch Driver Interface Applications Telephony Client Library NetWare Client Modules Windos OS NetWare OS Clients... LAN Switch (PBX) CTI Link Telephony Server Analog, ISDN, or PBX-specific lines

17 Integrated Office Telephony System17 IOTS TSAPI n TSAPI-like application programming interface for IOTS trunk or line interface IOTS Client

18 Integrated Office Telephony System18 IOTS TSAPI (cont.) n Follow TSAPI Release 2.21, excepts:  Escape services  Maintenance services  System services n Server: Windows NT 4.0 n Client: Windows NT 4.0

19 Integrated Office Telephony System19 IOTS TSAPI (cont.) Server-based Application TSAPI DLL LSI / MSI Windows NT4.0 TSAPI Library IOTS Platform LAN Adapter Card TSAPI Server Applications TSAPI Library TSAPI DLL Windos NT4.0 Windows NT4.0 Clients... LAN IOTS Analog lines TRUNK

20 Integrated Office Telephony System20 TSAPI Programming n API Control Services (ACS) Stream  a logical link between application & TSAPI server  applications request CSTA services and receive events over the stream n CSTA Call Model n TSAPI Events  most APIs has an associated confirmation event  when the state of calls or devices were changed, an unsolicited event reports

21 Integrated Office Telephony System21 TSAPI Programming (cont.) Close Stream Conf Event acsOpenStream() Open Stream Conf Event CSTA Service Requests Monitor Requests CSTA Conf Events Monitor Conf Event Unsolicited Events acsCloseStream() PBX TSAPI Server TSAPI Switch Function / Media Process Requests Conf Event

22 Integrated Office Telephony System22 IOTS Supported TSAPI APIs n API control services n Switching function services n Status reporting services n Snapshot services n CSTA computing function services n Media processing services n IOTS extended services

23 Integrated Office Telephony System23 Event Manipulation n Each stream contains one event queue  confirmation events (service request)  unsolicited events (monitor request) for swithing & media processing  request events (route register request) for call routing request  event report (route register request) for call routing status n Retrieve event form queue  acsGetEventBlock()  acsGetEventPoll() n Clear event queue  acsFlushEventQueue()

24 Integrated Office Telephony System24 API Control Services n acsOpenStream n acsCloseStream n acsGetEventBlock n acsGetEventPool n acsFlushEventQueue n cstaGetDeviceList n cstaGetAPICaps

25 Integrated Office Telephony System25 Switching Function Services n cstaAlternateCall n cstaAnswerCall n cstaClearCall n cstaClearConnection n cstaConferenceCall n cstaConsultationCall n cstaDeflectCall n cstaGroupPickupCall n cstaHoldCall n cstaMakeCall n cstaMakePredictiveCall n cstaPickupCall n cstaReconnectCall n cstaRetrieveCall n cstaTransferCall

26 Integrated Office Telephony System26 Switching Function Services (cont.) n cstaQueryAgentState n cstaQueryDeviceInfo n cstaQueryDoNotDisturb n cstaQueryFwd n cstaQueryLastNumber n cstaSetAgentState n cstaSetDnd n cstaSetFwd

27 Integrated Office Telephony System27 Status Reporting Services n cstaMonitorDevice n cstaMonitorCall n cstaMonitorCallsViaDevice n cstaMonitorStop n cstaChangeMonitorFilter

28 Integrated Office Telephony System28 Snapshot Services n cstaSnapshotCallReq Call Device1 Device4 Device3 Device2 C1 C2 C3 C4 Call State = C1 C2 C3 C4 Connection State

29 Integrated Office Telephony System29 Snapshot Services (cont.) cstaSnapshotDeviceReq

30 Integrated Office Telephony System30 CSTA Computing Function Services n cstaRouteRegisterReq n cstaRouteRegisterCancel n cstaRouteSelectInv n cstaRouteEndInv

31 Integrated Office Telephony System31 Application Routing Scenario Driver / Switch DomainRouting Server (application) (1) a call arrives at the routing device, CSTARouteRequestEvent is sent (3) the switchh attempts to route the queued call to selected dest. a. if destination address is o.k. a CSTARouteEndEvent is sent b. if destination is invalid, then a CSTAReRouteEvent is sent (5) the switch attempts to route the queued call to selected dest. a. if destination address o.k., a CSTARouteUsedEvent and CSTARouteEndEvent is sent b. if destionation is invalid then a CSTAReRouteEvent is sent (0) call cstaRouteRegisterReq() to be a routing server for a specified device (2) Application select a destination for for the call. A cstaRouteSelectInv() message is sent (Rout Used=off). (4a) If (3a) then route is completed as specified in (2). (4b) If (3b) then send a second cstaRouteSelectInv() with a different destination (Rout Used=on). (6a) If (5a) then route is completed as specified in (4b). (6b) If (5b) then send a second cstaRouteSelectInv() with a different destination (Rout Used=on), or send a cstaRouteEndInv() handback to switch. (last) call cstaRouteRegisterCancel() before application exit. call related info is passed (1) (3a) or (3b) (2) (4b) (5a) or (5b)...

32 Integrated Office Telephony System32 Media Processing Services n _cstaPlayMessage n _cstaRecordMessage n _cstaStopMessage n _cstaDeleteMessage n _cstaGetDTMFTones n _cstaSendDTMFTones n _cstaSendFAX n _cstaReceiveFAX

33 Integrated Office Telephony System33 IOTS Extended Services n _cstaAssociateData n _cstaQueryCallInfo n _cstaSingleStepTransferCall

34 Integrated Office Telephony System34 CSTA Event - Unsolicited Event n CSTACallCleared n CSTAConferenced n CSTAConnectionCleared n CSTADelivered n CSTADiverted n CSTAEstablished n CSTAFailed n CSTAHeld n CSTANetworkReached n CSTAOriginated n CSTAQueued n CSTARetrieved n CSTAServiceInitiated n CSTATransferred n CSTADoNotDisturb n CSTAForwarding n CSTALoggedOn n CSTALoggedOff n CSTANotReady n CSTAReady n CSTAWorkNotReady n CSTAWorkReady n CSTAMonitorEnded n CSTAOutOfService n CSTABackInService n CSTAPlay n CSTARecord n CSTAStop

35 Integrated Office Telephony System35 CSTA Event - Request Event n CSTARouteRequest n CSTARerouteRequest

36 Integrated Office Telephony System36 CSTA Event - Event Report n CSTARegisterAbort n CSTARouteUsedExt n CSTARouteEnd

37 Integrated Office Telephony System37 Events for Failure n ACSUniversalFailureConf  non-telephony problem  sent in place of confirmation event n CSTAUniversalFailureConf  telephony-based problem  sent in place of confirmation event n ACSUniversalFailure  a failure of ACS Stream with TSAPI server

38 Integrated Office Telephony System38 Confirmation Events n Confirmation events: TSAPI has processed the request  acsOpenStream() ACSOpenStreamConf  cstaGetDeviceList() CSTAGetDeviceListConf

39 Integrated Office Telephony System39 Unsolicited Events n Unsolicited events for switch function (that IOTS Platform/switch has processed) cstaMonitorDevive(StationDeviceID): CSTADelivered (delivered.connection) cstaAnswerCall() CSTAAnswerCallConf CSTAEstablished cstaClearConnection() CSTAClearConnection CSTAClearConnectionConf Another party drop call

40 Integrated Office Telephony System40 Request Events & Event Report n Unsolicited events for call routing (sent from IOTS platform/switch) cstaMonitorDevive (TrunkDeviceID) cstaRouteRegisterReq (TrunkDeviceID) CSTARouteRequestExt cstaRouteSelectInv() No confirmation event CSTARouteEnd /CSTAReRouteRequest Busy CSTAClearConnection Another party drop call CSTARouteEnd No answerConnected

Download ppt "Integrated Office Telephony System1 TSAPI APIs 沈婉婉"

Similar presentations

Ads by Google