Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide
6-25
CTI OS Developer’s Guide for Cisco ICM/IPCC Enterprise & Hosted Editions Release 7.1(1)
Chapter 6 Event Interfaces and Events
ISessionEvents Interface
OnTranslationRoute
The OnTranslationRoute event is a pre-call indication. The event indicates the
pending arrival of a call, and provides early access to the call context information.
From a call flow perspective, this event can be used to begin an application or
database lookup for the call context data before the call actually arrives at the
agent’s teleset.
pending arrival of a call, and provides early access to the call context information.
From a call flow perspective, this event can be used to begin an application or
database lookup for the call context data before the call actually arrives at the
agent’s teleset.
The contact is uniquely identified by the
ICMEnterpriseUniqueID, which is
a field based on the ICM’s 64-bit unique key (
RouterCallKeyDay and
RouterCallKeyCallID). This event does not indicate the creation of a Call
object on the CTI OS server – only that the contact is being tracked. This is
sufficient to be able to get and set data, which enables some powerful
data-prefetching applications. When a OnCallBeginEvent follows for this same
contact, the ICMEnterpriseUniqueID field will be send along with the call
data. At that point, a custom application can set the call data on the appropriate
call object.
object on the CTI OS server – only that the contact is being tracked. This is
sufficient to be able to get and set data, which enables some powerful
data-prefetching applications. When a OnCallBeginEvent follows for this same
contact, the ICMEnterpriseUniqueID field will be send along with the call
data. At that point, a custom application can set the call data on the appropriate
call object.
Syntax
C++:
void OnTranslationRoute(Arguments& args)
COM:
void OnTranslationRoute(IArguments * args)
VB:
session_OnTranslationRoute(ByVal args As
CtiosCLIENTLib.IArguments)
Parameters
args
Arguments array containing the following fields.
Keyword
Type
Description
ICMEnterpriseUniqueID
STRING
This string is a globally unique key
for this contact, which corresponds
to the ICM 64 bit key. This
parameter can be used to match
this contact to a follow-on call
event.
for this contact, which corresponds
to the ICM 64 bit key. This
parameter can be used to match
this contact to a follow-on call
event.