Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 490
C H A P T E R
   
6-1
CTI OS Developer’s Guide for Cisco Unified Contact Center Enterprise
Release 8.5(3)
6
Event Interfaces and Events
This chapter describes the CTI OS Client Interface Library’s event publications mechanism. Programs 
written to take advantage of CTI interfaces are generally event driven, meaning that a code module in 
the application is executed when an external event arrives. The CIL interface provides a rich set of event 
interfaces and events for use by client programmers.
Events are generated asynchronously, either by the telephony equipment (for example, phone, PBX, and 
ACD) or by the CTI environment (CTI Server, or CTI OS Server). Each event passes an Arguments 
structure of key-value pairs that contains all of the event parameters. These parameters are discussed in 
greater detail in this chapter.
Event Publication Model
Note
The CIL event interfaces discussed in this section and the following sections apply only to the C++, 
COM, and VB interfaces. See 
 for a discussion of Java CIL counterpart events and 
event handling in the Java CIL See 
, for a discussion of .NET CIL event handling. 
The Client Interface Library provides a publisher-subscriber model for notifying clients of events. Client 
applications using the CIL can subscribe to one or more of the CIL event interfaces. For detailed 
information and examples on how to subscribe and unsubscribe for events, see 
The published CIL event interfaces are organized around the different classes of CTI objects that the CIL 
provides. The event interfaces described in this chapter are:
ISessionEvents. This interface publishes the events that relate to actions on the Session object.
ICallEvents. This interface publishes the events that relate to actions on Call objects.
IAgentEvents. This interface publishes the events that relate to actions on Agent objects. 
ISkillGroupEvents. This interface publishes the events that relate to actions on SkillGroup objects. 
IButtonEnablementEvents. This interface publishes the events that relate to changes in the 
enable-disable status of softphone buttons. 
ISilentMonitorEvents. This interface sends events to subscribers of the Silent Monitor interface.
IMonitoredAgentEventsInterface. This interface fires Agent events to a supervisor for his team 
members.
IMonitoredCallEventsInterface. This interface sends Call events to a supervisor for one of his agent 
team members.