Cisco Cisco Computer Telephony Integration OS 8.5 Developer's Guide
6-36
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 6 Event Interfaces and Events
ICallEvents Interface
OnCallFailed
The OnCallFailed event may be generated when a call cannot be completed. With this event the
connection status becomes LCS_FAIL. This would most likely happen as a result of a MakeCall or a
MakeConsultCall request, but can occur at any other point in the call’s lifetime if the call fails on an
ACD. In this case, you should perform any required cleanup prior to arrival of an EndCall event.
connection status becomes LCS_FAIL. This would most likely happen as a result of a MakeCall or a
MakeConsultCall request, but can occur at any other point in the call’s lifetime if the call fails on an
ACD. In this case, you should perform any required cleanup prior to arrival of an EndCall event.
Note
The events (CallConnectionCleared and CallCleared) received after the CallFailed event will not include
a CallStatus, because until the call has ended, it is important to preserve the fact that this is a failed call.
a CallStatus, because until the call has ended, it is important to preserve the fact that this is a failed call.
Syntax
C++:
void OnCallFailed(Arguments& args)
COM:
void OnCallFailed (IArguments * args)
VB:
session_OnCallFailed (ByVal args As CtiosCLIENTLib.IArguments
SkillGroupNumber
(Optional)
(Optional)
INT
The number of the agent SkillGroup the call is attributed to, as
known to the peripheral. May contain the special value
NULL_SKILL_GROUP when not applicable or not available.
known to the peripheral. May contain the special value
NULL_SKILL_GROUP when not applicable or not available.
SkillGroupID (Optional)
INT
The Unified ICM SkillGroupID of the agent SkillGroup the
call is attributed to. May contain the special value
NULL_SKILL_GROUP when not applicable or not available.
call is attributed to. May contain the special value
NULL_SKILL_GROUP when not applicable or not available.
SkillGroupPriority
(Optional)
(Optional)
SHORT
The priority of the skill group, or 0 when skill group priority
is not applicable or not available.
is not applicable or not available.
LineType
SHORT
Indicates the type of the teleset line.
EnablementMask
INT
Contains the bit-mask that specifies what buttons can be
enabled or disabled when this call is the current call. See
UniqueObjectID
STRING
An object ID that uniquely identifies the call object.
CallStatus
SHORT
The current status of the call.
ICMEnterpriseUniqueID
(Optional)
(Optional)
STRING
Required only when the call is pre-routed.
TrunkNumber (optional)
INT
The number representing a trunk.
TrunkGroup Number
(optional)
(optional)
INT
The number representing a trunk group.
Keyword
Type
Description