Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide
C H A P T E R
10-1
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.0(0)
10
Call Object
The Call object provides developers using the CTIOS Client Interface Library
with an interface to Call behavior and control. The Call object exposes methods
to perform all call behaviors, such as answering, hanging up, or transferring a call.
The Call object represents one call connection of a call. For a call between two
parties there are two call connections, and thus there would be two distinct CIL
Call objects.
with an interface to Call behavior and control. The Call object exposes methods
to perform all call behaviors, such as answering, hanging up, or transferring a call.
The Call object represents one call connection of a call. For a call between two
parties there are two call connections, and thus there would be two distinct CIL
Call objects.
The object stores specific call information as properties, including the
ICMEnterpriseUniqueID, ANI, DNIS, Call variables, and ExpandedCallContext
variables. The Call object is created in response to call events received at the CIL.
The Call object’s properties and state will be updated throughout the lifetime of
the call connection.
ICMEnterpriseUniqueID, ANI, DNIS, Call variables, and ExpandedCallContext
variables. The Call object is created in response to call events received at the CIL.
The Call object’s properties and state will be updated throughout the lifetime of
the call connection.
See
for an explanation of accessing Call
and ECC variables via the GetValue mechanism.
Current Call Concept
The Client Interface Library uses the concept of a Current Call. The Current Call
concept is used by the CTI OS Toolkit as a way for the controls and the application
to communicate with each other regarding which call is currently selected and
should be the one to act upon. For example, if an agent has a call and receives a
new Ringing call, he might select the Talking call on the grid. At this click,
CallAppearanceMgr control calls SetCurrentCall() to make this call the Current
Call. When the agent clicks the Hold control, this control would call
GetCurrentCall() to obtain a call pointer through which to call the Hold() method.
The agent might then select the Ringing call, which would again cause the
concept is used by the CTI OS Toolkit as a way for the controls and the application
to communicate with each other regarding which call is currently selected and
should be the one to act upon. For example, if an agent has a call and receives a
new Ringing call, he might select the Talking call on the grid. At this click,
CallAppearanceMgr control calls SetCurrentCall() to make this call the Current
Call. When the agent clicks the Hold control, this control would call
GetCurrentCall() to obtain a call pointer through which to call the Hold() method.
The agent might then select the Ringing call, which would again cause the