Ucce B Cti Server Message Reference Guide

Download as pdf or txt
Download as pdf or txt
You are on page 1of 326

CTI Server Message Reference Guide (Protocol Version 21) for Cisco

Unified Contact Center Enterprise, Release 11.6(1)


First Published: 2017-08-24

Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)

© 2018 Cisco Systems, Inc. All rights reserved.


CONTENTS

Preface Preface xi
Change History xii
About This Guide xii
Audience xii
Related Documents xiii
Obtaining Documentation and Submitting a Service Request xiii
Field Alerts and Field Notices xiii
Documentation Feedback xiii
Conventions xiii

CHAPTER 1 CTI Server Overview 1


How CTI Server Works 1
Unified CCE Call Processing 2
Pre-Routed Normal Call 2
Translation Route Call 3
Post Route Call 4
Transfer Call 4
Conference Call 4
CTI Server Configurations 5
Simplex/Duplex Configuration 6
CTI Bridge Configuration 7
CTI Server Message Set 8

CHAPTER 2 CTI Client Application Guidelines 9


InvokeIDs 9
Heartbeat Messages 9
Generic vs ACD-Specific Applications 10

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
iii
Contents

Message Masks 10
Message Order 10
Definitions of Symbolic Constants 10
Side AB Selection TCPIP Connections 11
Alignment of Data Elements 11
Incompatible Changes Reported Call ConnectionIDs 11
CTI Operations During Unified CCE Failures 12

CHAPTER 3 Messaging Conventions 13


CTI Message Convention 13
Message Types 13
Data Types 25
MHDR Data Type 26
NAMEDVAR Data Type 27
NAMEDARRAY Data Type 27
TASKID Data Type 28
Message Formats 28
Floating Fields 29
Invoke IDs 30
Call Event Data 30
Device IDs 30
CTI Client History 30
Event Cause Codes 31
Call Identification 31
Failure Indication Messages 32

CHAPTER 4 Session Management 33


Configuring TCPIP Transport Services 33
Connection Management 33
Session Initialization 34
CTI Service Masks 34
OPEN_REQ Message 36
Unsolicited Call Event Message Masks 38
Agent State Masks 40
OPEN_CONF Message 41

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
iv
Contents

Session Maintenance 44
Session Termination 45

CHAPTER 5 Application Level Interfaces 47


CTI Server Application Level Interfaces 47
Client Events Service 48
BEGIN_CALL_EVENT 51
END_CALL_EVENT 54
CALL_AGENT_GREETING_EVENT 55
CALL_DATA_UPDATE_EVENT 56
CALL_DELIVERED_EVENT 58
CALL_ESTABLISHED_EVENT 62
CALL_HELD_EVENT 64
CALL_RETRIEVED_EVENT 65
CALL_CLEARED_EVENT 67
CALL_CONNECTION_CLEARED_EVENT 68
CALL_ORIGINATED_EVENT 69
CALL_FAILED_EVENT 71
CALL_CONFERENCED_EVENT 72
CALL_TRANSFERRED_EVENT 74
CALL_DIVERTED_EVENT 77
CALL_SERVICE_INITIATED_EVENT 78
AGENT_STATE_EVENT 80
CALL_REACHED_NETWORK_EVENT 84
CALL_QUEUED_EVENT 86
CALL_DEQUEUED_EVENT 88
CALL_ATTRIBUTE_CHANGE_EVENT 90
AGENT_PRE_CALL_EVENT 91
AGENT_PRE_CALL_ABORT_EVENT 93
RTP_STARTED_EVENT 94
RTP_STOPPED_EVENT 96
All Events Service 97
CALL_DELIVERED_EVENT 98
CALL_TRANSLATION_ROUTE_EVENT 98
Peripheral Monitor Service 99

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
v
Contents

MONITOR_START_REQ 100
MONITOR_STOP_REQ 102
CHANGE_MONITOR_MASK_REQ 103
Client Monitor Service 104
CLIENT_SESSION_OPENED_EVENT 105
CLIENT_SESSION_CLOSED_EVENT 106
SESSION_MONITOR_START_REQ 107
SESSION_MONITOR_STOP_REQ 108
Supervisor Service 109
SUPERVISE_CALL_REQ 110
EMERGENCY_CALL_REQ 113
EMERGENCY_CALL_EVENT 115
AGENT_TEAM_CONFIG_EVENT 116
LIST_AGENT_TEAM_REQ 117
MONITOR_AGENT_TEAM_START_REQ 118
MONITOR_AGENT_TEAM_STOP_REQ 119
Call Data Update Service 120
SET_CALL_DATA_REQ 120
RELEASE_CALL_REQ 123
SET_DEVICE_ATTRIBUTES_REQ 125
Miscellaneous Service 127
SYSTEM_EVENT 128
CLIENT_EVENT_REPORT_REQ 129
USER_MESSAGE_REQ 130
USER_MESSAGE_EVENT 132
QUERY_AGENT_STATISTICS_REQ 132
QUERY_SKILL_GROUP_STATISTICS_REQ 140
REGISTER_VARIABLES_REQ 158
SET_APP_DATA_REQ 160
START_RECORDING_REQ 161
STOP_RECORDING_REQ 164
AGENT_DESK_SETTINGS_REQ 166
Connection Monitor Service 169
Client Control Service 169
QUERY_AGENT_STATE_REQ 172

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
vi
Contents

SET_AGENT_STATE_REQ 175
ALTERNATE_CALL_REQ 178
ANSWER_CALL_REQ 179
CLEAR_CALL_REQ 180
CLEAR_CONNECTION_REQ 181
CONFERENCE_CALL_REQ 183
CONSULTATION_CALL_REQ 186
DEFLECT_CALL_REQ 190
HOLD_CALL_REQ 191
MAKE_CALL_REQ 192
MAKE_PREDICTIVE_CALL_REQ 196
RECONNECT_CALL_REQ 199
RETRIEVE_CALL_REQ 200
TRANSFER_CALL_REQ 201
QUERY_DEVICE_INFO_REQ 206
SNAPSHOT_CALL_REQ 210
SNAPSHOT_DEVICE_REQ 214
SEND_DTMF_SIGNAL_REQ 216
SUPERVISOR_ASSIST_REQ 217
EMERGENCY_CALL_REQ 219
BAD_CALL_REQ 223
AGENT_GREETING_CONTROL_REQ 224
Server Service 225
REGISTER_SERVICE_REQ 225
UNREGISTER_SERVICE_REQ 226
Configuration Acquisition Messages 227
Configuration keys 227
Initial configuration acquisition 227
Update messages 228
Message order 228
CONFIG_REQUEST_KEY_EVENT 228
CONFIG_KEY_EVENT 229
CONFIG_REQUEST_EVENT 230
CONFIG_BEGIN_EVENT 231
CONFIG_SERVICE_EVENT 232

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
vii
Contents

CONFIG_SKILL_GROUP_EVENT 234
CONFIG_AGENT_EVENT 235
CONFIG_DEVICE_EVENT 238
CONFIG_CALL_TYPE_EVENT 239
CONFIG_MRD_EVENT 240
CONFIG_END_EVENT 240

CHAPTER 6 Constants and Status Codes 243


In this chapter 244
Failure Indication Message Status Codes 244
SystemEventID Values 250
Special Values 251
Tag Values 252
AgentState Values 265
PGStatusCode Values 266
PeripheralType Values 267
LocalConnectionState Values 268
EventCause Values 269
DeviceIDType Values 274
CallType Values 275
ConnectionDeviceIDType Values 277
LineType Values 278
ControlFailureCode Values 278
AllocationState Values 285
ForwardType Values 285
TypeOfDevice Values 286
ClassOfDevice Values 287
CallPlacementType Values 287
CallMannerType Values 288
CallOption Values 288
ConsultType Values 289
FacilityType Values 289
AnsweringMachine Values 290
AnswerDetectMode Values 290
AgentWorkMode Values 291

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
viii
Contents

DestinationCountry Values 291


CTI Service Masks 291
Disposition Code Values 293
Agent Service Request Masks 296
Silent Monitor Status Values 296
Agent Internal States Message Values 296
TaskState Values 297

CHAPTER 7 Changes and Additions 299


Protocol Version 21 299
Protocol Version 20 300
Protocol Version 19 301
Protocol Version 18 301
Protocol Version 17 301
Protocol Version 16 302
Protocol Version 15 302
Protocol Version 14 302
Protocol Versions 10-13 304
Protocol Version 9 306
Protocol Version 8 306
Protocol Version 7 308
Protocol Version 6 308
Protocol Version 5 310

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
ix
Contents

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
x
Preface
• Change History, page xii
• About This Guide, page xii
• Audience, page xii
• Related Documents, page xiii
• Obtaining Documentation and Submitting a Service Request, page xiii
• Field Alerts and Field Notices, page xiii
• Documentation Feedback, page xiii
• Conventions, page xiii

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
xi
Preface
Change History

Change History
Change See Date
Initial Release of Document for Release 11.6(1) August 2017

Added NumMRDs, FLTAgentMRDID, CONFIG_AGENT_EVENT, on page 235


and FltAgentMRDState under
CONFIG_AGENT_EVENT. Also,
changed the protocol version in the Title
of the document from 20 to 21.

EventReasonCode is supported only for AGENT_STATE_EVENT, on page 80


the Not Ready and Logged Off agent
states.

Added a new Message with the type 259. Message Types, on page 13
This Message is reserved for internal use
only.

Updated fields (Value, Data Type and CONFIG_AGENT_EVENT, on page 235


Byte Size) of CONFIG_SERVICE_EVENT, on page 232
CONFIG_AGENT_EVENT and
CONFIG_SERVICE_EVENT table. Protocol Version 21, on page 299
Also added and updated Protocol version
21.

About This Guide


This manual describes the Customer Telephony Integration (CTI) Server message interface between Unified
Contact Center Enterprise (Unified CCE) and application programs.

Audience
This manual is for system integrators and programmers who want to integrate C++ CTI client applications
with Unified CCE.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
xii
Preface
Related Documents

Related Documents

Obtaining Documentation and Submitting a Service Request


For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service
request, and gathering additional information, see What's New in Cisco Product Documentation.
To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What's
New in Cisco Product Documentation RSS feed. RSS feeds are a free service.

Field Alerts and Field Notices


Cisco can modify its products or determine key processes to be important. These changes are announced
through use of the Cisco Field Alerts and Cisco Field Notices. You can register to receive Field Alerts and
Field Notices through the Product Alert Tool on Cisco.com. This tool enables you to create a profile to receive
announcements by selecting all products of interest.
Sign in www.cisco.com and then access the tool at https://www.cisco.com/cisco/support/notifications.html.

Documentation Feedback
To provide comments about this document, send an email message to the following address:
[email protected]
We appreciate your comments.

Conventions
This document uses the following conventions:

Convention Description
boldface font Boldface font is used to indicate commands, such as user entries, keys, buttons,
and folder and submenu names. For example:
• Choose Edit > Find.
• Click Finish.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
xiii
Preface
Conventions

Convention Description
italic font Italic font is used to indicate the following:
• To introduce a new term. Example: A skill group is a collection of agents
who share similar skills.
• A syntax value that the user must replace. Example: IF (condition, true-value,
false-value)
• A book title. Example: See the Cisco Unified Contact Center Enterprise
Installation and Upgrade Guide.

window font Window font, such as Courier, is used for the following:
• Text as it appears in code or that the window displays. Example:
<html><title>Cisco Systems, Inc. </title></html>

< > Angle brackets are used to indicate the following:


• For arguments where the context does not allow italic, such as ASCII output.
• A character string that the user enters but that does not appear on the window
such as a password.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
xiv
CHAPTER 1
CTI Server Overview
• How CTI Server Works, page 1
• Unified CCE Call Processing, page 2
• CTI Server Configurations, page 5
• CTI Server Message Set, page 8

How CTI Server Works


The CTI Server provides an interface between Unified CCE and client CTI applications. CTI Server runs on
either a Unified CCE Peripheral Gateway (PG) with ACD interface software or on a dedicated CTI Gateway

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
1
CTI Server Overview
Unified CCE Call Processing

platform. This figure shows a sample CTI system in which the CTI Server runs on a PG platform along with
the ACD interface software. CTI Servers may be running at one or several call centers in the enterprise.

Figure 1: CTI Server Overview

CTI Server forwards pre-routes indications to CTI application servers. Pre-route indications identify the caller
and provide associated call attributes to applications before the call is connected to an agent or Voice Response
Unit (VRU).
In a direct desktop application environment, call event information is delivered to the targeted desktop when
the call is delivered. CTI Server reports call events and agent work state changes to the application as they
occur through each stage of the call flow. This lasts from when a call arrives at an answering resource
(Automatic Call Distributor (ACD), Private Branch Exchange (PBX), or VRU), until the caller hangs up.

Unified CCE Call Processing


The following brief review of several different Unified CCE call processing flows may be helpful when
considering the CTI services and data provided by this interface. In the following discussions:
• Agent represents either a human representative or a VRU port.
• ACD represents a peripheral that is directly monitored by Unified CCE. It may be an actual ACD or a
VRU.
• Call context refers to the user data associated with a specific call collected by Unified CCE. Call context
includes Dialed Number, Calling Line ID or ANI, Caller Entered Digits, and an array of Call Variables.

Pre-Routed Normal Call


1 A customer dials an Enterprise “800” number.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
2
CTI Server Overview
Translation Route Call

2 The caller responds to in-network prompting (if any).


3 The network forwards a route request to Unified CCE (including any caller entered digits collected by the
network).
4 Unified CCE, through the use of a routing script, chooses a destination to handle the call. The routing
script almost certainly makes use of any caller entered digits.
5 A route response is returned to the network.
6 The call arrives at the chosen ACD and is monitored by the Peripheral Gateway (PG).
7 The call may pass through several states (queued, alerting, etc.) before finally being connected to an agent.
8 The agent may either handle the call directly or transfer the call to another agent.
9 Upon completion of the call, a Termination Call Detail record is created and sent to the Central Controller
(CC) database.

Translation Route Call


1 A customer dials an Enterprise “800” number.
2 The caller responds to in-network prompting (if any).
3 The network forwards a route request to Unified CCE (including any caller entered digits collected by the
network).
4 Unified CCE, through the use of a routing script, chooses two destinations for the call: an intermediate
target and an ultimate target. The intermediate target is chosen from a special “pool” of targets reserved
for just this purpose. No other calls are expected to arrive at the intermediate target.
5 A route response is returned to the network to send the call to the intermediate target. At the same time,
the ultimate target data is sent to the PG monitoring the ACD where the call is expected to arrive. Caller
entered digits collected in the network and any other call data set by the routing script is also sent to the
PG in the message.
6 The call arrives at the chosen ACD and is monitored by the Peripheral Gateway (PG).
7 The ACD, recognizing the “special” nature of the call, performs a Route Request to collect the call’s ultimate
target.
8 The ultimate target and other “call context” data determined by Unified CCE in step 5 is returned by the
PG in a Route Response
9 The ACD routes the call to the ultimate target. As in the “normal” call case, the PG is informed of the call’s
state changes as they occur. Eventually the call is connected to an agent.
10 The agent may either handle the call directly or transfer the call to another agent.
11 Upon completion of the call, a Termination Call Detail record is created and sent to the CC database.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
3
CTI Server Overview
Post Route Call

Post Route Call


1 An ACD sends a Route Request to Unified CCE in order to determine the destination for a call it wishes
to redirect. The Route Request may supply call data such as caller entered digits and any other call context
data that peripheral type supports.
2 Unified CCE, through the use of a routing script, chooses a destination to handle the call. The routing
script almost certainly makes use of any caller entered digits.
3 A route response is returned to the ACD, along with call context data (that may have been updated by the
routing script).
4 The ACD routes the call to the ultimate target. As in the “normal” call case, the PG is informed of the call’s
state changes as they occur. Eventually the call is connected to an agent.
5 The agent may either handle the call directly or transfer the call to another agent.
6 Upon completion of the call, a Termination Call Detail record is created and sent to the Central Controller
database.

Transfer Call
1 In the case of a “local” transfer, the agent handling a call directs the ACD to transfer the call to another
destination on the same ACD.
2 The peripheral gateway (PG) is informed of the various events associated with the call’s transfer.
3 Call transfers are handled differently by different types of ACDs. In general a new logical call is created
for the resulting call. A Termination Call Detail record is created for the original call.
4 The new call is connected to an agent and is then handled or transferred (again) like any other call.

In the case of a “remote” transfer, the call leaves the realm of the monitoring PG and the original call is
terminated in the usual way. The Unified CCE monitor the ACD and the "remote" transfer takes place into
this ACD, the new call is monitored on that ACD's PG when the call arrives. This new call has none of the
call context of the original call.
Depending upon the particular ACD’s capabilities and tie-line configuration, some ACDs may be set up to
affect call transfers using the post route and translation route features previously described. In this case, the
call context is preserved by being sent through Unified CCE via the route request and translation route
mechanisms to the remote PG, and is thus available to the CTI Client, if any, associated with the destination
device.

Conference Call
Like call transfers, call conferences are handled differently by different types of ACDs and may involve the
creation of several calls that are all linked together.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
4
CTI Server Overview
CTI Server Configurations

CTI Server Configurations


The CTI Interface uses TCP/IP Ethernet for network connectivity to the CTI Server. You can use multi-protocol
IP routers to provide connectivity to CTI clients on other types of LANs. You can use the Ethernet interface
used for CTI client communication with the CTI Server for other purposes, such as the PG’s public network
interface; a dedicated interface is not required.

Note Do not use the PG private network for CTI communication.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
5
CTI Server Overview
Simplex/Duplex Configuration

Simplex/Duplex Configuration
In simplex configurations, there is one CTI Server on the local network with the CTI clients. In duplex
configurations, two CTI Servers are present. There may be other equipment (for example, ACDs) on the
network as well.

Figure 2: Typical Duplex Configuration Environment

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
6
CTI Server Overview
CTI Bridge Configuration

CTI Bridge Configuration


In CTI Bridge configurations, a CTI Bridge Client provides the connection between an existing CTI Application
and Unified CCE, as shown in this figure.

Figure 3: CTI Bridge to Existing CTI Application

CTI Bridge applications are interested in all call and agent state events that are occurring on the ACD. By
comparison, agent workstation applications are interested only in the events associated with a particular agent
device. The CTI Bridge application is a specially written program that converts or adapts the CTI messages
into another format, as needed. A single CTI Bridge application provides such translation services for multiple
agent desktops. The CTI Bridge application can be designed to interface with CTI Servers or similar applications
on systems that are already in use in the call center.
Some examples of CTI Bridge applications include:

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
7
CTI Server Overview
CTI Server Message Set

• Message converter applications. For example, an application may convert the CTI message set to the
message set of a foreign telephony server.
• Server-to-server communication applications. For example, an application may enable the CTI Server
to speak directly to a help desk application’s middle tier server.

CTI Server Message Set


The CTI Server makes call data available to applications in real time. To accomplish this task, the CTI Server
process responds to requests from clients and originates unsolicited messages. All messages share a common
message header and use the same set of data types.
This following table groups the messages into broad categories based on the nature of the message data.

Table 1: CTI Server Message Categories

Category Description
Session Management Messages related to the establishment and maintenance of a client
connection to the CTI Server.

Miscellaneous Messages related to system-level events on the PG (for example,


peripheral off-line, loss of PG-to-Central Controller communications).

Call Events Messages related to call state changes.

Agent Events Messages related to agent state changes.

Call Data Update Messages related to CTI client modification of call data.

Client Control Messages related to the direct control of agent state (for example, sign-in,
sign-out) and control of inbound and outbound calls.

Related Topics
Session Management, on page 33

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
8
CHAPTER 2
CTI Client Application Guidelines
• InvokeIDs, page 9
• Heartbeat Messages, page 9
• Generic vs ACD-Specific Applications, page 10
• Message Masks, page 10
• Message Order, page 10
• Definitions of Symbolic Constants, page 10
• Side AB Selection TCPIP Connections, page 11
• Alignment of Data Elements, page 11
• Incompatible Changes Reported Call ConnectionIDs, page 11
• CTI Operations During Unified CCE Failures, page 12

InvokeIDs
The CTI protocol provides an integer InvokeID field in each request message. This field is always returned
in the corresponding response message. You can set the Invoke ID to a unique value for each request you sent
to the server. This allows you to have multiple requests outstanding and to correctly determine which request’s
response has been received. For example, you can implement a simple counter that is incremented with each
request.

Heartbeat Messages
The Heartbeat Interval designates the time in seconds between sending heartbeat messages to the CTI Server.
A Heartbeat Interval of -1 disables heartbeats. The default setting for application developers is -1.
You must determine the appropriate heartbeat interval for a production environment -- it depends on the
application and the environment. It should represent a reasonable balance between the speed of failure detection
and the network bandwidth consumed by heartbeat messages and their corresponding confirmations.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
9
CTI Client Application Guidelines
Generic vs ACD-Specific Applications

In cases where there are very few CTI clients, such as a CTI Bridge, the minimum heartbeat interval of 5
seconds should suffice. Workstation (desktop) clients should use a much larger heartbeat interval (at least 90
seconds), since these clients typically number into the hundreds and possibly thousands. However, if the
TCP/IP time-out period is adequate, or if there is nothing the application can do even if it is aware that
something is wrong, it may be appropriate to disable heartbeats even in a production environment.

Generic vs ACD-Specific Applications


Although CTI Server provides a great deal of call event detail, be aware that the events reported and details
provided with each call event vary depending upon the type of ACD involved and possibly the specific software
version or other options configured. To remain completely generic and independent of the ACD type, the CTI
client should only utilize the BEGIN_CALL_EVENT, END_CALL_EVENT, and
CALL_DATA_UPDATE_EVENT messages.
In an object oriented model, you could use the BEGIN_CALL_EVENT message to construct an object that
represents this specific call and initializes its contents. Any subsequent call event messages operate on the
object and possibly change its state. Finally, you can use the END_CALL_EVENT to trigger any needed
cleanup operations and destruction of the call object.
When you need other call event messages to satisfy the application’s requirements, try to use as little event
data as possible other than the event type (message type). Your application will have fewer ACD specific
dependencies.
For a list of the basic differences between ACD types that are potentially visible to a CTI client, see the CTI
OS Developer Guide for Cisco Unified ICM/Contact Center Enterprise.

Message Masks
CTI Server can provide much more real-time data than the typical CTI client needs. The CTI Server provides
message masks to suppress the transmission of unneeded data and avoid wasting network bandwidth. You
should carefully consider the network impact of the expected number of simultaneously connected CTI clients
before deploying a CTI client application that unmasks a large number of messages.

Message Order
When an event occurs that would conceptually result in two or more event messages being generated at the
same time, the CTI client must be prepared to handle the messages arriving in any order. For example, an
agent answering an inbound call might generate both a CALL_ESTABLISHED_EVENT and an
AGENT_STATE_EVENT message. These may be received by a CTI client in either order, and other event
messages may be sent to the client in between. Also, since ACD event data is often obtained from multiple
sources, there can be a noticeable delay between event reports that logically occur at the same time.

Definitions of Symbolic Constants


The symbolic constants shown in tables in this document are available in a C include file, CTILink.h, that is
included with every CTI Gateway installation in the \icr\include directory.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
10
CTI Client Application Guidelines
Side AB Selection TCPIP Connections

Side AB Selection TCPIP Connections


The following algorithm establishes TCP/IP connections with the CTI Server. This algorithm attempts to
strike a balance between rapid reconnection following loss of connection and network saturation (due to
hundreds of clients attempting to connect simultaneously). The algorithm is terminated as soon as a successful
TCP/IP connection is achieved:
1 Attempt to connect to the same side as the last successful connection.
2 Attempt to connect to the opposite side.
3 Generate a random integer number N between 0 and the expected number of CTI clients divided by 10.
4 Wait for N seconds. This step helps avoid “rush hour” traffic when all clients at a site are reconnecting
simultaneously.
5 Attempt to connect to the same side as the last successful connection.
6 Attempt to connect to the opposite side.
7 Wait for 15 seconds.
8 Attempt to connect to the same side as the last successful connection.
9 Attempt to connect to the opposite side.
10 Wait for 30 seconds.
11 Attempt to connect to the same side as the last successful connection.
12 Attempt to connect to the opposite side.
13 Wait for 60 seconds.
14 Attempt to connect to the same side as the last successful connection.
15 Attempt to connect to the opposite side.
16 Wait for 120 seconds.
17 Repeat steps 14 – 16 until a connection is achieved.

Alignment of Data Elements


The messages described in this document are sent as a stream of bytes. If the CTI client application uses data
structures to represent the messages, be sure that the data structures do not have padding inserted to align
elements on particular boundaries, such as aligning 32-bit integers so that they are located on a 4-byte boundary.

Incompatible Changes Reported Call ConnectionIDs


In the early releases of CTI Server, there was a defect in the connectionID logic that caused a call's first
connectionID to be used as the connectionID in all subsequent call event messages, even when the event
referred to a different call connection. This sometimes presented CTI clients with ambiguous call event
messages, particularly when the call involved more than two parties.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
11
CTI Client Application Guidelines
CTI Operations During Unified CCE Failures

This defect no longer exists in CTI Server Protocol Version 5 and subsequent releases. However, existing
CTI client applications may be inadvertently dependent upon the old (incorrect) behavior and may no longer
function correctly even though they continue to use the older CTI Server protocol revision. You should retest
all CTI Server applications with the new release in a controlled environment prior to upgrading production
systems with the Unified CCE, to avoid any impact to normal business operations.
CTI applications that use only the BEGIN_CALL_EVENT, CALL_DATA_UPDATE_EVENT, and
END_CALL_EVENT call event messages may not require any changes. CTI applications that use the
ConnectionID field in any other call event messages will almost certainly be affected.
For further call ConnectionID details, see “Call Identification” in Chapter 3.

CTI Operations During Unified CCE Failures


The Unified CCE is fault tolerant and recovers from failures quickly, but certain types of failures are not
transparent and require consideration during application design:
• A failure of the active CTI Server causes all client connections to be closed. Clients may reconnect
immediately (to the other side’s CTI Server in duplex configurations, or to the restarted CTI Server in
simplex configurations), but clients will not receive messages for events that occurred while the client
session was not open. ClientEvent clients will receive a BEGIN_CALL_EVENT for all calls that are
already in progress when their session is opened.
• A failure of the data link or related software between the ACD and the Unified CCE will cause applications
not to receive event messages for the duration of the outage. This type of failure is reported to all CTI
clients via a SYSTEM_EVENT indicating that the peripheral (ACD) is offline. In addition, the Unified
CCE may take additional action depending upon the type of failure and the ACD involved. In many
cases, an END_CALL_EVENT will be sent immediately for every call that was in progress, even though
the actual voice calls may still be in progress. When normal operation is restored, calls that are in progress
may or may not have their call events reported, depending upon the particular type of ACD. If so, a new
BEGIN_CALL_EVENT is sent for each call that will have event reporting resumed. In other cases, the
calls will be allowed to linger for a short time after the failure without sending an END_CALL_EVENT.
If the data link is restored within the short time interval, normal call event reporting continues (although
events that occurred during the outage are not reported and the call may now be in a different state). If
normal operation is not restored within the allotted time an END_CALL_EVENT is then sent for each
call.
• A failure of the datalink between the Unified CCE Peripheral Gateway and the Central Controller does
not prevent event messages, however, the failure does prevent use of the Unified CCE post-routing and
translation-routing features.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
12
CHAPTER 3
Messaging Conventions
• CTI Message Convention, page 13
• Message Types, page 13
• Data Types, page 25
• Message Formats, page 28
• Floating Fields, page 29
• Invoke IDs, page 30
• Call Event Data, page 30
• Failure Indication Messages, page 32

CTI Message Convention


The CTI client and the CTI Server communicate by exchanging messages. Cisco’s CTI Server message set is
modeled after the Computer-Supported Telecommunications Applications (CSTA) messaging conventions
defined by the European Computer Manufacturers Association. CTI Server messages, in general, follow CSTA
naming conventions and the request/confirmation and unsolicited event paradigms. However, CTI Server
messages use a simpler set of data types than those defined by CSTA.
In the CSTA model, one party acts as a server and the other as a client. In the Cisco interface, as the names
suggest, the CTI client takes the client role and issues requests to the Unified CCE. The Unified CCE CTI
Server takes the server role, responding to requests from the CTI clients and originating unsolicited events.

Message Types
This table defines the complete CTI server message set. The messages are described in greater detail in the
remainder of this document. The length of the largest possible message (including the message header) defined
by this protocol is 4329 bytes.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
13
Messaging Conventions
Message Types

Table 2: Message Set

Number Message Type Purpose


1 FAILURE_CONF Negative confirmation; may be sent in response to
any request.

2 FAILURE_EVENT Unsolicited notification of a failure or error.

3 OPEN_REQ Communication session establishment request.

4 OPEN_CONF Communication session establishment confirmation.

5 HEARTBEAT_REQ Communication session maintenance request.

6 HEARTBEAT_CONF Communication session maintenance confirmation.

7 CLOSE_REQ Communication session termination request.

8 CLOSE_CONF Communication session termination confirmation.

9 CALL_DELIVERED_EVENT Notification of inbound call arrival.

10 CALL_ESTABLISHED_EVENT Notification of answering of inbound call.

11 CALL_HELD_EVENT Notification of call placed on hold.

12 CALL_RETRIEVED_EVENT Notification of call taken off hold.

13 CALL_CLEARED_EVENT Notification of call termination.

14 CALL_CONNECTION_CLEARED_EVENT Notification of the termination of a conference party


connection.

15 CALL_ORIGINATED_EVENT Notification of outbound call initiation.

16 CALL_FAILED_EVENT Notification of inability to complete call.

17 CALL_CONFERENCED_EVENT Notification of tandem connection of two calls.

18 CALL_TRANSFERRED_EVENT Notification of call transfer.

19 CALL_DIVERTED_EVENT Notification of call changing to a different service.

20 CALL_SERVICE_INITIATED_EVENT Notification of the initiation of telecommunications


service at a device (“dial-tone”).

21 CALL_QUEUED_EVENT Notification of call being placed in a queue pending


the availability of some resource.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
14
Messaging Conventions
Message Types

Number Message Type Purpose


22 CALL_TRANSLATION_ROUTE_EVENT Notification of call context data for a call that has
been routed to the peripheral by a translation route.

23 BEGIN_CALL_EVENT Notification that a call has been associated with the


CTI client.

24 END_CALL_EVENT Notification that a call is no longer associated with a


CTI client.

25 CALL_DATA_UPDATE_EVENT Notification of a change in a call’s context data.

26 SET_CALL_DATA_REQ Request to update one or more call variables or call


wrap-up data.

27 SET_CALL_DATA_CONF Response confirming a previous SET_CALL_DATA


request.

28 RELEASE_CALL_REQ Notification that all call data updates are complete.

29 RELEASE_CALL_CONF Response confirming a previous RELEASE_CALL


request.

30 AGENT_STATE_EVENT Notification of new agent state.

31 SYSTEM_EVENT Notification of a PG Status change.

32 CLIENT_EVENT_REPORT_REQ Request to report a CTI client event.

33 CLIENT_EVENT_REPORT_CONF Response confirming a previous


CLIENT_EVENT_REPORT request.

34 CALL_REACHED_NETWORK_EVENT Notification of outbound call being connected to the


network.

35 CONTROL_FAILURE_CONF Response indicating the failure of a proceeding


control request.

36 QUERY_AGENT_STATE_REQ Request to obtain the current state of an agent


position.

37 QUERY_AGENT_STATE_CONF Response to a QUERY_AGENT_STATE request.

38 SET_AGENT_STATE_REQ Request to alter the current state of an agent position.

39 SET_AGENT_STATE_CONF Response confirming a previous


SET_AGENT_STATE request.

40 ALTERNATE_CALL_REQ Request to alternate between a held and an active call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
15
Messaging Conventions
Message Types

Number Message Type Purpose


41 ALTERNATE_CALL_CONF Response confirming a previous
ALTERNATE_CALL request.

42 ANSWER_CALL_REQ Request to answer an alerting call.

43 ANSWER_CALL_CONF Response confirming a previous ANSWER_CALL


request.

44 CLEAR_CALL_REQ Request to release all devices from a call.

45 CLEAR_CALL_CONF Response confirming a previous CLEAR_CALL


request.

46 CLEAR_CONNECTION_REQ Request to release a single device from a call.

47 CLEAR_CONNECTION_CONF Response confirming a previous


CLEAR_CONNECTION request.

48 CONFERENCE_CALL_REQ Request to conference a held call with an active call.

49 CONFERENCE_CALL_CONF Response confirming a previous


CONFERENCE_CALL request.

50 CONSULTATION_CALL_REQ Request to hold an active call and start a new call.

51 CONSULTATION_CALL_CONF Response confirming a previous


CONSULTATION_CALL request.

52 DEFLECT_CALL_REQ Request to move an alerting call to a different device.

53 DEFLECT_CALL_CONF Response confirming a previous DEFLECT_CALL


request.

54 HOLD_CALL_REQ Request to place a call connection in the held state.

55 HOLD_CALL_CONF Response confirming a previous HOLD_CALL


request.

56 MAKE_CALL_REQ Request to start a new call between two devices.

57 MAKE_CALL_CONF Response confirming a previous MAKE_CALL


request.

58 MAKE_PREDICTIVE_CALL_REQ Request to start a new predictive call.

59 MAKE_PREDICTIVE_CALL_CONF Response confirming a previous


MAKE_PREDICTIVE_CALL request.

60 RECONNECT_CALL_REQ Request to clear a connection and retrieve a held call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
16
Messaging Conventions
Message Types

Number Message Type Purpose


61 RECONNECT_CALL_CONF Response confirming a previous
RECONNECT_CALL request.

62 RETRIEVE_CALL_REQ Request to reconnect a held call.

63 RETRIEVE_CALL_CONF Response confirming a previous RETRIEVE_CALL


request.

64 TRANSFER_CALL_REQ Request to transfer a held call to an active call.

65 TRANSFER_CALL_CONF Response confirming a previous TRANSFER_CALL


request.

66 to 77 Reserved Reserved

78 QUERY_DEVICE_INFO_REQ Request to obtain general device information.

79 QUERY_DEVICE_INFO_CONF Response to a previous QUERY_DEVICE_INFO


request.

80 to 81 Reserved Reserved

82 SNAPSHOT_CALL_REQ Request to obtain information about a specified call.

83 SNAPSHOT_CALL_CONF Response to a previous SNAPSHOT_CALL request.

84 SNAPSHOT_DEVICE_REQ Request to obtain information about a specified


device.

85 SNAPSHOT_DEVICE_CONF Response to a previous SNAPSHOT_DEVICE


request.

86 CALL_DEQUEUED_EVENT Notification of call being removed from a queue.

87 to 90 Reserved Reserved

91 SEND_DTMF_SIGNAL_REQ Request to send a sequence of DTMF tones.

92 SEND_DTMF_SIGNAL_CONF Response to a previous


SEND_DTMF_SIGNAL_REQ request.

93 MONITOR_START_REQ Request to start monitoring of a given call or device.

94 MONITOR_START_CONF Response to a previous MONITOR_START request.

95 MONITOR_STOP_REQ Request to terminate monitoring of a given call or


device.

96 MONITOR_STOP_CONF Response to a previous MONITOR_STOP request.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
17
Messaging Conventions
Message Types

Number Message Type Purpose


97 CHANGE_MONITOR_MASK_REQ Request to change the message masks of a given call
or device monitor.

98 CHANGE_MONITOR_MASK_CONF Response to a previous


CHANGE_MONITOR_MASK request.

99 CLIENT_SESSION_OPENED_EVENT Notification that a new CTI Client session has been


opened.

100 CLIENT_SESSION_CLOSED_EVENT Notification that a CTI Client session has been


terminated.

101 SESSION_MONITOR_START_REQ Request to start monitoring of a given CTI Client


session.

102 SESSION_MONITOR_START_CONF Response to a previous


SESSION_MONITOR_START request.

103 SESSION_MONITOR_STOP_REQ Request to terminate monitoring of a given CTI Client


session.

104 SESSION_MONITOR_STOP_CONF Response to a previous SESSION_MONITOR_STOP


request.

105 AGENT_PRE_CALL_EVENT Advance notification of a call routed to an Enterprise


Agent.

106 AGENT_PRE_CALL_ABORT_EVENT Cancellation of advance notification of a call routed


to an Enterprise Agent.

107 USER_MESSAGE_REQ Request to send a message to other CTI Server clients.

108 USER_MESSAGE_CONF Response to a previous USER_MESSAGE_REQ


request.

109 USER_MESSAGE_EVENT Notification of a message sent by another CTI Server


client.

110 REGISTER_VARIABLES_REQ Request to register call context variables used by


application.

111 REGISTER_VARIABLES_CONF Response to a previous


REGISTER_VARIABLES_REQ request.

112 QUERY_AGENT_STATISTICS_REQ Request for current agent call handling statistics.

113 QUERY_AGENT_STATISTICS_CONF Response to a previous


QUERY_AGENT_STATISTICS_REQ request.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
18
Messaging Conventions
Message Types

Number Message Type Purpose


114 QUERY_SKILL_GROUP_STATISTICS_REQ Request for current skill group call handling statistics.

115 QUERY_SKILL_GROUP_STATISTICS_CONF Response to a previous


QUERY_SKILL_GROUP_STATISTICS_REQ
request.

116 RTP_STARTED_EVENT Indicates that an RTP input has been started.

117 RTP_STOPPED_EVENT Indicates that an RTP input has been stopped.

118 SUPERVISOR_ASSIST_REQ An agent requests for assistance to their supervisor.

119 SUPERVISOR_ASSIST_CONF Response to a previous


SUPERVISOR_ASSIST_REQ request.

120 SUPERVISOR_ASSIST_EVENT Notification of a supervisor assist request sent by a


CTI Server client.

121 EMERGENCY_CALL_REQ An agent declaring an emergency situation to their


supervisor.

122 EMERGENCY_CALL_CONF Response to a previous EMERGENCY_CALL_REQ


request.

123 EMERGENCY_CALL_EVENT Notification of an emergency call request sent by a


CTI Server client.

124 SUPERVISE_CALL_REQ A supervisor request to perform monitor or barge-in


operations.

125 SUPERVISE_CALL_CONF Response to a previous SUPERVISE_CALL_REQ


request.

126 AGENT_TEAM_CONFIG_REQ Request sent by client to CTI Server, to change agent


team configuration.

127 AGENT_TEAM_CONFIG_CONF Response to a previous


AGENT_TEAM_CONFIG_REQ request.

128 AGENT_TEAM_CONFIG_EVENT Notification of passing the team member list.

129 SET_APP_DATA_REQ Request to update one or more application variables.

130 SET_APP_DATA_CONF Response confirming a previous SET_APP_DATA


request.

131 AGENT_DESK_SETTINGS_REQ Request to obtain Agent Desk Settings.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
19
Messaging Conventions
Message Types

Number Message Type Purpose


132 AGENT_DESK_SETTINGS_CONF Response to a previous
AGENT_DESK_SETTINGS_REQ request.

133 LIST_AGENT_TEAM_REQ Request to obtain a list of Agent Teams.

134 LIST_AGENT_TEAM_CONF Response to a previous LIST_AGENT_TEAM_REQ


request.

135 MONITOR_AGENT_TEAM_START_REQ Request to start monitoring an Agent Team.

136 MONITOR_AGENT_TEAM_START_CONF Response to a previous


MONITOR_AGENT_TEAM_START_REQ request.

137 MONITOR_AGENT_TEAM_STOP_REQ Request to stop monitoring an Agent Team.

138 MONITOR_AGENT_TEAM_STOP_CONF Response to a previous


MONITOR_AGENT_TEAM_STOP_REQ request.

139 BAD_CALL_REQ Request to mark a call as having poor voice quality.

140 BAD_CALL_CONF Response to a previous BAD_CALL_REQ request.

141 SET_DEVICE_ATTRIBUTES_REQ Request to set the default attributes of a calling device.

142 SET_DEVICE_ATTRIBUTES_CONF Response to a previous


SET_DEVICE_ATTRIBUTES_REQ request.

143 REGISTER_SERVICE_REQ Request to register service for the server application.

144 REGISTER_SERVICE_CONF Response to a previous REGISTER_SERVICE_REQ


request.

145 UNREGISTER_SERVICE_REQ Request to unregister service for the server


application.

146 UNREGISTER_SERVICE_CONF Response to a previous


UNREGISTER_SERVICE_REQ request.

147 START_RECORDING_REQ Request to start recording.

148 START_RECORDING_CONF Response to a previous START_RECORDING_REQ


request.

149 STOP_RECORDING_REQ Request to stop recording.

150 STOP_RECORDING_CONF Response to a previous STOP_RECORDING_REQ


request.

151 MEDIA_LOGIN_REQ Report agent sign in to MRD.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
20
Messaging Conventions
Message Types

Number Message Type Purpose


152 MEDIA_LOGIN_RESP Response to MEDIA_LOGIN_REQ.

153 MEDIA_LOGOUT_IND Report agent sign out from MRD.

154 MAKE_AGENT_ROUTABLE_IND Make agent routable for MRD request.

155 MAKE_AGENT_NOT_ROUTABLE_REQ Make agent not routable for MRD request.

156 MAKE_AGENT_NOT_ROUTABLE_RESP Response to


MAKE_AGENT_NOT_ROUTABLE_REQ.

157 MAKE_AGENT_READY_IND Report agent made ready.

158 MAKE_AGENT_NOT_READY_REQ Report agent made not ready.

159 MAKE_AGENT_NOT_READY_RESP Response to MAKE_AGENT_NOT_READY_REQ.

160 OFFER_TASK_IND Report agent has been offered task, agent selected by
Unified CCE.

161 OFFER_APPLICATION_TASK_REQ Report agent has been offered task, agent not selected
by Unified CCE.

162 OFFER_APPLICATION_TASK_RESP Response to OFFER_APPLICATION_TASK_REQ.

163 START_TASK_IND Report agent has begun task, agent selected by


Unified CCE.

164 START_APPLICATION_TASK_REQ Report agent has begun task, agent not selected by
Unified CCE.

165 START_APPLICATION_TASK_RESP Response to START_APPLICATION_TASK_REQ.

166 PAUSE_TASK_IND Report agent has paused task.

167 RESUME_TASK_IND Report agent has resumed task.

168 WRAPUP_TASK_IND Report agent has entered wrap-up for task.

169 END_TASK_IND Report agent has ended task.

170 AGENT_MADE_NOT_ROUTABLE_EVENT Notify client that agent made not routable for MRD.

171 AGENT_INTERRUPT_ADVISORY_EVENT Notify client that agent has been interrupted by


noninterruptible task.

172 AGENT_INTERRUPT_ACCEPTED_IND Report acceptance of the interrupt.

173 AGENT_INTERRUPT_UNACCEPTED_IND Report nonacceptance of the interrupt.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
21
Messaging Conventions
Message Types

Number Message Type Purpose


174 AGENT_INTERRUPT_DONE_ADVISORY_EVENT Notify client that interrupt has been ended.

175 AGENT_INTERRUPT_DONE_ACCEPTED_IND Report acceptance of interrupt end.

176 CHANGE_MAX_TASK_LIMIT_REQ Change the maximum number of simultaneous tasks


for the agent MRD combination.

177 CHANGE_MAX_TASK_LIMIT_RESP Response to CHANGE_MAX_TASK_LIMIT_REQ.

178 OVERRIDE_LIMIT_REQ Request a task assignment even though it would


exceed agent’s maximum number of simultaneous
tasks for the MRD.

179 OVERRIDE_LIMIT_RESP Response to OVERRIDE_LIMIT_REQ.

180 UPDATE_TASK_CONTEXT_IND Update Unified CCE task context.

181 BEGIN_AGENT_INIT_IND Report begin agent and task resynchronization.

182 AGENT_INIT_REQ Report agent’s current state.

183 AGENT_INIT_RESP Response to AGENT_INIT_REQ.

184 END_AGENT_INIT_IND Report end of agent and task resynchronization.

185 TASK_INIT_IND Report task’s state.

186 AGENT_INIT_READY_EVENT Notify client that Unified CCE is ready to receive


agent and task resynchronization messages.

187 GET_PRECALL_MESSAGES_REQ Request any pending PRE-CALL messages.

188 GET_PRECALL_MESSAGES_RESP Response to GET_PRECALL_MESSAGES_REQ.

189 AGENT_LEGACY_PRE_CALL_EVENT Current task context.

190 FAILURE_RESP Failure response to ARM indication messages.

191 BEGIN_TASK_EVENT Indicates that the specified task has entered the
system, either queued, offered, or begun.

192 QUEUED_TASK_EVENT Indicate that the specified task has been queued in
the router.

193 DEQUEUED_TASK_EVENT Indicate that the specified task has been dequeued
from the router.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
22
Messaging Conventions
Message Types

Number Message Type Purpose


194 OFFER_TASK_EVENT Indicates that the specified agent has been reserved
to handle the specified task.

195 START_TASK_EVENT Indicates that the specified agent has started handling
the task.

196 PAUSE_TASK_EVENT Indicates that the specified agent has temporarily


suspended handling of the specified task.

197 RESUME_TASK_EVENT Indicates that the specified agent has resumed


handling of the specified task after having previously
sent a Pause Task message.

198 WRAPUP_TASK_EVENT Indicates that the specified agent is no longer actively


handling the task but is doing followup work related
to the task.

199 END_TASK_EVENT Indicates that the specified agent has ended handling
of the specified task.

200 TASK_DATA_UPDATE_EVENT Update task context for the specified task.

201 TASK_MONITOR_START_REQ Request to start the task monitor with the task mask
in the request message.

202 TASK_MONITOR_START_CONF Response to TASK_MONITOR_START_REQ.

203 TASK_MONITOR_STOP_REQ Request to stop the task monitor with the monitor ID
in the request message.

204 TASK_MONITOR_STOP_CONF Response to TASK_MONITOR_STOP_REQ.

205 CHANGE_TASK_MONITOR_MASK_REQ Request to change the task monitor mask with the
new mask in the request message.

206 CHANGE_TASK_MONITOR_MASK_CONF Response to


CHANGE_TASK_MONITOR_MASK_REQ.

207 MAX_TASK_LIFETIME_EXCEEDED_EVENT Unified CCE terminated a task which had exceeded


its configured maximum lifetime. The result is
equivalent to the task ending due to an end task but
with a special reason code in the Termination Call
Detail record.

208 SET_APP_PATH_DATA_IND Set or update the application path-specific data


variables available to routing scripts.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
23
Messaging Conventions
Message Types

Number Message Type Purpose


209 TASK_INIT_REQ Report task’s state. Use this when a Unified CCE
taskID is not yet assigned to the task because the task
began when the ARM client interface was down.

210 TASK_INIT_RESP Response to the TASK_INIT_REQ message.

211 ROUTE_REGISTER_EVENT Register to receive route requests.

212 ROUTE_REGISTER_REPLY_EVENT Reply to registration message.

213 ROUTE_REQUEST_EVENT Route request for a destination for a call.

214 ROUTE_SELECT_EVENT Supplies a route destination for a route request.

215 ROUTE_END_EVENT End Routing dialog.

216 to 229 Reserved Reserved

230 CONFIG_REQUEST_KEY_EVENT Sent by client to CTI Server, to request configuration


keys for different items.

231 CONFIG_KEY_EVENT Response to previous


CONFIG_REQUEST_KEY_EVENT request.

232 CONFIG_REQUEST_EVENT Sent by client to CTI Server, to receive configuration.

233 CONFIG_BEGIN_EVENT Signifies the beginning of configuration

234 CONFIG_END_EVENT Signifies the end of configuration

235 CONFIG_SERVICE_EVENT Sent by the CTI Server to client, to update information


about a service or application.

236 CONFIG_SKILL_GROUP_EVENT Sent by the CTI Server to client, to update information


about skill group configuration.

237 CONFIG_AGENT_EVENT Request sent by the CTI Server to client, to update


information about agent.

238 CONFIG_DEVICE_EVENT Request sent by the CTI Server to client, to update


information about a device.

239 to 241 Reserved Reserved

242 TEAM_CONFIG_REQ Request sent by client to CTI server, to request team


configuration data.

243 TEAM_CONFIG_EVENT Response to previous TEAM_CONFIG_REQ request.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
24
Messaging Conventions
Data Types

Number Message Type Purpose


244 TEAM_CONFIG_CONF Sent by the CTI Server to client, to mark end of team
configuration data.

245 CONFIG_CALL_TYPE_EVENT Sent by the CTI server to client, to provide


information about a call type.

246 to 247 Reserved Reserved

248 CALL_AGENT_GREETING_EVENT Status Notification of Agent Greeting request.

249 AGENT_GREETING_CONTROL_REQ Stop the greeting that is playing; disable or enable


the Agent Greeting feature for this current sign-in
session.

250 AGENT_GREETING_CONTROL_CONF Confirmation of


AGENT_GREETING_CONTROL_REQ.

251 to 253 Reserved Reserved

254 CONFIG_MRD_EVENT Sent by the CTI server to client, to provide


information about a Media Routing Domain.

255 GET_AGENT_TASKS_REQ Request sent to obtain an agent's Tasks list in a


specified MRD. The message acts as an indication to
a PG that the client has reconnected; the PG then
recalculates the agent’s state based on the Tasks the
agent has. If there are no tasks, the agent state is
Not-Ready.

256 AGENT_TASKS_RESP Sent by the CTI Server to client, as a response to a


previous GET_AGENT_TASKS_REQ message.

257 SNAPSHOT_TASK_REQ Request sent to obtain information about a specified


agent's task.

258 SNAPSHOT_TASK_RESP Sent by the CTI Server to client, as a response to a


previous SNAPSHOT_TASK_REQ message.

259 Reserved Reserved

Data Types
This table lists the data types that define fields within messages. All numeric data longer than 1 byte are sent
in order of most significant byte to least significant byte. This is the canonical network byte order defined by
TCP/IP standards.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
25
Messaging Conventions
MHDR Data Type

Table 3: Data Types

Data Type Meaning Byte Size


CHAR Signed integer, –128 to 127. 1

UCHAR Unsigned integer, 0 to 255. 1

SHORT Signed integer, –32,768 to 32,767. 2

USHORT Unsigned integer, 0 to 65,535. 2

INT Signed Integer, –2,147,483,648 to 2,147,483,647. 4

UINT Unsigned Integer, 0 to 4,294,967,295. 4

BOOL Boolean (False = 0, True = 1). 2

STRING[n] ASCII string of length n. n

UNSPEC[n] Unspecified data occupying n consecutive bytes. n

TIME A date/time, expressed as the number of seconds since midnight 4


January 1, 1970 Coordinated Universal Time (UTC).

MHDR Message header 8

NAMEDVAR A named call context variable 3 … 251

NAMEDARRAY A named call context array element 4 … 252

TASKID Task group identifier 12

APPPATHID Application path identifier 5

MHDR Data Type


The MHDR data type is a common message header that precedes all messages exchanged between a CTI
client and the CTI Server. This table defines the message header format.

Table 4: Message Header (MHDR) Format

Field Name Value Data Type Byte Size


MessageLength The length of the message in bytes, excluding the size UINT 4
of the message header (the first 8 bytes).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
26
Messaging Conventions
NAMEDVAR Data Type

Field Name Value Data Type Byte Size


MessageType The type of message. This value determines the UINT 4
format of the remainder of the message.

NAMEDVAR Data Type


The NAMEDVAR data type is a call context variable that is defined in the Unified CCE
Expanded_Call_Variable_Table. This variable-length data type may appear in the floating part of a message
and has the format shown in this table:

Table 5: Named Call Context Variable (NAMEDVAR) Format

Subfield Value Data Type Max. Size


Tag NAMED_VARIABLE_TAG (= 82). The floating UCHAR 2
field tag that indicates that the following data is a
named call context variable.

FieldLength The total length of the VariableName and Variable UCHAR 2


Value fields, including the null-termination bytes.
The value of this field may range from 3 to 251.

VariableName The null-terminated defined name of the variable. STRING 33

VariableValue The null-terminated value of the variable. STRING 211

NAMEDARRAY Data Type


The NAMEDARRAY data type is a call context variable that is defined in the Unified CCE
Expanded_Call_Variable_Table. This variable length data type may appear in the floating part of a message
and has the format shown in this table:

Table 6: Named Call Context Array Variable (NAMEDARRAY) Format

Subfield Value Data Type Max. Size


Tag NAMED_ARRAY_TAG (= 83). The floating field UCHAR 2
tag that indicates that the following data is a named
call context array variable.

FieldLength The total length of the VariableIndex, Variable Name, UCHAR 2


and VariableValue fields, including the
null-termination bytes. The value of this field may
range from 4 to 252.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
27
Messaging Conventions
TASKID Data Type

Subfield Value Data Type Max. Size


VariableIndex The index of the array variable. UCHAR 1

VariableName The null-terminated defined name of the array STRING 33


variable.

VariableValue The null-terminated value of the array variable. STRING 211

TASKID Data Type


This table defines the TASKID field format.

Table 7: TASKID Format

Field Name Value Data Type Byte Size


TaskGroupHigh The most significant 4 bytes of the Task Group ID. INT 4
The Task Group ID links multiple Termination Call
Detail (TCD) records together for reporting purposes.
Use this when the same customer interaction involves
multiple tasks over time. For example, this might
happen if an agent stops the work and then another
agent restarts it.

TaskGroupLow The least significant 4 bytes of the Task Group ID. INT 4

SequenceNumber The Task Group ID is unchanged for the lifetime of INT 4


all tasks that are related to the group. The combination
of Task Group ID and Sequence Number is unique
for every termination record.

Message Formats
Messages contain either a fixed part only or a fixed part and a floating part. The fixed part of a message
contains the message header and all required, fixed length fields. The variable part of a message immediately
follows the fixed part. It contains one or more floating fields that are optional and/or variable in length. The

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
28
Messaging Conventions
Floating Fields

message type field in the message header determines the format of the message, and therefore indicates if the
message includes a floating part and what types of floating fields may appear within it.

Figure 4: CTI Server Message Format

Floating Fields
Each floating field has the same format. The field begins with a two-byte tag, which identifies the field type.
Following the tag is a two-byte field length, which indicates the number of bytes of data in the field (excluding
the tag and field length). The data immediately follows the FieldLength. The maximum size listed for each
floating field is the maximum number of data bytes allowed. It does not include the tag and field length bytes.
For string data, it includes the null termination byte.
Floating fields are packed together in the floating part of the message. The tag of one floating field immediately
follows the data of the previous field. The message length (in the message header) indicates the end of the
message. This figure shows the format of a floating field.

Figure 5: CTI Server Floating Field Format

Within the floating part, floating fields may appear in any order. In general, each floating field appears only
once unless the field is a member of a list. In this case, a fixed field in the message indicates the number of
list entries present. This table defines the format of the floating field:

Table 8: Floating Field Subfields

Subfield Value Data Type Byte Size


Tag The type of the floating field USHORT 2

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
29
Messaging Conventions
Invoke IDs

Subfield Value Data Type Byte Size


FieldLength The number of bytes, n, in the Data subfield of the USHORT 2
floating field.

Data The data Depends on n


field type

For a list of possible floating field tag values, see the Tag Values table.

Related Topics
Tag Values, on page 252

Invoke IDs
All request messages that can be sent to the CTI Server contain a field called the InvokeID. The InvokeID
value is returned in the corresponding response message to the CTI client. A CTI client usually places a value
in this field that enables it to associate a received response with the corresponding request. Typically, this is
simply a counter that is incremented as each request message is sent.

Call Event Data


The Cisco CTI Interface presents Call Event data using a CSTA-like model; however, the underlying ACD
datalink may or may not conform to this model. This means that, depending upon the type of ACD being
used, some Call Event messages may not be generated, and some of the CSTA message data for other events
may not be available. Be aware that the interpretation of Call Event data is very peripheral-specific, particularly
when multiple ACD types are being used.
For a discussion of peripheral-specific considerations, see the CTI OS Developer Guide for Cisco Unified
ICM/Contact Center Enterprise.

Device IDs
The Call Event messages detailed later in this document typically provide several different device ID fields.
Depending upon the type of peripheral and the nature of the event, the device ID may represent a Trunk
number, a Trunk Group number, or an agent teleset number (extension). Some peripheral types may not
provide a device ID for one or more fields. To handle these situations, the Call Event messages provide device
IDs using two fields: a fixed field indicating whether or not the device ID was provided and enumerating the
type of device identified, and a floating field containing the device ID (if provided).

CTI Client History


The Call Event messages also provide a list of CTI clients associated with the current call (if any). This
information is provided using a separate floating field for each CTI client in the list, and a fixed field providing
a count of the number of entries in the list. Each list entry’s floating field uses the same tag value.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
30
Messaging Conventions
Event Cause Codes

Event Cause Codes


Most Call Event messages include an EventCause fixed field that may provide a reason for the occurrence of
the event. Usually no event cause information is supplied (CEC_NONE).
For a list of EventCause codes that may be reported, see the EventCause Values table.

Related Topics
EventCause Values, on page 269

Call Identification
CTI Server uses the CSTA method of identifying calls. A numeric ConnectionCallID identifies a call; each
connection of a device to that call is identified by a ConnectionDeviceID string and an enumerated
ConnectionDeviceIDType value. All call related messages identify the ConnectionCallID as well as the
ConnectionDeviceIDType and ConnectionDeviceID of the call connection that is the subject of the event.

Figure 6: Sample CSTA Call/Device/ConnectionID Values

A ConnectionDeviceID uniquely identifies a call connection. However, it cannot directly identify the connected
device; use other event message fields for that purpose. In some cases, the ConnectionDeviceID may simply
be the ID of the connected device, the connected deviceID with additional identifying data included, or a
string that does not contain the deviceID at all. A valid CTI Server application can make no assumption about
the content or format of a ConnectionDeviceID.
Occasionally, both the ConnectionDeviceID and the numeric ConnectionCallID are required in order to
properly identify the subject call. This occurs when the ACD uses the ConnectionCallID value from an ACD
call as the ConnectionCallID value for any related consultative calls. This poses two particularly significant
requirements for applications: they must be able to keep track of two calls with the same numeric
ConnectionCallID value, and they must be able to decide which of the two calls is being referenced by any
given call event message. These requirements are relatively easy to implement by keeping track of the
ConnectionDeviceIDs associated with each call. The call that has a ConnectionDeviceID that matches the
ConnectionDeviceID provided in the call event message is the call that is the subject of the event. The only
difficult case is determining which call is the subject when a new call connection is created. For this case, the
following rule applies:

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
31
Messaging Conventions
Failure Indication Messages

• When more than one call with the same ConnectionCallID value exists, the connection being created
by a CALL_ESTABLISHED_ EVENT shall apply to the call that does not yet have a destination
connection established.

Typically, when this occurs, one call will have been the subject of a prior CALL_ESTABLISHED_EVENT
and will have two connections; the other will have only one originating connection. The
CALL_ESTABLISHED_EVENT will therefore create the second connection on that call. It should never be
the case that both calls have already been the subject of a CALL_ESTABLISHED_EVENT.

Failure Indication Messages


The CTI Server may indicate errors to the CTI client using the FAILURE_CONF and FAILURE_EVENT
messages. The CTI Server may use the FAILURE_CONF message in response to any request message from
the CTI client. The CTI Server sends the FAILURE_CONF message instead of the positive confirmation
message specific to the request. The format of the FAILURE_CONF message is defined in this table:

Table 9: FAILURE_CONF Message Format

Field Name Value Data Type Byte Size


MessageHeader Standard message header. MessageType = 1. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

Status A status code indicating the cause of the failure. The UINT 4
possible status codes are defined in the Failure
Indication Message status code table.

The CTI Server may use the FAILURE_EVENT message to asynchronously indicate a failure or error condition
to the CTI client. The format of the FAILURE_EVENT message is defined in this table:

Table 10: FAILURE_EVENT Message Format

Field Name Value Data Type Byte Size


MessageHeader Standard message header. MessageType = 2. MHDR 8

Status A status code indicating the cause of the failure. The UINT 4
possible status codes are defined in the Failure
Indication Message status code table.

Related Topics
Failure Indication Message Status Codes, on page 244

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
32
CHAPTER 4
Session Management
• Configuring TCPIP Transport Services, page 33
• Connection Management, page 33
• Session Initialization, page 34
• Session Maintenance, page 44
• Session Termination, page 45

Configuring TCPIP Transport Services


TCP/IP transport services are used in CTI client/server communications. From the Windows Socket interface,
enable the TCP “linger” option and set it to zero to close TCP connections immediately upon request without
waiting for previously transmitted data to be acknowledged. This ensures that communications can be
re-established quickly after a failure.
If possible, disable the Nagle transmit delay algorithm of TCP to ensure timely delivery of all data. (Disabling
the Nagle algorithm is sometimes referred to as the TCP_NODELAY option.) Disabling this algorithm ensures
that messages are always transmitted immediately upon request.

Connection Management
You should configure the CTI clients with two sets of hostname/port number pairs; one for the IP address and
TCP port number of the CTI Server on side “A” and the other for the corresponding CTI Server on side “B”.
The CTI clients should alternately attempt to connect to each side until a connection is established. Once a
connection between the CTI client and the CTI Server has been established, the connection remains in place
until a failure occurs or the client closes the connection. Connection failures may be detected by the TCP layer
or by the heartbeat message mechanism described later in this chapter. If a failure occurs, the CTI client should
again alternately attempt to establish a connection to either side until a new connection is established.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
33
Session Management
Session Initialization

Session Initialization
Once a TCP connection has been established, you can attempt to initialize a communications session by
sending an OPEN_REQ message to the CTI Server. The CTI Server responds with an OPEN_CONF message
to confirm the successful establishment of a session. This figure depicts the message flow.

Figure 7: Session Initialization Message Flow

CTI Service Masks


This table shows the CTIService masks.

Table 11: CTI Service Masks

MaskName Description Value


CTI_SERVICE_DEBUG Causes all messages exchanged 0x80000000
during the current session to be
captured to a file for later
analysis.

CTI_SERVICE_CLIENT_EVENTS Client receives call and agent 0x00000001


state change events associated
with a specific ACD phone.

CTI_SERVICE_CALL_DATA_UPDATE Client may modify call context 0x00000002


data.

CTI_SERVICE_CLIENT_CONTROL Client may control calls and 0x00000004


agent states associated with a
specific ACD phone.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
34
Session Management
CTI Service Masks

MaskName Description Value


CTI_SERVICE_CONNECTION_MONITOR Establishment and termination 0x00000008
of this session cause
corresponding Unified CCE
Alarm events to be generated.

CTI_SERVICE_ALL_EVENTS Client receives all call and agent 0x00000010


state change events (associated
with any ACD phone).

CTI_SERVICE_PERIPHERAL_MONITOR Client may dynamically add and 0x00000020


remove devices and calls for
which it wishes to receive call
and agent state events.

CTI_SERVICE_CLIENT_MONITOR Client receives notification when 0x00000040


all other CTI client sessions are
opened and closed, and may
monitor the activity of other CTI
client sessions.

CTI_SERVICE_SUPERVISOR Client may request supervisor 0x00000080


services.

CTI_SERVICE_SERVER Client identifies itself as server 0x00000100


application.

CTI_SERVICE_AGENT_REPORTING Client may request reporting and 0x00000400


routing ARM(Agent Reporting
And Management) messages.

CTI_SERVICE_ALL_TASK_EVENTS Client receives all task events. 0x00000800

CTI_SERVICE_TASK_MONITOR Client receives monitored task 0x00001000


events.

CTI_AGENT_STATE_CONTROL_ONLY Client can change agent state 0x00002000


only. Call control is not allowed.
If a client requests for
CTI_SERVICE_CLIENT_CONTROL,
the server may grant this flag to
indicate that only agent state
change is allowed.

Unused 0x00004000

CTI_DEVICE_STATE_CONTROL The client/server wishes to 0x00008000


register and get resource state
change requests

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
35
Session Management
OPEN_REQ Message

MaskName Description Value


CTI_SERVICE_UPDATE_EVENTS Requests that this client receive 0x00080000
update notification events. (No
data)

CTI_SERVICE_IGNORE_DUPLICATE_AGENT_EVENTS Request to suppress duplicate 0x00100000


agent state events.

CTI_SERVICE_IGNORE_CONF Do not send confirmations for 0x00200000


third-party requests.

CTI_SERVICE_ACD_LINE_ONLY Request not to send events for 0x00400000


non-ACD lines. (Unified CCE
only)

OPEN_REQ Message
This table defines the OPEN_REQ message.

Table 12: OPEN_REQ Message Format

Field Name Value Data Byte Size


Type
Fixed Part

MessageHeader Standard message header. MessageType = 3. MHDR 8

InvokeID An ID for this request message, to be returned in the UINT 4


corresponding confirm message.

VersionNumber The version number of the interface requested by the UINT 4


CTI client. This defines the version of all messages in
the message set.

IdleTimeout The session idle timer, expressed in seconds. If the UINT 4


session is idle (no messages received) for this time, the
CTI Server resets the TCP connection and awaits the
establishment of a new session. This value is typically
4 times the heartbeat interval used by the CTI client. If
the CTI client does not use the HEARTBEAT_REQ
message, set this field to 0xFFFFFFFF.

PeripheralID The Peripheral ID of the ACD whose events are of UINT 4


interest to the client. Required for Client Events service;
otherwise, set this field to the special value NULL_
PERIPHERAL_ID.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
36
Session Management
OPEN_REQ Message

Field Name Value Data Byte Size


Type
ServicesRequested A bitwise combination of the CTI Services listed in that UINT 4
the CTI client is requesting.

CallMsgMask A bitwise combination of the Unsolicited Call Event UINT 4


Message Masks listed that the CTI client wishes to
receive.

AgentStateMask A bitwise combination of Agent State Masks that the UINT 4


CTI client wishes to receive.

ConfigMsgMask A bitwise combination of Configuration Event Masks UINT 4


that the CTI client wishes to receive.
For bit mask values, see the
CONFIG_REQUEST_EVENT message
ConfigInformation field.

Reserved1 Reserved for future use; set to zero. UINT 4

Reserved2 Reserved for future use; set to zero. UINT 4

Reserved3 Reserved for future use; set to zero. UINT 4

Floating Part

ClientID (required) The user ID of the CTI client. STRING 64

ClientPassword The password of the user identified by ClientID. UNSPEC 64


(required) ClientID and Client Password are optionally used to
authenticate the CTI client making the session open
request. This field must be present even if authentication
is not being used (it may be of length zero).

ClientSignature A character string appended to the Call Client History STRING 64


(optional) list when this CTI client becomes associated with a call.
If not provided, the ClientID is used.

AgentExtension The agent’s ACD teleset extension. For CLIENT STRING 16


EVENTS service, the CTI Client must provide at least
one of AgentExtension, AgentID, or AgentInstrument.

AgentID The agent’s ACD sign-in ID. For CLIENT EVENTS STRING 12
service, the CTI Client must provide at least one of
AgentExtension, AgentID, or AgentInstrument.

AgentInstrument The agent’s ACD instrument number. For CLIENT STRING 64


EVENTS service, the CTI Client must provide at least
one of AgentExtension, AgentID, or AgentInstrument.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
37
Session Management
OPEN_REQ Message

Field Name Value Data Byte Size


Type
ApplicationPathID The ID of an application path which contains configured INT 4
MRD Peripheral combinations for this Unified
CCE-configured application instance.

Related Topics
CONFIG_REQUEST_EVENT, on page 230

Unsolicited Call Event Message Masks


This table lists the unsolicited call event message masks.

Table 13: Unsolicited Call Event Message Masks

Mask Name Description Value


CALL_DELIVERED_MASK Set when client wishes to receive 0x00000001
CALL_DELIVERED_EVENT messages.

CALL_QUEUED_MASK Set when client wishes to receive 0x00000002


CALL_QUEUED_EVENT messages.

CALL_ESTABLISHED_MASK Set when client wishes to receive 0x00000004


CALL_ESTABLISHED_EVENT messages.

CALL_HELD_MASK Set when client wishes to receive 0x00000008


CALL_HELD_EVENT messages.

CALL_RETRIEVED_MASK Set when client wishes to receive 0x00000010


CALL_RETRIEVED_EVENT messages.

CALL_CLEARED_MASK Set when client wishes to receive 0x00000020


CALL_CLEARED_EVENT messages.

CALL_CONNECTION_CLEARED_MASK Set when client wishes to receive 0x00000040


CALL_CONNECTION_CLEARED_EVENT
messages.

CALL_ORIGINATED_MASK Set when client wishes to receive 0x00000080


CALL_ORIGINATED_EVENT messages.

CALL_CONFERENCED_MASK Set when client wishes to receive 0x00000100


CALL_CONFERENCED_EVENT
messages.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
38
Session Management
OPEN_REQ Message

Mask Name Description Value


CALL_TRANSFERRED_MASK Set when client wishes to receive 0x00000200
CALL_TRANSFERRED_EVENT messages.

CALL_DIVERTED_MASK Set when client wishes to receive 0x00000400


CALL_DIVERTED_EVENT messages.

CALL_SERVICE_INITIATED_MASK Set when client wishes to receive 0x00000800


CALL_SERVICE_INITIATED_EVENT
messages.

CALL_TRANSLATION_ROUTE_MASK Set when client wishes to receive 0x00001000


CALL_TRANSLATION_ROUTE_EVENT
messages.

BEGIN_CALL_MASK Set when client wishes to receive 0x00002000


BEGIN_CALL_EVENT messages.

END_CALL_MASK Set when client wishes to receive 0x00004000


END_CALL_EVENT messages.

CALL_DATA_UPDATE_MASK Set when client wishes to receive 0x00008000


CALL_DATA_UPDATE_EVENT
messages.

CALL_FAILED_MASK Set when client wishes to receive 0x00010000


CALL_FAILED_EVENT messages.

CALL_REACHED_NETWORK_MASK Set when client wishes to receive 0x00020000


CALL_REACHED_NETWORK_EVENT
messages.

CALL_DEQUEUED_MASK Set when client wished to receive 0x00040000


CALL_DEQUEUED_EVENT messages.

AGENT_PRE_CALL_MASK Set when client wished to receive 0x00080000


AGENT_PRE_CALL_EVENT messages.

AGENT_PRE_CALL_ABORT_MASK Set when client wished to receive 0x00100000


AGENT_PRE_CALL_ABORT_EVENT
messages.

RTP_STARTED_MASK Set when client wished to receive 0x00200000


RTP_STARTED_EVENT messages.

RTP_STOPPED_MASK Set when client wished to receive 0x00400000


RTP_STOPPED_MASK_EVENT messages.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
39
Session Management
OPEN_REQ Message

Mask Name Description Value


AGENT_TEAM_CONFIG_MASK Set when client wished to receive 0x00800000
AGENT_TEAM_CONFIG_MASK_EVENT
messages.

AGENT_LEGACY_PRE_CALL_MASK Set when client wishes to receive 0x01000000


AGENT_LEGACY_PRE_CALL_EVENT
messages.

CALL_ATTRIBUTE_CHANGE_MASK CALL_ATTRIBUTE_CHANGE_EVENT 0x02000000


messages.

CALL_TERMINATION_MASK Reserved 0x04000000

CALL_AGENT_GREETING_MASK Set when client wishes to receive 0x08000000


CALL_AGENT_GREETING_EVENT
messages.

Agent State Masks


This table lists the agent state masks.

Table 14: Agent State Masks

Mask Name Description Value


AGENT_LOGIN_MASK Set when client wishes to receive “login” 0x00000001
AGENT_STATE_EVENT messages.

AGENT_LOGOUT_MASK Set when client wishes to receive “logout” 0x00000002


AGENT_STATE_EVENT messages.

AGENT_NOT_READY_MASK Set when client wishes to receive “not ready” 0x00000004


AGENT_STATE_EVENT messages.

AGENT_AVAILABLE_MASK Set when client wishes to receive “available” 0x00000008


AGENT_STATE_EVENT messages.

AGENT_TALKING_MASK Set when client wishes to receive “talking” 0x00000010


AGENT_STATE_EVENT messages.

AGENT_WORK_NOT_READY_MASK Set when client wishes to receive “work not ready” 0x00000020
AGENT_STATE_EVENT messages.

AGENT_WORK_READY_MASK Set when client wishes to receive “work ready” 0x00000040


AGENT_STATE_EVENT messages.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
40
Session Management
OPEN_CONF Message

Mask Name Description Value


AGENT_BUSY_OTHER_MASK Set when client wishes to receive “busy other” 0x00000080
AGENT_STATE_EVENT messages.

AGENT_RESERVED_MASK Set when client wishes to receive “reserved” 0x00000100


AGENT_STATE_EVENT messages.

AGENT_HOLD_MASK Set when client wishes to receive “hold” 0x00000200


AGENT_STATE_EVENT messages.

OPEN_CONF Message
This table defines the OPEN_CONF message.

Table 15: OPEN_CONF Message Format

Field Name Value Data Type Byte Size


Fixed Part

MessageHeader Standard message header. MessageType MHDR 8


= 4.

InvokeID Set to the value of the InvokeID from UINT 4


the corresponding OPEN_REQ message.

ServicesGranted A bitwise combination of the CTI UINT 4


Services listed in that the CTI client has
been granted. Services granted may be
less than those requested.

MonitorID The identifier of the event monitor UINT 4


created by the OPEN_REQ, or zero if
no monitor was created.

PGStatus The current operational status of the UINT 4


Peripheral Gateway. Any nonzero
indicates a component failure or
communication outage that prevents
normal CTI operations.

ICMCentral ControllerTime The current Central Controller date and TIME 4


time.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
41
Session Management
OPEN_CONF Message

Field Name Value Data Type Byte Size


PeripheralOnline The current Unified CCE on-line status BOOL 2
of the agent’s peripheral, when Client
Events service has been granted.
Otherwise, set this value to TRUE only
when all peripherals monitored by the
PG are on-line.

PeripheralType The value is set as the first condition that USHORT 2


applies:
1 Type of the peripheral that matches
with the PeripheralID (if client sends
the PeripheralID in the OPEN_REQ)
in the OPEN_REQ.
2 For the ClientEvents service clients,
the type of the peripheral to which
the agent belongs.
(CTI_SERVICE_CLIENT_EVENTS
gets the agent information from the
OPEN_REQ.)
3 If none of the above is present, the
type of the agent peripheral that is
configured in the PG for that CTI
Server.
Note Unified CCE does not
support multiple agent
peripherals on one PG. For
such an unsupported
configuration, the
PeripheralType that is
chosen might be incorrect.

AgentState The current state of the associated agent USHORT 2


phone (Client Events Service only).

DepartmentID Department ID of the Agent INT 4

Floating Part

AgentExtension (Client The agent’s ACD device extension, STRING 16


Events Service Only) when Client Events service has been
granted and the agent is currently signed
in on the ACD.

AgentID (Client Events The agent’s ACD sign-in ID, when STRING 12
Service Only) Client Events service has been granted
and the agent is currently signed in on
the ACD.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
42
Session Management
OPEN_CONF Message

Field Name Value Data Type Byte Size


AgentInstrument (Client The agent’s ACD instrument number, STRING 64
Events Service Only) when Client Events service has been
granted and the agent is currently signed
in on the ACD.

NumPeripherals The number of PeripheralID/info USHORT 2


(FltPeripheralID/MultilineAgentControl)
pairs specified in the floating part of the
message. This field is 0 for non-CCE
peripherals, or if PeripheralID is
specified in the OPEN_REQ message.

FltPeripheralID The peripheralID for the next field UINT 4


(MultilineAgentControl).

MultilineAgentControl Specifies if multiline agent control is USHORT 2


available on the peripheral named in the
preceding FltPeripheralID field. 0 =
single line only, 1 = multiline enabled.

If the CTI Server determines that a new session should not be opened, it responds to the OPEN_REQ message
with a FAILURE_CONF message. If necessary floating data has not been provided, a FAILURE_CONF
message is returned with the status code set to E_CTI_REQUIRED_DATA_MISSING.
A CTI client might try to open a session for Client Events service and the provide device information items
that are inconsistent with each other. Then, a FAILURE_CONF message is returned with the status code set
to E_CTI_INCONSISTENT_AGENT_DATA. If the ACD device is already associated with a different CTI
client, the CTI Server refuses to open the new session and returns a FAILURE_CONF message. The status
code in the message is set to E_CTI_DEVICE_IN_USE. If the ACD device is already associated with the
same CTI client, the existing session is terminated and the CTI Server opens the new session.
During an OPEN_REQ of an ALL_EVENTS client session, the CTI Server responds with an OPEN_CONF
message to confirm the successful establishment of a session. In addition to the OPEN_CONF,
SYSTEM_EVENT messages are sent to the ALL_EVENTS client, per peripheral, to indicate the status of
each peripheral associated with the PG.
If the CTI Server rejects an OPEN_REQ message, reset the TCP connection. The status code received in the
rejection indicates the message data to correct before retrying to establish a session.
Normally, you receive a response to the OPEN_REQ message within 5 seconds. Some failure scenarios cause
all connected CTI clients to lose their connection to the CTI Server. This causes them to then reconnect and
reopen their sessions. In the worst case situations, there could be hundreds or even thousands of simultaneous
OPEN_REQ messages sent to the CTI Server, causing significant response delays. For this reason, allow at
least 30 seconds before considering a lack of response to the OPEN_REQ message as a failure to open the
session. In larger configurations of more than 500 clients, allow 60 seconds or more. Then reset the TCP
connection, reconnect, and retry the OPEN_REQ after a short delay.

Related Topics
Constants and Status Codes, on page 243

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
43
Session Management
Session Maintenance

Session Maintenance
Compared to some other protocols, TCP/IP is relatively slow at detecting and recovering from communication
path failures. If an IP packet is dropped within the network, retransmission does not occur until the sender
notices a time-out. This time-out period is long enough to allow for worst-case round-trip delays and network
congestion. If you need more rapid error detection, you may send an optional HEARTBEAT_REQ message
to the CTI Server whenever no heartbeat interval messages have been sent. Upon receipt of a
HEARTBEAT_REQ message, the CTI Server immediately responds with a HEARTBEAT_CONF message.
If three heartbeats go unconfirmed, the CTI client declares a session failure and resets the TCP connection.
You determine the appropriate heartbeat interval for a production environment—It depends on the application
and the environment. Find a reasonable balance between the speed of failure detection and the network
bandwidth consumed by heartbeat messages and confirmations. In cases with few CTI clients, such as a CTI
Bridge, the minimum heartbeat interval of 5 seconds should suffice. Workstation (desktop) clients usually
need a larger heartbeat interval (at least 90 seconds), since there are typically hundreds or thousands of clients.
A Heartbeat Interval of –1 disables heartbeats. The default setting for application developers is –1. However,
if the TCP/IP time-out period is adequate or if the application can do nothing during a failure, you can choose
to disable heartbeats in a production environment.
This figure depicts the heartbeat message flow.

Figure 8: Heartbeat Message Flow

This table defines the HEARTBEAT_REQ message:

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
44
Session Management
Session Termination

Table 16: HEARTBEAT_REQ Message Format

Field Name Value Data Type Byte Size


MessageHeader Standard message header. MessageType = 5. MHDR 8

InvokeID An ID for this request message, to be returned in the UINT 4


corresponding confirm message.

This table defines the HEARTBEAT_CONF message:

Table 17: HEARTBEAT_CONF Message Format

Field Name Value Data Type Byte Size


MessageHeader Standard message header. MessageType = 6. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding HEARTBEAT_REQ message.

The CTI Server does not begin HEARTBEAT_REQ messages. The CTI Server detects failures using the
IdleTimeout value from the OPEN_REQ message. If you are using heartbeat messages, the CTI client should
set the IdleTimeout value to four times the heartbeat interval. If the CTI Server receives no messages (including
HEARTBEAT_REQ messages) for this period, the CTI Server declares a session failure and resets the TCP
connection.
The CTI Server may respond to a HEARTBEAT_REQ message with a FAILURE_CONF. This indicates to
the CTI client that the CTI Server is off-line, and the CTI client resets the TCP connection.

Session Termination
The CTI client may begin the graceful termination of a communication session by sending a CLOSE_REQ
message. The CTI Server responds with a CLOSE_CONF message. Upon receipt of the CLOSE_CONF
message, the CTI client can reset the TCP connection. The CTI client should wait up to 5 seconds for the
CLOSE_CONF message before resetting the connection.
The CTI Server may indicate that it no longer wishes to communicate with the client through an unsolicited
FAILURE_EVENT message. The Status field in the message is set to E_CTI_CTI_SERVER_OFFLINE.
Upon receipt of this message, the CTI client closes the session.
The CLOSE_REQ message includes a status code that indicates the reason for closing the session. You can
set the status code to one of the following:
• E_CTI_NO_ERROR—If the CTI client began the request to end the session.
• E_CTI_CTI_SERVER_OFFLINE—If the CTI Server is no longer online.
• E_CTI_TIMEOUT—If the CTI Server does not respond to a request message within the time-out period.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
45
Session Management
Session Termination

The following figure describes the Session Termination Message Flow:

Figure 9: Session Termination Message Flow

This table defines the CLOSE_REQ message:

Table 18: CLOSE_REQ Message Format

Field Name Value Data Type Byte Size


MessageHeader Standard message header. MessageType = 7. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

Status A status code indicating the reason for closing the UINT 4
session.

This table defines the CLOSE_CONF message:

Table 19: CLOSE_CONF Message Format

Field Name Value Data Type Byte Size


MessageHeader Standard message header. MessageType = 8. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding CLOSE_REQ message.

Related Topics
Failure Indication Messages, on page 32

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
46
CHAPTER 5
Application Level Interfaces
• CTI Server Application Level Interfaces, page 47
• Client Events Service, page 48
• All Events Service, page 97
• Peripheral Monitor Service, page 99
• Client Monitor Service, page 104
• Supervisor Service, page 109
• Call Data Update Service, page 120
• Miscellaneous Service, page 127
• Connection Monitor Service, page 169
• Client Control Service, page 169
• Server Service, page 225
• Configuration Acquisition Messages, page 227

CTI Server Application Level Interfaces


Cisco has defined the following application level interfaces between the CTI Server and a CTI client.
Client Events
This service provides real-time call and agent state change, and status information related to a specific
ACD agent position, to a CTI client.

All Events
This service provides real-time call and agent state change, and status information for all ACD calls
and agent positions, to a CTI client.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
47
Application Level Interfaces
Client Events Service

Peripheral Monitor
This service lets a CTI client dynamically change the list of calls and devices that it wishes to receive
call and agent state change messages for.

Client Monitor
This service lets a CTI client receive notifications whenever any other CTI Client session is opened or
closed. This service also enables the CTI Client to monitor the activity of other CTI Client sessions.

Supervisor
This service lets a CTI client perform agent supervisory functions.

Call Data Update


This service lets a CTI client modify certain variable parts of the call state while a call is active.

Miscellaneous
This service informs CTI clients of significant Peripheral Gateway events.

Connection Monitor
This service monitors the CTI client connection and generates alarm events whenever the CTI client
connection is established or terminated.

Client Control
This service permits direct control of agent state (such as the ACD sign-in and sign-out). It also controls
of inbound and outbound calls from the CTI client application.

Server Service
This service enables the CTI Server to register a service that it wishes to provide.

You specify which levels you want in the ServicesRequested field of the OPEN_REQ message.

Related Topics
Session Management, on page 33

Client Events Service


The Client Events service is the heart of the CTI Interface. This service sends unsolicited messages to CTI
clients when the peripheral reports that a call event or agent state change for the CTI client’s phone occurred.
You receive these messages if you set the CTI_SERVICE_CLIENT_EVENTS bit in the ServicesRequested
field of the OPEN_REQ message. There are no request or confirmation messages associated with unsolicited
events.
Call Event messages are modeled after the CSTA messaging conventions. Call Events messages, in general,
follow the CSTA naming conventions and event paradigms but use a simpler set of data types than those
defined by CSTA.
Every call is announced to the CTI client with an unsolicited BEGIN_CALL_EVENT message. The CTI
Server sends this message when the CTI Server assigns the client to an incoming call. The message provides

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
48
Application Level Interfaces
Client Events Service

the initial call context data. More call and agent state events are then sent to the client as the call is handled.
The events depend on the type of ACD involved and the treatment that the call receives. Finally, an
END_CALL_EVENT message is sent to the CTI client when its association with a call is dissolved, as shown
in this figure:

The content of most of the Call Event message is event-specific and, often, peripheral-specific. Some ACDs
may not provide all these events.
For peripheral-specific Call Event message information, see the CTI OS Developer Guide for Cisco Unified
ICM/Contact Center Enterprise at http://www.cisco.com/c/en/us/support/customer-collaboration/
computer-telephony-integration-option/products-programming-reference-guides-list.html.
The relative order of call event messages and any corresponding agent state change event messages is not
specified. An agent state event message for an agent in the “talking” state, for example, can be sent before or
after the corresponding call established event message.
This table lists the Client Events service messages.

Table 20: Client Events Service Messages

Message When Sent to CTI Client


BEGIN_CALL_EVENT When the CTI Server associates a call with the CTI client

END_CALL_EVENT When CTI Server dissolves association between a call and the
CTI Client

CALL_DATA_UPDATE_EVENT When call context data changes

CALL_DELIVERED_EVENT When a call arrives at the agent’s phone or when an inbound


ACD trunk is seized and the client has the All Events service
enabled

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
49
Application Level Interfaces
Client Events Service

Message When Sent to CTI Client


CALL_ESTABLISHED_EVENT When a call is answered at the agent’s phone

CALL_HELD_EVENT When a call is placed on hold at the agent’s phone

CALL_RETRIEVED_EVENT When a call previously placed on hold at the agent’s phone is


resumed

CALL_CLEARED_EVENT When a call is terminated

CALL_CONNECTION_CLEARED_EVENT When a party drops from a conference call

CALL_ORIGINATED_EVENT Sent to CTI client upon initialization of a call from the peripheral

CALL_FAILED_EVENT When a call cannot be completed

CALL_CONFERENCED_EVENT When calls are joined into a conference call

CALL_TRANSFERRED_EVENT When a call is transferred to another destination

CALL_DIVERTED_EVENT When a call is removed from a previous delivery target

CALL_SERVICE_INITIATED_EVENT When telecommunications service is initiated at the agent’s phone

AGENT_STATE_EVENT When an agent’s state changes

CALL_REACHED_NETWORK_EVENT When an outbound call is connected to another network

CALL_QUEUED_EVENT When a call is placed in a queue pending the availability of a


resource

CALL_DEQUEUED_EVENT When a call is removed from a queue

AGENT_PRE_CALL_EVENT When a call is routed to Enterprise Agent

AGENT_PRE_CALL_ABORT_EVENT When a call that was previously announced through an


AGENT_PRE_CALL_EVENT message cannot be routed as
intended

RTP_STARTED_EVENT Indicates that a Real Time Protocol (RTP) media stream has
started.

RTP_STOPPED_EVENT Indicates that a Real Time Protocol (RTP) media stream has
stopped.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
50
Application Level Interfaces
BEGIN_CALL_EVENT

BEGIN_CALL_EVENT
When the CTI Server associates a call with the CTI client, it sends the client a BEGIN_CALL_EVENT
message. This message provides the call ID and the initial call context data. The combination of
ConnectionCallID, ConnectionDeviceIDType, and ConnectionDeviceID uniquely identify the call. This
message always precedes any other event messages for that call. If any subsequent changes to the call context
data occur, the CTI Server sends CALL_DATA_UPDATE_EVENT messages containing the changed call
data to the CTI client. There can be multiple calls with the same ConnectionCallID value.
This table defines the format of the BEGIN_CALL_EVENT message.

Table 21: BEGIN_CALL_EVENT Message Format

Field Name Value Data Type Byte Size


Fixed Part

MessageHeader Standard message header. MHDR 8


MessageType = 23.

MonitorID The Monitor ID of the device or call UINT 4


monitor that sent this message to the
client. This is zero if there is no
monitor associated with the event (All
Events Service).

PeripheralID The PeripheralID of the ACD where UINT 4


the call activity occurred.

PeripheralType The type of the peripheral USHORT 2

NumCTIClients The number of CTI clients previously USHORT 2


associated with this call. This value
also indicates the number of CTI
client signatures and time stamps in
the floating part of the message.

NumNamedVariables The number of NamedVariable USHORT 2


floating fields present in the floating
part of the message.

NumNamedArrays The number of NamedArray floating USHORT 2


fields present in the floating part of
the message.

CallType The general classification of the call USHORT 2


type

ConnectionDeviceIDType The type of device ID in the USHORT 2


ConnectionDeviceID floating field

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
51
Application Level Interfaces
BEGIN_CALL_EVENT

Field Name Value Data Type Byte Size


ConnectionCallID The Call ID value assigned to this call UINT 4
by the peripheral or Unified CCE.

CalledPartyDisposition Indicates the disposition of the called USHORT 2


party.

Floating Part

ConnectionDeviceID The device ID of the device STRING 64


associated with the connection.

ANI (optional) The calling line ID of the caller. STRING 40

UserToUserInfo (optional) The ISDN user-to-user information UNSPEC 131


element.

DNIS (optional) The DNIS provided with the call. STRING 32

DialedNumber (optional) The number dialed. STRING 40

CallerEnteredDigits (optional) The digits entered by the caller in STRING 40


response to IVR prompting.

RouterCallKeyDay Together with the UINT 4


RouterCallKeyCallID field forms the
unique 64-bit key for locating this
call’s records in the Unified CCE.
Only provided for Post-routed and
Translation-routed calls.

RouterCallKeyCallID The call key created by Unified CCE. UINT 4


Unified CCE resets this counter at
midnight.

RouterCallKeySequenceNumber Together with RouterCallKeyDay and UINT 4


RouterCallKeyCallID fields forms the
TaskID

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrap up data. STRING 40

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
52
Application Level Interfaces
BEGIN_CALL_EVENT

Field Name Value Data Type Byte Size


NamedVariable (optional) Call-related variable data that has a NAMED VAR 251
variable name defined in the Unified
CCE. There may be an arbitrary
number of NamedVariable and
NamedArray fields in the message,
subject to a combined total limit of
2000 bytes.

NamedArray (optional) Call-related variable data that has an NAMED 252


array variable name defined in the ARRAY
Unified CCE. There may be an
arbitrary number of NamedVariable
and NamedArray fields in the
message, subject to a combined total
limit of 2000 bytes.

CTIClientSignature The Client Signature of a CTI client STRING 64


previously associated with this call.
There may be more than one
CTIClientSignature field in the
message. (See NumCTIClients.)

CTIClientTimestamp (optional) The date and time that the preceding TIME 4
CTIClientSignature was first
associated with the call. There may
be more than one
CTIClientTimestamp field in the
message. (See NumCTIClients.) This
field always immediately follows the
CTIClientSignature field to which it
refers.

CallReferenceID (optional) For Unified CCE systems where the UNSPEC 32


Unified CM provides it, this is a
unique call identifier.

Related Topics
CallType Values, on page 275
ConnectionDeviceIDType Values, on page 277
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27
PeripheralType Values, on page 267

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
53
Application Level Interfaces
END_CALL_EVENT

END_CALL_EVENT
The CTI Server sends an END_CALL_EVENT message to the CTI client when the association between a
call and the CTI client is dissolved. This message does not necessarily indicate that the subject call has been
terminated. The message indicates only that the CTI client is no longer responsible for processing the call and
is receiving no further call event messages for the call.
This table defines the format of the END_CALL_EVENT message: defines the format of the
END_CALL_EVENT message:

Table 22: END_CALL_EVENT Message Format

Field Name Value Data Type Byte Size


Fixed Part

MessageHeader Standard message header. MessageType = MHDR 8


24.

MonitorID The Monitor ID of the device or call monitor UINT 4


that sent this message to the client. It can
also be zero if there is no monitor associated
with the event (All Events Service).

PeripheralID The PeripheralID of the ACD where the call UINT 4


activity occurred.

PeripheralType The type of the peripheral. USHORT 2

ConnectionDeviceIDType The type of device ID in the USHORT 2


ConnectionDeviceID floating field.

ConnectionCallID The Call ID value assigned to the call by the UINT 4


peripheral or Unified CCE.

Floating Part

ConnectionDeviceID The device ID of the device associated with STRING 64


the connection.

Related Topics
ConnectionDeviceIDType Values, on page 277
PeripheralType Values, on page 267

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
54
Application Level Interfaces
CALL_AGENT_GREETING_EVENT

CALL_AGENT_GREETING_EVENT
This message indicates if the agent greeting has started, finished, or failed after the Agent Greeting request
has been made. This table defines the format of the message.

Table 23: CALL_AGENT_GREETING_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MHDR 8


MessageType = 248

MonitorID The Monitor ID of the device or call UINT 4


monitor that caused this message to
be sent to the client, or zero if there
is no monitor associated with the
event (All Events Service).

PeripheralID The Peripheral ID of the ACD where UINT 4


the device is located.

ConnectionDeviceIDType The Call ID value assigned to this call USHORT 2


by the peripheral. Agent's ACD call
ID.

ConnectionCallID The Call ID value assigned to this call UINT 4


by the peripheral. Agent's ACD call
ID.

EventCode EventCode = 0, Greeting has started. USHORT 2


EventCode = 1, Greeting has ended
with SUCCESS.
EventCode = 2, Failed to play the
greeting for any reason.

PeripheralErrorCode Peripheral-specific error data, if UINT 4


EventCode = 2. Zero otherwise.

Floating Part

Field Name Value Data Type Byte Size

ConnectionDeviceID (required) The identifier of the connection STRING 64


between the call and the device.

AgentID (required) The agent’s ACD login ID. STRING 12

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
55
Application Level Interfaces
CALL_DATA_UPDATE_EVENT

GreetingType (required) The greeting type. STRING 32

CALL_DATA_UPDATE_EVENT
The CTI Server sends a CALL_DATA_UPDATE_EVENT message to the CTI client when changes to the
call context data occur. This message contains only the items that have changed. The initial call context is
provided in the BEGIN_CALL_EVENT message. This table defines the CALL_DATA_UPDATE_EVENT
message.

Table 24: CALL_DATA_UPDATE_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 25. MHDR 8

MonitorID The Monitor ID of the device or call monitor that UINT 4


caused this message to be sent to the client, or zero
if there is no monitor associated with the event (All
Events Service).

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

PeripheralType The type of the peripheral. USHORT 2

NumCTIClients The number of CTI Clients associated with this call. USHORT 2
This value also indicates the number of CTI Client
signatures and timestamps that are present in the
floating part of the message.

NumNamedVariables The number of NamedVariable floating fields USHORT 2


present in the floating part of the message.

NumNamedArrays The number of NamedArray floating fields present USHORT 2


in the floating part of the message.

CallType The general classification of the call type. USHORT 2

ConnectionDevice IDType Indicates the type of the connection identifier USHORT 2


supplied in the ConnectionDeviceID floating field.

ConnectionCallID The Call ID value previously assigned to this call UINT 4


by the peripheral or Unified CCE.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
56
Application Level Interfaces
CALL_DATA_UPDATE_EVENT

NewConnectionDeviceIDType Indicates the type of the connection identifier USHORT 2


supplied in the NewConnectionDeviceID floating
field.

NewConnectionCallID The new Call ID value assigned to this call by the UINT 4
peripheral or Unified CCE.

CalledPartyDisposition Indicates the disposition of called party USHORT 2

CampaignID Campaign ID for value that appears in the Agent UINT 4


Real Time table. Set to zero if not used.

QueryRuleID Query rule ID for value that appears in the Agent UINT 4
Real Time table. Set to zero if not used.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID (required) The previous identifier of the call connection. STRING 64

NewConnectionDeviceID The new identifier of call connection. STRING 64


(required)

ANI (optional) The calling line ID of the caller. STRING 40

UserToUserInfo (optional) The ISDN user-to-user information element. UNSPEC 131

DNIS (optional) The DNIS provided with the call. STRING 32

DialedNumber (optional) The number dialed. STRING 40

CallerEnteredDigits (optional) The digits entered by the caller in response to IVR STRING 40
prompting.

RouterCallKeyDay (optional) Together with the RouterCallKeyCallID field forms UINT 4


the unique 64-bit key for locating this call’s records
in the Unified CCE. Only provided for Post-routed
and Translation-routed calls.

RouterCallKeyCallID (optional) The call key created by Unified CCE. Unified CCE UINT 4
resets this counter at midnight.

RouterCallKey SequenceNumber Together with RouterCallKeyDay and UINT 4


RouterCallKeyCallID fields forms the TaskID.

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
57
Application Level Interfaces
CALL_DELIVERED_EVENT

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrapup data. STRING 40

NamedVariable (optional) Call-related variable data that has a variable name NAMED 251
defined in the Unified CCE. There may be an VAR
arbitrary number of Named Variable and
NamedArray fields in the message, subject to a
combined total limit of 2000 bytes.

NamedArray (optional) Call-related variable data that has an array variable NAMED 252
name defined in the Unified CCE. There may be ARRAY
an arbitrary number of Named Variable and
NamedArray fields in the message, subject to a
combined total limit of 2000 bytes.

CustomerPhoneNumber (optional) Customer phone number for value that appears in STRING 20
the Agent Real Time table.

CustomerAccount Number Customer Account Number for value that appears STRING 32
(optional) in the Agent Real Time table.

CTIClientSignature (optional) The Client Signature of a CTI Client that was STRING 64
previously associated with this call. There may be
more than one CTIClientSignature field in the
message (see NumCTIClients).

CTIClientTimestamp (optional) The date and time that the preceding CTI Client TIME 4
signature was first associated with the call. There
may be more than one CTIClientTimestamp field
in the message (see NumCTIClients). This field
always immediately follows the CTIClientSignature
field to which it refers.

CallReferenceID (optional) For Unified CCE systems where the Unified CM UNSPEC 32
provides it, this will be a unique call identifier.

Related Topics
CallType Values, on page 275
ConnectionDeviceIDType Values, on page 277
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27
PeripheralType Values, on page 267

CALL_DELIVERED_EVENT
The CTI Server may send a CALL_DELIVERED_EVENT message to the CTI client in two cases:

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
58
Application Level Interfaces
CALL_DELIVERED_EVENT

• A call arrives at the agent’s teleset.


• An inbound ACD trunk is seized and the client has the All Events service enabled.

The LocalConnectionState field indicates which case applies. This table defines the
CALL_DELIVERED_EVENT message.

Table 25: CALL_DELIVERED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 9. MHDR 8

MonitorID The Monitor ID of the device or call monitor that UINT 4


caused this message to be sent to the client, or zero
if there is no monitor associated with the event (All
Events Service).

PeripheralID The PeripheralID of the ACD where the call activity UINT 4
occurred.

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice IDType The type of device ID in the ConnectionDeviceID USHORT 2


floating field.

ConnectionCallID The Call ID value assigned to this call by the UINT 4


peripheral or Unified CCE.

LineHandle When LocalConnectionState is LCS_ALERTING, USHORT 2


this field identifies the alerting teleset line, if known.
Otherwise this field is set to 0xffff.

LineType The type of the teleset line in the LineHandle field, USHORT 2
if any. Otherwise this field is set to 0xffff.

ServiceNumber The service that the call is attributed to, as known to UINT 4
the peripheral. May contain the special value
NULL_SERVICE when not applicable or not
available.

ServiceID The ServiceID of the service that the call is attributed UINT 4
to. May contain the special value NULL_SERVICE
when not applicable or not available.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
59
Application Level Interfaces
CALL_DELIVERED_EVENT

SkillGroupNumber The number of the agent Skill Group the call is UINT 4
attributed to, as known to the peripheral. May contain
the special value NULL_SKILL_GROUP when not
applicable or not available. Some ACDs ignore this
field and/or use the ACD default; see the list
immediately following this table.

SkillGroupID The SkillGroupID of the agent SkillGroup the call UINT 4


is attributed to. May contain the special value
NULL_SKILL_GROUP when not applicable or not
available.

SkillGroupPriority The priority of the skill group, or 0 when skill group USHORT 2
priority is not applicable or not available.

AlertingDevice Type The type of device ID in the AlertingDevic ID USHORT 2


floating field.

CallingDeviceType The type of device ID in the CallingDeviceID USHORT 2


floating field.

CalledDeviceType The type of device ID in the CalledDeviceID floating USHORT 2


field.

LastRedirect DeviceType The type of device ID in the LastRedirectDeviceID USHORT 2


floating field.

LocalConnection State The state of the local end of the connection. When a USHORT 2
call is delivered to an agent teleset, the
LocalConnectionState will be LCS_ALERTING.

EventCause A reason for the occurrence of the event. USHORT 2

NumNamedVariables The number of NamedVariable floating fields present USHORT 2


in the floating part of the message.

NumNamedArrays The number of NamedArray floating fields present USHORT 2


in the floating part of the message.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the STRING 64


connection.

AlertingDeviceID (optional) The device ID of the device that is alerting. STRING 64

CallingDeviceID (optional) The device ID of the calling device. STRING 64

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
60
Application Level Interfaces
CALL_DELIVERED_EVENT

CalledDeviceID (optional) The device ID of the originally called device. STRING 64

LastRedirect Device ID (optional) The device ID of the previously alerted device. STRING 64

TrunkNumber (optional) The number representing a trunk. UINT 4

TrunkGroup Number (optional) The number representing a trunk group. UINT 4

SecondaryConnectionCallID The ID of the consultation Call that Unified Contact UINT 4


Center Express (Unified CCX) placed from the CTI
port to the agent device.

ANI (optional) The calling line ID of the caller. STRING 40

ANI_II (optional) (V11+) ANI II (Intelligent Information) digits—Currently STRING 2


not populated.

UserToUserInfo (optional) The ISDN user-to-user information element. UNSPEC 131

DNIS (optional) The DNIS provided with the call. STRING 32

DialedNumber (optional) The number dialed. STRING 40

CallerEnteredDigits (optional) The digits entered by the caller in response to IVR STRING 40
prompting.

CallVariable1 (optional) Call-related variable data. STRING 41

... ... ... ...

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrapup data. STRING 40

NamedVariable (optional) Call-related variable data that has a variable name NAMEDVAR 251
defined in the Unified CCE. There may be an
arbitrary number of NamedVariable and NamedArray
fields in the message, subject to a combined total
limit of 2000 bytes.

NamedArray (optional) Call-related variable data that has an array variable NAMED 252
name defined in the Unified CCE. There may be an ARRAY
arbitrary number of NamedVariable and NamedArray
fields in the message, subject to a combined total
limit of 2000 bytes.

Skill Group Number field


Following is a list of how various ACDs process the SkillGroupNumber field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
61
Application Level Interfaces
CALL_ESTABLISHED_EVENT

• Enterprise Agent, Alcatel, and Avaya Communication Manager (ACM) (if not in EAS mode) require a
valid SkillGroupNumber and use it
• Avaya Aura ignores the SkillGroupNumber field altogether and uses the ACD default
• ACM (in EAS mode) and Aspect process the SkillGroupNumber field in the following fashion:
◦Use a valid SkillGroupNumber if one is supplied
◦If SkillGroupNumber is omitted or set to –1, use the ACD defaults
◦Any other value for SkillGroupNumber results in a failure; in this case, use the last valid
SkillGroupNumber for the agent

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LineType Values, on page 278
LocalConnectionState Values, on page 268
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27
PeripheralType Values, on page 267
Special Values, on page 251
CALL_DELIVERED_EVENT, on page 58
LocalConnectionState Values, on page 268

CALL_ESTABLISHED_EVENT
When a call is answered at the agent’s teleset, the CTI Server may send a CALL_ESTABLISHED_EVENT
message to the CTI client. This table defines the CALL_ESTABLISHED_EVENT message:

Table 26: CALL_ESTABLISHED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 10. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The PeripheralID of the ACD where the call activity occurred. UINT 4

PeripheralType The type of the peripheral. USHORT 2

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
62
Application Level Interfaces
CALL_ESTABLISHED_EVENT

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

LineHandle Identifies the teleset line being used. USHORT 2

LineType The type of the teleset line. USHORT 2

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value NULL_SERVICE
when not applicable or not available.

ServiceID The ServiceID of the service that the call is attributed to. May UINT 4
contain the special value NULL_ SERVICE when not
applicable or not available.

SkillGroupNumber The number of the agent Skill Group the call is attributed to, UINT 4
as known to the peripheral. May contain the special value
NULL_SKILL_ GROUP when not applicable or not available.
Some ACDs ignore this field and/or use the ACD default; see
the list in the CALL_DELIVERED_EVENT section.

SkillGroupID The SkillGroupID of the agent SkillGroup the call is attributed UINT 4
to. May contain the special value NULL_SKILL_GROUP
when not applicable or not available.

SkillGroupPriority The priority of the skill group, or 0 when skill group priority USHORT 2
is not applicable or not available.

AnsweringDevice The type of device ID in the AnsweringDeviceID floating field. USHORT 2


Type

CallingDeviceType The type of device ID in the CallingDeviceID floating field. USHORT 2

CalledDeviceType The type of device ID in the CalledDeviceID floating field. USHORT 2

LastRedirect The type of device ID in the LastRedirect DeviceID floating USHORT 2


DeviceType field.

LocalConnection The state of the local end of the connection. USHORT 2


State

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
63
Application Level Interfaces
CALL_HELD_EVENT

ConnectionDevice The device ID of the device associated with the connection. STRING 64
ID

AnsweringDevice ID The device ID of the device that answered the call. STRING 64
(optional)

CallingDeviceID The device ID of the calling device. STRING 64


(optional)

CalledDeviceID The device ID of the originally called device. STRING 64


(optional)

LastRedirectDevice The device ID of the previously alerted device. STRING 64


ID (optional)

TrunkNumber The number representing a trunk. UINT 4


(optional)

TrunkGroup Number The number representing a trunk group. UINT 4


(optional)

Related Topics
CALL_DELIVERED_EVENT, on page 58
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LineType Values, on page 278
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

CALL_HELD_EVENT
The CTI Server may send a CALL_HELD_EVENT message to the CTI client when a call is placed on hold
at the agent’s teleset. This table defines the CALL_HELD_EVENT message.

Table 27: CALL_HELD_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 11. MHDR 8

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
64
Application Level Interfaces
CALL_RETRIEVED_EVENT

MonitorID The Monitor ID of the device or call monitor that UINT 4


caused this message to be sent to the client, or zero
if there is no monitor associated with the event (All
Events Service).

PeripheralID The PeripheralID of the ACD where the call UINT 4


activity occurred.

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice IDType The type of device ID in the ConnectionDeviceID USHORT 2


floating field.

ConnectionCallID The Call ID value assigned to this call by the UINT 4


peripheral or Unified CCE.

HoldingDeviceType The type of device ID in the HoldingDeviceID USHORT 2


floating field.

LocalConnection State The state of the local end of the connection. USHORT 2

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the STRING 64


connection.

HoldingDeviceID (optional) The device ID of the device that activated the hold. STRING 64

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267

CALL_RETRIEVED_EVENT
The CTI Server may send a CALL_RETRIEVED_EVENT message to the CTI client when a call previously
placed on hold at the agent’s teleset is resumed.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
65
Application Level Interfaces
CALL_RETRIEVED_EVENT

Table 28: CALL_RETRIEVED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 12. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The PeripheralID of the ACD where the call activity occurred. UINT 4

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectioDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

RetrievingDevice The type of device ID in the RetrievingDeviceID floating USHORT 2


Type field.

LocalConnection The state of the local end of the connection. USHORT 2


State

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The device ID of the device associated with the connection. STRING 64
ID

RetrievingDevice The device ID of the device that deactivated hold. STRING 64


ID (optional)

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
66
Application Level Interfaces
CALL_CLEARED_EVENT

CALL_CLEARED_EVENT
The CTI Server sends a CALL_CLEARED_EVENT message to the CTI client when a call is terminated,
usually when the last device disconnects from a call.

Table 29: CALL_CLEARED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 13. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The PeripheralID of the ACD where the call activity occurred. UINT 4

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

LocalConnection The state of the local end of the connection. USHORT 2


State

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The device ID of the device associated with the cleared STRING 64
ID connection.

Related Topics
ConnectionDeviceIDType Values, on page 277
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
67
Application Level Interfaces
CALL_CONNECTION_CLEARED_EVENT

CALL_CONNECTION_CLEARED_EVENT
The CTI Server may send a CALL_CONNECTION_CLEARED_ EVENT message to the CTI client when
a party drops from a conference call.

Table 30: CALL_CONNECTION_CLEARED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 14. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The PeripheralID of the ACD where the call activity occurred. UINT 4

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

ReleasingDevice The type of device ID in the ReleasingDeviceID floating field. USHORT 2


Type

LocalConnection The state of the local end of the connection. USHORT 2


State

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The device ID of the device associated with the cleared STRING 64
ID connection.

ReleasingDeviceID The device ID of the device that cleared the connection. STRING 64
(optional) Note For Contact Center Enterprise, this field does not
reliably indicate which party hung up first.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
68
Application Level Interfaces
CALL_ORIGINATED_EVENT

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267

CALL_ORIGINATED_EVENT
The CTI Server may send a CALL_ORIGINATED_EVENT message to the CTI client when the peripheral
initiates an outbound call.

Table 31: CALL_ORIGINATED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 15. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The PeripheralID of the ACD where the call activity occurred. UINT 4

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

LineHandle Identifies the teleset line being used. USHORT 2

LineType The type of the teleset line. USHORT 2

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value NULL_SERVICE
when not applicable or not available.

ServiceID The ServiceID of the service that the call is attributed to. May UINT 4
contain the special value NULL_ SERVICE when not
applicable or not available.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
69
Application Level Interfaces
CALL_ORIGINATED_EVENT

SkillGroupNumber The number of the agent SkillGroup the call is attributed to, UINT 4
as known to the peripheral. May contain the special value
NULL_SKILL_ GROUP when not applicable or not available.
Some ACDs ignore this field and/or use the ACD default; see
the list in the CALL_DELIVERED_EVENT section.

SkillGroupID The SkillGroupID of the agent SkillGroup the call is attributed UINT 4
to. May contain the special value NULL_SKILL_GROUP if
not applicable or not available.

SkillGroupPriority The priority of the skill group, or 0 when skill group priority USHORT 2
is not applicable or not available.

CallingDeviceType The type of device ID in the CallingDeviceID floating field. USHORT 2

CalledDeviceType The type of device ID in the CalledDeviceID floating field. USHORT 2

LocalConnection State The state of the local end of the connection. USHORT 2

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the connection. STRING 64

CallingDeviceID The device ID of the calling device. STRING 64


(optional)

CalledDeviceID The device ID of the originally called device. STRING 64


(optional)

Related Topics
CALL_DELIVERED_EVENT, on page 58
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LineType Values, on page 278
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
70
Application Level Interfaces
CALL_FAILED_EVENT

CALL_FAILED_EVENT
The CTI Server may send a CALL_FAILED_EVENT message to the CTI client when a call cannot be
completed.

Table 32: CALL_FAILED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 16. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The PeripheralID of the ACD where the call activity occurred. UINT 4

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

FailingDeviceType The type of device ID in the FailingDeviceID floating field. USHORT 2

CalledDeviceType The type of device ID in the CalledDeviceID floating field. USHORT 2

LocalConnection The state of the local end of the connection. USHORT 2


State

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the connection. STRING 64

FailingDeviceID The device ID of the failing device. STRING 64


(optional)

CalledDeviceID The device ID of the called device. STRING 64


(optional)

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
71
Application Level Interfaces
CALL_CONFERENCED_EVENT

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267

CALL_CONFERENCED_EVENT
The CTI Server may send a CALL_CONFERENCED_EVENT message to the CTI client when calls are
joined into a conference call.

Table 33: CALL_CONFERENCED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 17. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused UINT 4
this message to be sent to the client, or zero if there is
no monitor associated with the event (All Events
Service).

PeripheralID The PeripheralID of the ACD where the call activity UINT 4
occurred.

PeripheralType The type of the peripheral. USHORT 2

PrimaryDeviceIDType The type of device ID in the PrimaryDeviceID floating USHORT 2


field.

PrimaryCallID The Call ID value assigned to the primary call by the UINT 4
peripheral or Unified CCE.

LineHandle The teleset line being used. USHORT 2

LineType The type of the teleset line. USHORT 2

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
72
Application Level Interfaces
CALL_CONFERENCED_EVENT

SkillGroupNumber The number of the agent SkillGroup the call is attributed UINT 4
to, as known to the peripheral. May contain the special
value NULL_SKILL_ GROUP when not applicable or
not available. Some ACDs ignore this field and/or use
the ACD default; see the list in the
CALL_DELIVERED_EVENT section.

SkillGroupID The SkillGroupID of the agent SkillGroup the call is UINT 4


attributed to. May contain the special value
NULL_SKILL_ GROUP when not applicable or not
available.

SkillGroupPriority The priority of the skill group, or 0 when skill group USHORT 2
priority is not applicable or not available.

NumParties The number of active connections associated with this USHORT 2


conference call, up to a maximum of 16. This value also
indicates the number of ConnectedParty CallID,
ConnectedParty DeviceIDType, and
ConnectedPartyDeviceID floating fields in the floating
part of the message.

SecondaryDevice IDType The type of device ID in the SecondaryDeviceID floating USHORT 2


field.

SecondaryCallID The Call ID value assigned to the secondary call by the UINT 4
peripheral or Unified CCE.

ControllerDeviceType The type of device ID in the ControllerDeviceID floating USHORT 2


field.

AddedPartyDeviceType The type of device ID in the AddedPartyDeviceID USHORT 2


floating field.

LocalConnectionState The state of the local end of the connection. USHORT 2

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

PrimaryDeviceID The device ID of the device associated with the primary STRING 64
call connection.

SecondaryDeviceID The device ID of the device associated with the secondary STRING 64
call connection.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
73
Application Level Interfaces
CALL_TRANSFERRED_EVENT

ControllerDeviceID The device ID of the conference controller device. STRING 64


(optional)

AddedPartyDeviceID The device ID of the device added to the call. STRING 64


(optional)

ConnectedPartyCallID The Call ID value assigned to one of the conference call UINT 4
(optional) parties. There may be more than one Connected Party
CallID field in the message (see NumParties).

ConnectedPartyDevice The type of device ID in the following ConnectedParty USHORT 2


IDType (optional) DeviceID floating field. There may be more than one
Connected PartyDevice IDType field in the message (see
NumParties). This field always immediately follows the
corresponding Connected PartyCallID field.

ConnectedParty DeviceID The device identifier of one of the conference call parties. STRING 64
(optional) There may be more than one ConnectedParty DeviceID
field in the message (see NumParties). This field always
immediately follows the corresponding Connected
PartyDeviceIDType field.

Related Topics
CALL_DELIVERED_EVENT, on page 58
DeviceIDType Values, on page 274
EventCause Values, on page 269
LineType Values, on page 278
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

CALL_TRANSFERRED_EVENT
The CTI Server may send a CALL_TRANSFERRED_EVENT message to the CTI client when a call is
transferred to another destination.

Table 34: CALL_TRANSFERRED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType MHDR 8


= 18.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
74
Application Level Interfaces
CALL_TRANSFERRED_EVENT

MonitorID The Monitor ID of the device or call UINT 4


monitor that caused this message to be
sent to the client, or zero if there is no
monitor associated with the event (All
Events Service).

PeripheralID The Unified CCE PeripheralID of the UINT 4


ACD where the call activity occurred.

PeripheralType The type of the peripheral. USHORT 2

PrimaryDeviceIDType The type of device ID in the USHORT 2


PrimaryDeviceID floating field.

PrimaryCallID The Call ID value assigned to the UINT 4


primary call by the peripheral or Unified
CCE.

LineHandle Identifies the teleset line being used. USHORT 2

LineType The type of the teleset line. USHORT 2

SkillGroupNumber The number of the agent Skill Group the UINT 4


call is attributed to, as known to the
peripheral. May contain the special value
NULL_SKILL_GROUP when not
applicable or not available. Some ACDs
ignore this field and/or use the ACD
default; see the list in the
CALL_DELIVERED_EVENT section.

SkillGroupID The SkillGroupID of the agent UINT 4


SkillGroup the call is attributed to. May
contain the special value NULL_SKILL_
GROUP when not applicable or not
available.

SkillGroupPriority The priority of the skill group, or 0 when USHORT 2


skill group priority is not applicable or
not available.

NumParties The number of active connections USHORT 2


associated with this conference call, up
to a maximum of 16. This value also
indicates the number of ConnectedParty
CallID, ConnectedParty DeviceID Type,
and ConnectedParty DeviceID floating
fields in the floating part of the message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
75
Application Level Interfaces
CALL_TRANSFERRED_EVENT

SecondaryDevice IDType The type of device ID in the USHORT 2


SecondaryDeviceID floating field.

SecondaryCallID The Call ID value assigned to the UINT 4


secondary call by the peripheral or
Unified CCE.

TransferringDeviceType The type of device ID in the USHORT 2


TransferringDeviceID floating field.

TransferredDeviceType The type of device ID in the USHORT 2


TransferredDeviceID floating field.

LocalConnectionState The state of the local end of the USHORT 2


connection.

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

PrimaryDeviceID The device ID of the device associated STRING 64


with the primary call connection.

SecondaryDeviceID The device ID of the device associated STRING 64


with the secondary call connection.

TransferringDeviceID (optional) The device ID of the device that STRING 64


transferred the call.

TransferredDeviceID (optional) The device ID of the device to which the STRING 64


call was transferred.

ConnectedPartyCallID (optional) The Call ID value assigned to one of the UINT 4


call parties. There may be more than one
ConnectedPartyCallID field in the
message (see NumParties).

ConnectedPartyDevice IDType The type of device ID in the following USHORT 2


(optional) ConnectedParty DeviceID floating field.
There may be more than one
ConnectedParty DeviceIDType field in
the message (see NumParties). This field
always immediately follows the
corresponding Connected PartyCallID
field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
76
Application Level Interfaces
CALL_DIVERTED_EVENT

ConnectedParty DeviceID (optional) The device identifier of one of the call STRING 64
parties. There may be more than one
ConnectedParty Device ID field in the
message (see NumParties). This field
always immediately follows the
corresponding Connected PartyDevice
IDType field.

Related Topics
CALL_DELIVERED_EVENT, on page 58
DeviceIDType Values, on page 274
EventCause Values, on page 269
LineType Values, on page 278
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

CALL_DIVERTED_EVENT
The CTI Server may send a CALL_DIVERTED_EVENT message to the CTI client when a call is removed
from a previous delivery target.

Table 35: CALL_DIVERTED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 19. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused UINT 4
this message to be sent to the client, or zero if there is no
monitor associated with the event (All Events Service).

PeripheralID The Unified CCE PeripheralID of the ACD where the UINT 4
call activity occurred.

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice IDType The type of device ID in the ConnectionDeviceID floating USHORT 2


field.

ConnectionCallID The Call ID value assigned to this call by the peripheral UINT 4
or Unified CCE.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
77
Application Level Interfaces
CALL_SERVICE_INITIATED_EVENT

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value NULL_
SERVICE when not applicable or not available.

ServiceID The ServiceID of the service that the call is attributed to. UINT 4
May contain the special value NULL_ SERVICE when
not applicable or not available.

DivertingDeviceType The type of device ID in the DivertingDeviceID floating USHORT 2


field.

CalledDeviceType The type of device ID in the CalledDeviceID floating USHORT 2


field.

LocalConnectionState The state of the local end of the connection. USHORT 2

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID The device ID of the device associated with the STRING 64


connection.

DivertingDeviceID The device ID of the device from which the call was STRING 64
(optional) diverted.

CalledDeviceID (optional) The device ID of the device to which the call was STRING 64
diverted.

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

CALL_SERVICE_INITIATED_EVENT
The CTI Server may send a CALL_SERVICE_INITIATED_EVENT message to the CTI client upon the
initiation of telecommunications service (“dial tone”) at the agent’s teleset.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
78
Application Level Interfaces
CALL_SERVICE_INITIATED_EVENT

Table 36: CALL_SERVICE_INITIATED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 20. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused UINT 4
this message to be sent to the client, or zero if there is no
monitor associated with the event (All Events Service).

PeripheralID The Unified CCE PeripheralID of the ACD where the call UINT 4
activity occurred.

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral UINT 4
or Unified CCE.

LineHandle Identifies the teleset line being used. USHORT 2

LineType The type of the teleset line. USHORT 2

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value
NULL_SERVICE when not applicable or not available.

ServiceID The ServiceID of the service that the call is attributed to. UINT 4
May contain the special value NULL_SERVICE when
not applicable or not available.

SkillGroupNumber The number of the agent SkillGroup the call is attributed UINT 4
to, as known to the peripheral. May contain the special
value NULL_SKILL_GROUP when not applicable or not
available. Some ACDs ignore this field and/or use the
ACD default; see the list in the
CALL_DELIVERED_EVENT section.

SkillGroupID The SkillGroupID of the agent SkillGroup the call is UINT 4


attributed to. May contain the special value NULL_
SKILL_ GROUP when not applicable or not available.

SkillGroupPriority The priority of the skill group, or 0 when skill group USHORT 2
priority is not applicable or not available.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
79
Application Level Interfaces
AGENT_STATE_EVENT

CallingDeviceType The type of the device identifier supplied in the USHORT 2


CallingDevice ID floating field.

LocalConnectionState The state of the local end of the connection. USHORT 2

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID The device ID of the device associated with the STRING 64


connection.

CallingDeviceID The device ID of the calling device. STRING 64


(optional)

CallReferenceID For Unified CCE systems where the Unified CM provides UNSPEC 32
(optional) it, this will be a unique call identifier.

COCConnectionCallID If specified, indicates that this call is a call on behalf of a UINT 4


(optional) consult call.

COCCallConnection If specified, indicates the type of connection identifier USHORT 2


DeviceIDType (optional) specified in the ConnectionDeviceID floating field for the
original call.

Related Topics
CALL_DELIVERED_EVENT, on page 58
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LineType Values, on page 278
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

AGENT_STATE_EVENT
An agent state change (such as logging on or becoming available to handle incoming calls) generates an
AGENT_STATE_EVENT message to the CTI client.

Table 37: AGENT_STATE_EVENT Message Format

Fixed Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
80
Application Level Interfaces
AGENT_STATE_EVENT

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 30. MHDR 8

MonitorID The Monitor ID of the device or call monitor that UINT 4


caused this message to be sent to the client, or zero if
there is no monitor associated with the event (All
Events Service).

PeripheralID The PeripheralID of the ACD where the call activity UINT 4
occurred.

SessionID The CTI client SessionID of the Client_Events session UINT 4


associated with this agent, or zero if no such CTI
session is currently open.

PeripheralType The type of the peripheral. USHORT 2

SkillGroupState An AgentState value representing the current state of USHORT 2


the associated agent with respect to the indicated Agent
Skill Group.

StateDuration The number of seconds since the agent entered this UINT 4
state (typically 0).

SkillGroupNumber The number of the agent SkillGroup affected by the USINT 4


state change, as known to the peripheral. May contain
the special value NULL_SKILL_ GROUP if not
applicable or not available. Some ACDs ignore this
field and/or use the ACD default; see the list in the
CALL_DELIVERED_EVENT section.

SkillGroupID The SkillGroupID of the agent SkillGroup affected by UINT 4


the state change. May contain the special value
NULL_SKILL_ GROUP when not applicable or not
available.

SkillGroupPriority The priority of the skill group, or 0 when skill group USHORT 2
priority is not applicable or not available.

AgentState An AgentState value representing the current overall USHORT 2


state of the associated agent.

EventReasonCode A peripheral-specific code indicating the reason for USHORT 2


the state change.
Note EventReasonCode is supported only for the
Not Ready and Logged Off agent states.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
81
Application Level Interfaces
AGENT_STATE_EVENT

MRDID Media Routing Domain ID as configured in Unified INT 4


CCE and the ARM client.

NumTasks The number of tasks currently assigned to the agent – UINT 4


this is the number that Unified CCE compares to the
MaxTaskLimit to decide if the agent is available to be
assigned additional tasks. This includes active tasks
as well as those that are offered, paused, and in wrapup.

AgentMode The mode that the agent will be in when the login USHORT 2
completes. ROUTABLE = 1, NOT ROUTABLE = 0

MaxTaskLimit The maximum number of tasks that the agent can be UINT 4
simultaneously working on.

ICMAgentID The Unified CCE Skill Target ID, a unique agent INT 4
identifier for Unified CCE.

AgentAvailability Status An agent is Available, or eligible to be assigned a task UINT 4


in this Media Routing Domain if the agent meets all
of these conditions:
• The agent is not in Not Ready state for the Media
Routing Domain.
• The agent is not working on a non-interruptible
task in another Media Routing Domain.
• The agent has not reached the maximum task
limit for this Media Routing Domain.

An available agent is eligible to be assigned a task.


Who can assign a task to the agent is determined by
whether or not the agent is Routable.
An agent is ICMAvailable in MRD X if he is available
in X and Routable with respect to X. An agent is
ApplicationAvailable in MRD X if he is available in
X and not Routable with respect to X. Otherwise an
agent is NotAvailable in MRD X.
The values are:
• NOT AVAILABLE = 0
• ICM AVAILABLE = 1
• APPLICATION AVAILABLE = 2

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
82
Application Level Interfaces
AGENT_STATE_EVENT

NumFltSkillGroups If information for more than one skill group is passed USHORT 2
this should be non-zero and indicate the number of
floating FltSkillGroupNumber, FltSkillGroupID,
FltSkillGroupPriority, and FltSkillGroupState floating
fields present in the floating part of the message (up
to 99). If 0, a single set of those entities is specified in
the fixed part of the message.

DepartmentID Department ID of the Agent INT 4

Floating Part

Field Name Value Data Type Max.


Size

CTIClientSignature The Client Signature of the CTI client associated with STRING 64
(optional) this agent.

AgentID (optional) The agent’s ACD login ID. STRING 12

AgentExtension (optional) The agent’s ACD teleset extension. STRING 16

AgentInstrument (optional) The agent’s ACD instrument number. STRING 64

Duration (optional) If present specifies in seconds the anticipated time in UINT 4


the state specified. This useful for work states to
estimate the time before going ready or not ready.

NextAgentState The next agent state (if known). USHORT 2

Direction The direction of the call the agent is currently working UINT 4
on:
• 0 = None
• 1 = In
• 2 =Out
• 3 = Other In
• 4 = Other Out
• 5 = OutboundReserve
• 6 = OutboundPreview
• 7 = OutboundPredictiv

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
83
Application Level Interfaces
CALL_REACHED_NETWORK_EVENT

FltSkillGroupNumber The number of an agent SkillGroup queue that the call INT 4
has been added to, as known to the peripheral. May
contain the special value NULL_SKILL_GROUP
when not applicable or not available. There may be
more than one SkillGroupNumber field in the message
(see NumSkillGroups).

FltSkillGroupID The Unified CCE SkillGroupID of the agent UINT 4


SkillGroup queue that the call has been added to. May
contain the special value NULL_SKILL_GROUP
when not applicable or not available. There may be
more than one SkillGroupID field in the message (see
NumSkillGroups). This field always immediately
follows the corresponding SkillGroupNumber field.

FltSkillGroup Priority The priority of the skill group, or 0 when skill group USHORT 2
priority is not applicable or not available. There may
be more than one SkillGroupPriority field in the
message (see NumSkillGroups). This field always
immediately follows the corresponding SkillGroupID
field.

FltSkillGroupState An AgentState value representing the current state of USHORT 2


the associated agent with respect to the skill group.
There may be more than one SkillGroupState field in
the message (see NumSkillGroups). This field always
immediately follows the corresponding
SkillGroupPriority field.

Related Topics
AgentState Values, on page 265
CALL_DELIVERED_EVENT, on page 58
PeripheralType Values, on page 267
Special Values, on page 251
AgentState Values, on page 265

CALL_REACHED_NETWORK_EVENT
The CTI Server may send a CALL_REACHED_NETWORK_EVENT message to the CTI client when an
outbound call is connected to another network.

Table 38: CALL_REACHED_NETWORK_EVENT Message Format

Fixed Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
84
Application Level Interfaces
CALL_REACHED_NETWORK_EVENT

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 34. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused UINT 4
this message to be sent to the client, or zero if there is no
monitor associated with the event (All Events Service).

PeripheralID The Unified CCE PeripheralID of the ACD where the call UINT 4
activity occurred.

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

LineHandle This field identifies the teleset line used, if known. USHORT 2
Otherwise this field is set to 0xffff.

LineType Indicates the type of the teleset line given in the LineHandle USHORT 2
field.

TrunkUsedDevice Type The type of device ID in the TrunkUsedDeviceID floating USHORT 2


field.

CalledDeviceType The type of device ID in the CalledDeviceID floating field. USHORT 2

LocalConnectionState The state of the local end of the connection. USHORT 2

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID The device ID of the device associated with the connection. STRING 64

TrunkUsedDeviceID The device ID of the selected trunk. STRING 64


(optional)

CalledDeviceID The device ID of the called device. STRING 64


(optional)

TrunkNumber (optional) The number representing a trunk. UINT 4

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
85
Application Level Interfaces
CALL_QUEUED_EVENT

TrunkGroup Number The number representing a trunk group. UINT 4


(optional)

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267

CALL_QUEUED_EVENT
The CTI Server may send a CALL_QUEUED_EVENT message to the CTI client when a call is placed in a
queue pending the availability of some resource.

Table 39: CALL_QUEUED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 21. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The Unified CCE PeripheralID of the ACD where the call UINT 4
activity occurred.

PeripheralType The type of the peripheral. USHORT 2

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value NULL_SERVICE
when not applicable or not available.

ServiceID The ServiceID of the service that the call is attributed to. May UINT 4
contain the special value NULL_SERVICE when not applicable
or not available.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
86
Application Level Interfaces
CALL_QUEUED_EVENT

QueueDeviceType The type of device ID in the QueueDeviceID floating field. USHORT 2

CallingDeviceType The type of device ID in the CallingDeviceID floating field. USHORT 2

CalledDeviceType The type of device ID in the CalleDeviceID floating field. USHORT 2

LastRedirect The type of device ID in the LastRedirectDeviceID floating USHORT 2


DeviceType field.

NumQueued The number of calls in the queue for this service. USHORT 2

NumSkillGroups The number of Skill Group queues that the call has queued to, USHORT 2
up to a maximum of 20. This value also indicates the number
of Skill GroupNumber, Skill GroupID, and SkillGroupPriority
floating fields in the floating part of the message.

LocalConnection The state of the local end of the connection. USHORT 2


State

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The device ID of the device associated with the connection. STRING 64
ID

QueueDeviceID The device ID of the queuing device. STRING 64


(optional)

CallingDeviceID The device ID of the calling device. STRING 64


(optional)

CalledDeviceID The device ID of the called device. STRING 64


(optional)

LastRedirectDevice The device ID of the redirecting device. STRING 64


ID (optional)

SkillGroupNumber The number of an agent SkillGroup queue that the call has been INT 4
added to, as known to the peripheral. May contain the special
value NULL_SKILL_GROUP when not applicable or not
available. There may be more than one SkillGroup Number
field in the message (see NumSkillGroups). Some ACDs ignore
this field and/or use the ACD default; see the list in the
CALL_DELIVERED_EVENT section.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
87
Application Level Interfaces
CALL_DEQUEUED_EVENT

SkillGroupID The Unified CCE SkillGroupID of the agent SkillGroup queue UINT 4
that the call has been added to. May contain the special value
NULL_SKILL_ GROUP when not applicable or not available.
There may be more than one SkillGroupID field in the message
(see NumSkill Groups). This field always immediately follows
the corresponding SkillGroupNumber field.

SkillGroupPriority The priority of the skill group, or 0 when skill group priority USHORT 2
is not applicable or not available. There may be more than one
SkillGroup Priority field in the message (see NumSkillGroups).
This field always immediately follows the corresponding
SkillGroupID field.

Related Topics
CALL_DELIVERED_EVENT, on page 58
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

CALL_DEQUEUED_EVENT
The CTI Server may send a CALL_DEQUEUED_EVENT message to the CTI client when a call is removed
from a queue.

Table 40: CALL_DEQUEUED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 86. MHDR 8

MonitorID The Monitor ID of the device or call monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

PeripheralID The Unified CCE PeripheralID of the ACD where the call UINT 4
activity occurred.

PeripheralType The type of the peripheral. USHORT 2

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
88
Application Level Interfaces
CALL_DEQUEUED_EVENT

ConnectionDevice The type of device ID in the ConnectionDeviceID floating field. USHORT 2


IDType

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

QueueDeviceType Indicates the type of device identifier supplied in the USHORT 2


QueueDeviceID floating field.

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value NULL_SERVICE
when not applicable or not available.

ServiceID The ServiceID of the service that the call is attributed to. May UINT 4
contain the special value NULL_ SERVICE when not applicable
or not available.

NumQueued The number of calls remaining in the queue for this service. USHORT 2

NumSkillGroups The number of Skill Group queues that the call has been USHORT 2
removed from, up to a maximum of 20. This value also indicates
the number of SkillGroupNumber, Skill GroupID, and
SkillGroup Priority floating fields in the floating part of the
message. A zero value indicates that the call has been implicitly
removed from all queues.

LocalConnection The state of the local end of the connection. USHORT 2


State

EventCause A reason for the occurrence of the event. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

Connection The device ID of the device associated with the connection. STRING 64
DeviceID

SkillGroup Number The number of an agent Skill Group queue that the call has been UINT 4
removed from, as known to the peripheral. May contain the
special value NULL_SKILL_GROUP when not applicable or
not available. There may be more than one SkillGroupNumber
field in the message (see NumSkillGroups). Some ACDs ignore
this field and/or use the ACD default; see the list in the
CALL_DELIVERED_EVENT section.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
89
Application Level Interfaces
CALL_ATTRIBUTE_CHANGE_EVENT

SkillGroupID The SkillGroupID of the agent SkillGroup queue that the call UINT 4
has been removed from. May contain the special value
NULL_SKILL_GROUP when not applicable or not available.
There may be more than one SkillGroupID field in the message
(see NumSkill Groups). This field always immediately follows
the corresponding SkillGroup Number field.

SkillGroupPriority The priority of the skill group, or 0 when skill group priority is USHORT 2
not applicable or not available. There may be more than one
SkillGroup Priority field in the message (see NumSkillGroups).
This field always immediately follows the corresponding
SkillGroupID field.

Related Topics
CALL_DELIVERED_EVENT, on page 58
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
EventCause Values, on page 269
LocalConnectionState Values, on page 268
PeripheralType Values, on page 267
Special Values, on page 251

CALL_ATTRIBUTE_CHANGE_EVENT
Changes to certain key attributes of the call will generate a CALL_ATTRIBUTE_CHANGE_EVENT to the
client.

Table 41: CALL_ATTRIBUTE_CHANGE_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MHDR 8

MonitorID Always 0 UINT 4

PeripheralID The ICM PeripheralID of the ACD where the call UINT 4
is located.
(CRS_PERIPHERAL_ID for
ICD)

PeripheralType The type of the peripheral. USHORT 2


(PT_CRS or PT_IPCC)

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
90
Application Level Interfaces
AGENT_PRE_CALL_EVENT

ConnectionDeviceIDType Indicates the type of the connection identifier USHORT 4


supplied in the ConnectionDeviceID floating field.

CallTypeID The ICM call type of the call. May be 0 if not UINT 4
changed.

ServiceNumber The Peripheral Number of Service of the call. May UINT 4


be 0 if not changed.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID The identifier of the connection between the call STRING 64


and the device.
(Optional)

AGENT_PRE_CALL_EVENT
An AGENT_PRE_CALL_EVENT message is generated when a call or task is routed to Enterprise Agent.
The message contains the call context data that is assigned to the call after it arrives at the agent’s desktop.
Unlike the translation route event message, which is only sent to All Event clients, the AGENT_PRE_CALL_
EVENT message is also sent to the targeted Client Events client, if any. Typically, the
AGENT_PRE_CALL_EVENT message is received before the BEGIN_ CALL_EVENT announcing the
arrival of the call at the agent’s device. Application developers should note that it is possible, but not typical,
for the call to arrive at the agent and to receive a BEGIN_CALL_EVENT message and other call event
messages for the call before the AGENT_PRE_CALL_EVENT message is received.

Table 42: AGENT_PRE_CALL_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 105. MHDR 8

MonitorID The Monitor ID of the device monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

NumNamed Variables The number of NamedVariable floating fields present in the USHORT 2
floating part of the message.

NumNamedArrays The number of NamedArray floating fields present in the USHORT 2


floating part of the message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
91
Application Level Interfaces
AGENT_PRE_CALL_EVENT

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value NULL_SERVICE
when not applicable or not available.

ServiceID The Unified CCE ServiceID of the service that the call is UINT 4
attributed to. May contain the special value NULL_ SERVICE
when not applicable or not available.

SkillGroupNumber The number of the agent Skill Group the call is attributed to, UINT 4
as known to the peripheral. May contain the special value
NULL_ SKILL_GROUP when not applicable or not available.
Some ACDs ignore this field and/or use the ACD default;
see the list in the CALL_DELIVERED_EVENT section.

SkillGroupID The SkillGroupID of the agent SkillGroup the call is attributed UINT 4
to. May contain the special value NULL_SKILL_ GROUP
when not applicable or not available.

SkillGroupPriority The priority of the skill group, or 0 when skill group priority USHORT 2
is not applicable or not available.

MRDID Media Routing Domain ID as configured in Unified CCE and INT 4


the ARM client.

AgentSkillTargetID The skill target ID of the agent to whom the task or call will UINT 4
be routed.

Floating Part

Field Name Value Data Type Max.


Size

AgentInstrument The agent instrument that the call will be routed to. STRING 64

RouterCallKeyDay Together with the RouterCallKeyCallID field forms the UINT 4


unique 64-bit key for locating this call’s records in the Unified
CCE.

RouterCallKey CallID The call key created by Unified CCE. Unified CCE resets UINT 4
this counter at midnight.

RouterCallKey Together with RouterCallKeyDay and RouterCallKeyCallID UINT 4


SequenceNumber fields forms the TaskID.

ANI (optional) The calling line ID of the caller. STRING 40

UserToUserInfo The ISDN user-to-user information element. UNSPEC 131


(optional)

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
92
Application Level Interfaces
AGENT_PRE_CALL_ABORT_EVENT

DialedNumber The number dialed. STRING 40


(optional)

CallerEnteredDigits The digits entered by the caller in response to IVR prompting. STRING 40
(optional)

FltCallTypeID If present, shows the call type of the call. UINT 4


(optional)

PreCallInvokeID If present, specifies the invoke of the PreCall related to this UNIT 4
(optional) event.

CallVariable1 Call-related variable data. STRING 41


(optional)

… … … …

CallVariable10 Call-related variable data. STRING 41


(optional)

NamedVariable Call-related variable data that has a variable name defined in NAMED 251
(optional) the Unified CCE. There may be an arbitrary number of Named VAR
Variable and NamedArray fields in the message, subject to
a combined total limit of 2000 bytes.

NamedArray Call-related variable data that has an array variable name NAMED 252
(optional) defined in the Unified CCE. There may be an arbitrary number ARRAY
of Named Variable and NamedArray fields in the message,
subject to a combined total limit of 2000 bytes.

AgentID (optional) The agent ID of the agent to whom the task or call will be STRING 12
routed.

Related Topics
CALL_DELIVERED_EVENT, on page 58
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27
Special Values, on page 251

AGENT_PRE_CALL_ABORT_EVENT
An AGENT_PRE_CALL_ABORT_EVENT message is generated when a call or task that was previously
announced via an AGENT_PRE_CALL_EVENT cannot be routed as intended (due to a busy or other error
condition detected during call routing) to Enterprise Agent. The AGENT_PRE_CALL_ABORT_ EVENT
message is sent to the to ALL_EVENTS client.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
93
Application Level Interfaces
RTP_STARTED_EVENT

Table 43: AGENT_PRE_CALL_ABORT_EVENT Message Format

Fixed Part

Field Name Value Data Type Max.


Size

MessageHeader Standard message header. MessageType = 106. MHDR 8

MonitorID The Monitor ID of the device monitor that caused this UINT 4
message to be sent to the client, or zero if there is no monitor
associated with the event (All Events Service).

MRDID Media Routing Domain ID as configured in Unified CCE INT 4


and the ARM client.

Floating Part

Field Name Value Data Type Max.


Size

AgentInstrument The agent instrument that the call was to have been routed STRING 64
to.

RouterCallKeyDay Together with the RouterCall KeyCallID field forms the UINT 4
unique 64-bit key for locating this call’s records in the Unified
CCE.

RouterCallKey CallID The call key created by Unified CCE. Unified CCE resets UINT 4
this counter at midnight.

RouterCallKey Together with RouterCallKeyDay and RouterCallKeyCallID UINT 4


SequenceNumber fields forms the TaskID.

RTP_STARTED_EVENT
The RTP_STARTED_EVENT message indicates that an RTP media stream has been started. There are two
media streams for audio media so there will be two RTP Started events, one indicating the input has started
(i.e. the phone is listening) and the other that the output has started (i.e. the outgoing media from the agent
phone has begun).
The RTP_STARTED_EVENT message will generally come up at the same time as the established event. It
also occurs when a call is retrieved from being on hold, and when the transfer or conference operations are
completed.
There is no guarantee of order of the RTP started events in relationship to the established and retrieved events.
The RTP started events may occur before or after the established event.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
94
Application Level Interfaces
RTP_STARTED_EVENT

Table 44: RTP_STARTED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 116. MHDR 8

MonitorID The Monitor ID of the device or call monitor that UINT 4


caused this message to be sent to the client, or zero
if there is no monitor associated with the event (All
Events Service).

PeripheralID The PeripheralID of the ACD where the device is UINT 4


located.

ClientPort The TCP/IP port number of the CTI Client UINT 4


connection.

Direction The direction of the event. One of the following USHORT 2


values:
0: Input;
1: Output;
2: Bi-directional.

RTPType The type of the event. One of the following values: USHORT 2
0: Audio;
1: Video;
2: Data.

BitRate The media bit rate, used for g.723 payload only. UINT 4

EchoCancellation on/off USHORT 2

PacketSize In milliseconds. UINT 4

PayloadType The audio codec type. USHORT 2

ConnectionDevice IDType Indicates the type of the connection identifier USHORT 2


supplied in the ConnectionDeviceID floating field.

ConnectionCallID The Call ID value assigned to this call by the UINT 4


peripheral or Unified CCE.

Floating Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
95
Application Level Interfaces
RTP_STOPPED_EVENT

Field Name Value Data Type Max.


Size

Connection DeviceID The identifier of the connection between the call STRING 64
and the device.

ClientAddress The IP address of the CTI client. STRING 64

AgentID (optional) The agent’s ACD login ID. STRING 12

AgentExtension (optional) The agent’s ACD teleset extension. STRING 16

AgentInstrument (optional) The agent’s ACD instrument number. STRING 64

SendingAddress The IP Address that the client is sending the RTP STRING 64
stream to.

SendingPort The UDP port number that the client is sending the UINT 4
RTP Stream to.

RTP_STOPPED_EVENT
The RTP_STOPPED_EVENT message indicates that an RTP media has been stopped. There are two media
streams for audio media so there will be two RTP Stopped events, one indicating the input has started (i.e.
the phone is not listening) and the other that the output has started (i.e. the outgoing media from the agent
phone has stopped).
The RTP_STOPPED_EVENT will be received when the call is placed on hold, and when the call disconnects.

Table 45: RTP_STOPPED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 117. MHDR 8

MonitorID The Monitor ID of the device or call monitor that UINT 4


caused this message to be sent to the client, or zero
if there is no monitor associated with the event (All
Events Service).

PeripheralID The Unified CCE PeripheralID of the ACD where UINT 4


the device is located.

ClientPort The TCP/IP port number of the CTI Client UINT 4


connection that was closed.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
96
Application Level Interfaces
All Events Service

Direction The direction of the event. USHORT 2


One of the following values:
0: Input;
1: Output;
2: Bi-directional.

ConnectionDevice IDType Indicates the type of the connection identifier USHORT 2


supplied in the ConnectionDeviceID floating field.

ConnectionCallID The Call ID value assigned to this call by the UINT 4


peripheral or Unified CCE.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The identifier of the connection between the call STRING 64


and the device.

ClientAddress The IP address of the CTI client. STRING 64

AgentID (optional) The agent’s ACD login ID. STRING 12

AgentExtension (optional) The agent’s ACD teleset extension. STRING 16

AgentInstrument (optional) The agent’s ACD instrument number. STRING 64

SendingAddress The IP Address that the client is sending the RTP STRING 64
stream to.

SendingPort The UDP port number that the client is sending the UINT 4
RTP Stream to.

All Events Service


All Events Service
The All Events service is conceptually similar to the Client Events service, and uses many of the same messages.
Unlike the Client Events service, however, the CTI client that has been granted All Events service is associated
with a CTI Bridge application. Such a CTI Client receives messages for all call events, not just those associated
with a specific teleset. Also, because there is no specific teleset association, this CTI client may receive call
events that occur before any agent has been chosen by the peripheral for the call. The following messages
describe these additional events.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
97
Application Level Interfaces
CALL_DELIVERED_EVENT

Table 46: All Events Service Messages

Message When Sent to CTI Client

CALL_DELIVERED_EVENT When an inbound ACD trunk is seized.

CALL_TRANSLATION_ ROUTE_ When a call is routed to a peripheral monitored by the PG via a


EVENT translation route.

CALL_DELIVERED_EVENT
In addition to the Client Events service CALL_DELIVERED_EVENT message, a CTI client with the All
Events service may also receive a CALL_DELIVERED_EVENT message when an inbound ACD trunk is
seized. The same message format is used in both cases; the LocalConnectionState field distinguishes between
the two cases. In this case, the LocalConnectionState is set to LCS_INITIATE.

CALL_TRANSLATION_ROUTE_EVENT
The CTI Server sends a CALL_TRANSLATION_ROUTE_EVENT message to the CTI client when a call
is routed to a peripheral monitored by the PG via a translation route. The message contains the call context
data that will be assigned to the call after it arrives at the peripheral.

Table 47: CALL_TRANSLATION_ROUTE_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 22. MHDR 8

NumNamedVariables The number of Named Variable floating fields present USHORT 2


in the floating part of the message.

NumNamedArrays The number of NamedArray floating fields present in USHORT 2


the floating part of the message.

Floating Part

Field Name Value Data Type Max.


Size

ANI (optional) The calling line ID of the caller. STRING 40

UserToUserInfo (optional) The ISDN user-to-user information element. UNSPEC 131

DNIS The DNIS of the expected call. STRING 32

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
98
Application Level Interfaces
Peripheral Monitor Service

DialedNumber (optional) The number dialed. STRING 40

CallerEnteredDigits The digits entered by the caller in response to VRU STRING 40


(optional) prompting.

RouterCallKeyDay Together with the RouterCallKey CallID field forms UINT 4


the unique 64-bit key for locating this call’s records in
the Unified CCE.

RouterCallKeyCallID The call key created by Unified CCE. Unified CCE UINT 4
resets this counter at midnight.

RouterCallKey Together with RouterCallKeyDay and UINT 4


SequenceNumber RouterCallKeyCallID fields forms the TaskID.

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CallVariable10 (optional) Call-related variable data. STRING 41

NamedVariable (optional) Call-related variable data that has a variable name NAMED 251
defined in the Unified CCE. There may be an arbitrary VAR
number of Named Variable and NamedArray fields in
the message, subject to a combined total limit of 2000
bytes.

NamedArray (optional) Call-related variable data that has an array variable NAMED 252
name defined in the Unified CCE. There may be an ARRAY
arbitrary number of Named Variable and NamedArray
fields in the message, subject to a combined total limit
of 2000 bytes.

Related Topics
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

Peripheral Monitor Service


Peripheral Monitor service is similar to All Events service, and uses many of the same messages. Unlike All
Events service, however, the CTI client that has been granted Peripheral Monitor service must specify for
which devices and/or calls it wishes to receive events. The CTI client does this by establishing a separate
monitor for each device (Trunk, Trunk Group, or Agent Device) or call. The CTI client can add or remove
monitors at any time after it opens the session without closing and re-opening the session or affecting any
other established monitors. When a Peripheral Monitor client has multiple monitors that are relevant to an
event message, the client receives a corresponding number of event messages. The MonitorID in each event
message indicates which monitor is associated with that message. Peripheral Monitor service clients also

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
99
Application Level Interfaces
MONITOR_START_REQ

receive the CALL_TRANSLATION_ROUTE event described in Table 5-28


CALL_TRANSLATION_ROUTE_EVENT Message Format.
Monitors are not preserved across CTI Server failures or client session failures. All monitors that a CTI client
creates are automatically terminated when the session is terminated. In addition, call monitors are automatically
terminated when the corresponding call ends. CTI clients must re-create monitors when opening a new CTI
session following a failure or loss of connection. No messages are received for any events that may have
occurred during the intervening time interval.

Table 48: Peripheral Monitor Service Messages

Message When Sent to CTI Client

MONITOR_START_REQ When a new monitor is created for a call or device.

MONITOR_STOP_REQ When a call or device monitor is terminated.

CHANGE_MONITOR_MASK_ REQ When a call and agent state event mask is changed.

Related Topics
CALL_TRANSLATION_ROUTE_EVENT, on page 98

MONITOR_START_REQ
Use this message to create a new monitor for the given call or device.
This figure depicts the Monitor Start message flow.

Figure 10: Monitor Start Message Flow

This table defines the MONITOR_START_REQ Message Format.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
100
Application Level Interfaces
MONITOR_START_REQ

Table 49: MONITOR_START_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 93. MHDR 8

InvokeID An ID for this request message that will be returned UINT 4


in the corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call or device UINT 4
to be monitored is located.

Connection CallID The Call ID value of the call to be monitored. Set this UINT 4
field to zero when creating a monitor for a device.

CallMsgMask A bitwise combination of the Unsolicited Call Event UINT 4


Message Masks listed in that the CTI client wishes
to receive from this monitor.

AgentStateMask A bitwise combination of Agent State Masks that the UINT 4


CTI client wishes to receive from this monitor.

Connection DeviceIDType Indicates the type of the device identifier supplied in USHORT 2
the ConnectionDeviceID floating field when creating
a monitor for a call. Set this field to
CONNECTION_ID_NONE when creating a monitor
for a device.

MonitoredDeviceType Indicates the type of the device identifier supplied in USHORT 2


the MonitoredDeviceID floating field when creating
a monitor for a device. Set this field to
DEVID_NONE when creating a monitor for a call.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID The device identifier of the device associated with STRING 64


(required for call monitor) the connection.

MonitoredDevice ID The device identifier of the device to be monitored. STRING 64


(required for device monitor)

When the requested device or call monitor has been created, the CTI Server responds to the CTI client with
the MONITOR_START_CONF message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
101
Application Level Interfaces
MONITOR_STOP_REQ

Table 50: MONITOR_START_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 94. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

MonitorID The Monitor ID of the new device or call monitor. UINT 4

Related Topics
AgentState Values, on page 265
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274

MONITOR_STOP_REQ
Use this message to terminate a call or device monitor. This figure depicts the Monitor Stop message flow.

Figure 11: Monitor Stop Message Flow

The following tables define the MONITOR_STOP_REQ and MONITOR_STOP_CONF messages.

Table 51: MONITOR_STOP_REQ Message Format

Field Name Value Data Byte


Type Size

MessageHeader Standard message header. MessageType = 95. MHDR 8

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
102
Application Level Interfaces
CHANGE_MONITOR_MASK_REQ

InvokeID An ID for this request message, returned in the corresponding UINT 4


confirm message.

MonitorID The Monitor ID of the device or call monitor to be terminated. UINT 4

When the requested device or call monitor has been terminated, the CTI Server responds to the CTI client
with the MONITOR_STOP_CONF message.

Table 52: MONITOR_STOP_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 96. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

CHANGE_MONITOR_MASK_REQ
Use this message to change the call and agent state change event masks used to filter messages from the given
call or device monitor. This figure depicts the Change Monitor Mask message flow.

Figure 12: Change Monitor Mask Message Flow

Table 53: CHANGE_MONITOR_MASK_REQ Message Format

Field Name Value Data Type Byte Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
103
Application Level Interfaces
Client Monitor Service

MessageHeader Standard message header. MessageType = 97. MHDR 8

InvokeID An ID for this request message that will be returned in UINT 4


the corresponding confirm message.

MonitorID The Monitor ID of the device or call monitor whose call UINT 4
and agent state change event masks are to be changed.

CallMsgMask A bitwise combination of the Unsolicited Call Event UINT 4


Message Masks in that the CTI client wishes to receive
from this monitor.

AgentStateMask A bitwise combination of Agent State Masks that the UINT 4


CTI client wishes to receive from this monitor.

When the requested device or call monitor masks have been updated, the CTI Server responds to the CTI
client with the CHANGE_MONITOR_MASK_CONF message.

Table 54: CHANGE_MONITOR_MASK_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 98. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

Related Topics
AgentState Values, on page 265

Client Monitor Service


The CTI client that has been granted Client Monitor service receives notifications when any other CTI client
session is opened or closed. The client may then monitor the activity of any other CTI client session.

Table 55: Client Monitor Service Messages

Message When Sent to CTI Client

CLIENT_SESSION_OPENED_ EVENT When a new client session opens.

CLIENT_SESSION_CLOSED_ EVENT When a client session closes.

SESSION_MONITOR_START_ REQ When monitoring of a client session starts.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
104
Application Level Interfaces
CLIENT_SESSION_OPENED_EVENT

SESSION_MONITOR_STOP_ REQ When monitoring of a client session ends.

CLIENT_SESSION_OPENED_EVENT
This message indicates that a new CTI client session has been opened. One of these messages is sent for each
existing CTI client session to the newly opened session, as if those CTI clients had just opened their sessions.

Table 56: CLIENT_SESSION_OPENED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 99. MHDR 8

SessionID A value that uniquely identifies the newly opened UINT 4


CTI session.

PeripheralID If the session was opened for Client Events UINT 4


Service, this field contains the PeripheralID of
the ACD specified by the opening client.
Otherwise this field contains the special value
NULL_ PERIPHERAL_ID.

ServicesGranted A bitwise combination of the CTI Services that UINT 4


the opening client has been granted.

CallMsgMask A bitwise combination of Unsolicited Call Event UINT 4


Message Masks that were specified by the
opening client.

AgentStateMask A bitwise combination of Agent State Masks that UINT 4


were specified by the opening client.

ClientPort The TCP/IP port number of the opening CTI UINT 4


client connection.

Floating Part

Field Name Value Data Type Max.


Size

ClientAddress The IP address of the opening CTI client. STRING 64

ClientID The ClientID of the opening CTI client. STRING 64

ClientSignature The ClientSignature of the opening CTI client. STRING 64

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
105
Application Level Interfaces
CLIENT_SESSION_CLOSED_EVENT

AgentExtension (optional) The AgentExtension specified by the opening STRING 16


client, if any.

AgentID (optional) The AgentID specified by the opening client, if STRING 12


any.

AgentInstrument (optional) The AgentInstrument specified by the opening STRING 64


client, if any.

Related Topics
AgentState Values, on page 265
CTI Service Masks, on page 291

CLIENT_SESSION_CLOSED_EVENT
This message indicates that a CTI client session has been terminated.

Table 57: CLIENT_SESSION_CLOSED_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 100. MHDR 8

SessionID A value that uniquely identified the CTI session that was closed. UINT 4

PeripheralID If the session was opened for Client Events Service, this field UINT 4
contains the peripheral ID of the ACD specified by the other client
when the session was opened. Otherwise this field contains the
special value NULL_ PERIPHERAL_ID.

Status A status code indicating the reason for termination of the session. UINT 4

ClientPort The TCP/IP port number of the opening CTI client connection. UINT 4

Floating Part

Field Name Value Data Type Max.


Size

ClientAddress The IP address of the other CTI client. STRING 64

ClientID The ClientID of the other CTI client. STRING 64

ClientSignature The ClientSignature of the other CTI client. STRING 64

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
106
Application Level Interfaces
SESSION_MONITOR_START_REQ

AgentExtension The AgentExtension specified by the other CTI client when the STRING 16
(optional) session was opened, if any.

AgentID (optional) The AgentID specified by the other CTI client when the session STRING 12
was opened, if any.

AgentInstrument The AgentInstrument specified by the other CTI client when the STRING 64
(optional) session was opened, if any.

SESSION_MONITOR_START_REQ
Use this message to initiate monitoring of the given CTI client session. This figure depicts the Session Monitor
Start message flow. The SESSION_MONITOR_START_REQ and SESSION_MONITOR_START_CONF
messages formats are defined in the tables given in the following.

Figure 13: Session Monitor Start message flow

Table 58: SESSION_MONITOR_START_REQ Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType =101. MHDR 8

InvokeID An ID for this request message that will be returned in UINT 4


the corresponding confirm message.

SessionID A value that uniquely identifies the CTI session to be UINT 4


monitored.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
107
Application Level Interfaces
SESSION_MONITOR_STOP_REQ

When the requested session monitor has been created, the CTI Server responds to the CTI client with the
SESSION_MONITOR_START_CONF message.

Table 59: SESSION_MONITOR_START_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 102. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

MonitorID The Monitor ID of the CTI client session monitor that UINT 4
was created.

SESSION_MONITOR_STOP_REQ
Use this message to terminate monitoring of a CTI client session. This figure depicts the Session Monitor
stop message flow.

Figure 14: Session Monitor Stop Message Flow

Table 60: SESSION_MONITOR_STOP_REQ Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType =103. MHDR 8

InvokeID An ID for this request message that will be returned UINT 4


in the corresponding confirm message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
108
Application Level Interfaces
Supervisor Service

MonitorID The Monitor ID of the CTI client session monitor to UINT 4


be terminated.

When the requested CTI client session monitor terminates, the CTI Server responds to the CTI client with the
SESSION_MONITOR_STOP_CONF message.

Table 61: SESSION_MONITOR_STOP_CONF Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType =104. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

Supervisor Service
The Supervisor service requests supervisor services when the client opens a CTI session.
CTI_SERVICE_SUPERVISOR service type will be used in addition to the existing Service types, and requires
CTI_SERVICE_CLIENT_EVENTS to be specified as well.
Supervisor services rely on the configuration of Agent Teams in the Unified CCE. When an agent opens a
session with CTI_SERVICE_SUPERVISOR service type requested, the CTI Server will check to see if the
agent is configured as a supervisor. If the agent is a supervisor, the CTI Server will open the session and send
the OPEN_CONF to the agent. Otherwise, the FAILURE_CONF message with the status code set to
E_CTI_FUNCTION_NOT_AVAILABLE will be sent to the requesting client.
The CTI Client that has been granted Supervisor Service receives notifications whenever agent team clients
request supervisor assistance or indicate that they are handling an emergency call. The following messages
are used by Supervisor Service clients to provide these notifications and to perform agent supervisory functions.

Table 62: Supervisor Service Messages

Message When Sent to CTI Client

SUPERVISE_CALL_REQ When a supervisor requests to barge in or intercept a call.

EMERGENCY_CALL_EVENT When the CTI Server is handling the current call as an


emergency call.

AGENT_TEAM_CONFIG_ EVENT When a supervisor adds or changes the list of agent team
members.

LIST_AGENT_TEAM_REQ When a supervisor requests a list of associated agent teams.

MONITOR_AGENT_TEAM_ START_REQ When a supervisor starts monitoring an agent team.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
109
Application Level Interfaces
SUPERVISE_CALL_REQ

MONITOR_AGENT_TEAM_ STOP_REQ When a supervisor stops monitoring an agent team.

SUPERVISE_CALL_REQ
At any time, for monitoring quality of service, training, etc., a supervisor CTI client may send a
SUPERVISE_CALL_REQ message to the CTI Server to request barge-in or interception of a call. At end of
such call supervision, a supervisor CTI client should send SUPERVISE_CALL_REQ message with
SUPERVISOR_CLEAR as the SupervisorAction value to disconnect the supervisor’s device from the call.
The SUPERVISE_CALL_REQ message allows a supervisor CTI Client to supervise an agent’s call, either
through barge-in or interception. The client may select a specific agent call connection, or may select an
agent’s currently active call by specifying only the agent:

Table 63: SUPERVISE_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 124. MHDR 8

InvokeID An ID for this request message that will be UINT 4


returned in the corresponding confirm
message.

PeripheralID The PeripheralID of the ACD where the call UINT 4


is located.

AgentConnection CallID The Call ID value assigned to the call by the UINT 4
peripheral or Unified CCE. May contain the
special value 0xffffffff when selecting the
agent’s currently active call.

SupervisorConnection CallID The Call ID value of the supervisor. If there UINT 4


is no supervisor call, this field must be set to
0xffffffff.

AgentConnection DeviceIDType Indicates the type of the connection identifier USHORT 2


supplied in the AgentConnection DeviceID
floating field.

SupervisorConnection Indicates the type of the connection identifier USHORT 2


DeviceIDType supplied in the SupervisorConnection
DeviceID floating field.

SupervisoryAction A SupervisoryAction value specifying the USHORT 2


desired call supervision operation.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
110
Application Level Interfaces
SUPERVISE_CALL_REQ

Floating Part

Field Name Value Data Type Max.


Size

AgentConnection DeviceID The identifier of the connection of the agent STRING 64


call and the agent’s device. Either
ConnectionCallID and ConnectionDeviceID,
or one of AgentExtension, AgentID, or
AgentInstrument must be provided.

Supervisor Connection DeviceID The identifier of the connection of the STRING 64


supervisor call and the supervisor’s device.
Either Connection CallID and Connection
DeviceID, or one of Agent Extension,
AgentID, or Agent Instrument must be
provided.

AgentExtension The agent’s ACD teleset extension. Either STRING 16


Connection CallID and ConnectionDevice ID,
or one of AgentExtension, AgentID, or
AgentInstrument must be provided.

AgentID The agent’s ACD login ID. Either STRING 12


ConnectionCallID and ConnectionDeviceID,
or one of AgentExtension, AgentID, or
AgentInstrument must be provided.

AgentInstrument The agent’s ACD instrument number. Either STRING 64


Connection CallID and ConnectionDevice ID,
or one of AgentExtension, AgentID, or
AgentInstrument must be provided.

Supervisor Instrument The supervisor’s ACD instrument number. STRING 64


This field is required for clients with ALL
EVENTS or PERIPHERAL MONITOR
service.

Table 64: SupervisoryAction Values

SupervisoryAction Description Value

SUPERVISOR_CLEAR The supervisor device is to be disconnected from the call. 0

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
111
Application Level Interfaces
SUPERVISE_CALL_REQ

SUPERVISOR_MONITOR The supervisor device is to be connected to the call for silent 1


monitoring. This allows the supervisor to hear all parties
participating in the call.
A field SilentMonitorWarning in the Agent_Desk_Settings table
determines if a warning message box will be prompted on agent
desktop when silent monitor starts.
A field SilentMonitorASudible Indication in the
Agent_Desk_Settings table determines if an audible click will be
played to the call at beginning of the silent monitor.

SUPERVISOR_WHISPER The supervisor device is to be connected to the call for training or 2


whisper. This allows the supervisor to talks to the agent and the
customer will not hear the call.

SUPERVISOR_BARGE_IN The supervisor device is to be connected to the call as an active 3


participant. This allows the supervisor to speak to all parties
participating in the call, as in a conference.

SUPERVISOR_INTERCEPT The supervisor device is to be connected to the call as an active 4


participant and the agent connection will be dropped.

SUPERVISE_CALL_CONF Message Format


The CTI Server responds to the CTI Client with the SUPERVISE_CALL_CONF message.

Table 65: SUPERVISE_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 125. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

ConnectionCallID The Call ID value assigned to the call by the peripheral UINT 4
or Unified CCE.

ConnectionDeviceIDType Indicates the type of the connection identifier supplied USHORT 2


in the ConnectionDeviceID floating field.

Floating Part

Field Name Value Data Type Max.


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
112
Application Level Interfaces
EMERGENCY_CALL_REQ

ConnectionDevice ID The identifier of the connection between the call and STRING 64
the agent device that is being supervised.

Related Topics
ConnectionDeviceIDType Values, on page 277

EMERGENCY_CALL_REQ
The EMERGENCY_CALL_REQ message indicates that a CTI Client is handling the indicated call as an
emergency call:

Table 66: EMERGENCY_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 121. MHDR 8

InvokeID An ID for this request message that will be returned UINT 4


in the corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

ConnectionCallID The Call ID value of the call that the agent needs UINT 4
assistance with. May contain the special value
0xffffffff when there is no related call.

ConnectionDevice IDType Indicates the type of the connection identifier USHORT 2


supplied in the ConnectionDeviceID floating field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The identifier of the connection between the call STRING 64


and the agent’s device.

AgentExtension The agent’s ACD teleset extension. For clients with STRING 16
ALL EVENTS or PERIPHERAL MONITOR
service, at least one of AgentExtension, AgentID,
or AgentInstrument must be provided.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
113
Application Level Interfaces
EMERGENCY_CALL_REQ

AgentID The agent’s ACD login ID. For clients with ALL STRING 12
EVENTS or PERIPHERAL MONITOR service, at
least one of AgentExtension, AgentID, or
AgentInstrument must be provided.

AgentInstrument The agent’s ACD instrument number. For clients STRING 64


with ALL EVENTS or PERIPHERAL MONITOR
service, at least one of AgentExtension, AgentID,
or AgentInstrument must be provided.

EMERGENCY_CALL_CONF Message Format


The CTI Server responds to the CTI Client with the EMERGENCY_CALL_CONF message:

Table 67: EMERGENCY_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 122. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

ConnectionCallID The Call ID value assigned to the resulting UINT 4


EmergencyAssist call by the peripheral or Unified
CCE.

ConnectionDevice IDType Indicates the type of the connection identifier supplied USHORT 2
in the ConnectionDeviceID floating field.

LineHandle This field identifies the teleset line used, if known. USHORT 2
Otherwise this field is set to 0xffff.

LineType Indicates the type of the teleset line given in the USHORT 2
LineHandle field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The identifier of the device connection associated with STRING 64


the new call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
114
Application Level Interfaces
EMERGENCY_CALL_EVENT

Related Topics
ConnectionDeviceIDType Values, on page 277
LineType Values, on page 278

EMERGENCY_CALL_EVENT
The EMERGENCY_CALL_EVENT message, defined below, notifies bridge clients that an agent is handling
the indicated call as an emergency call:

Table 68: EMERGENCY_CALL_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 123. MHDR 8

PeripheralID The PeripheralID of the ACD where the call is located. UINT 4

ConnectionCallID The Call ID value assigned to the call by the peripheral or UINT 4
Unified CCE.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType ConnectionDeviceID floating field.

SessionID The CTI client SessionID of the CTI client making the UINT 4
notification.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The identifier of the connection between the call and the STRING 64
agent’s device.

ClientID The ClientID of the client making the notification. STRING 64

ClientAddress The IP address of the client making the notification. STRING 64

AgentExtension The agent’s ACD teleset extension. STRING 16

AgentID The agent’s ACD login ID. STRING 12

AgentInstrument The agent’s ACD instrument number. STRING 64

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
115
Application Level Interfaces
AGENT_TEAM_CONFIG_EVENT

Related Topics
ConnectionDeviceIDType Values, on page 277

AGENT_TEAM_CONFIG_EVENT
Once a supervisor CTI client session is opened, the CTI Server sends one or more
AGENT_TEAM_CONFIG_EVENT messages with the list of team members for that supervisor.
The CTI Server also sends out the AGENT_TEAM_CONFIG_EVENT when any change is made to the agent
team configuration.
The AGENT_TEAM_CONFIG_EVENT message contains the list of team members for a supervisor or
changes to the team configuration.

Table 69: AGENT_TEAM_CONFIG_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 128. MHDR 8

PeripheralID The PeripheralID of the CTI Server where the team is located. UINT 4

TeamID The agent Team ID. UINT 4

NumberOfAgents The number of AgentID, AgentFlag, AgentState, and USHORT 2


StateDuration fields present in the floating part of the
message, up to a maximum of 64.

ConfigOperation The type of agent team configuration change to perform. USHORT 2


One of the following values:
0: Restore Permanent Configuration
1: Add Agent
2: Remove Agent

DepartmentID Department ID of the Team INT 4

Floating Part

Field Name Value Data Type Max.


Size

AgentTeamName Name of the agent team. STRING 32

AtcAgentID The AgentID of a member of the agent team, or SupervisorID STRING 12


(optional) of the agent team. There may be more than one AgentID
field in the messages (see NumberOfAgents).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
116
Application Level Interfaces
LIST_AGENT_TEAM_REQ

AgentFlags (optional) A set of flags indicating the attributes of the corresponding USHORT 2
AgentID. Possible values are:
0x0001: Primary Supervisor;
0x0002: Temporary Agent;
0x0004: Supervisor.
(0 flag is for regular agent)
There may be more than one AgentFlags field in the message
(see NumberOfAgents).

AtcAgentState An AgentState value representing the current overall state USHORT 2


of the associated agent.

AtcStateDuration The number of seconds since the agent entered this state. UINT 4

LIST_AGENT_TEAM_REQ
A CTI Supervisor Client could use the LIST_AGENT_TEAM_REQ message to obtain the list of associated
agent teams. Once the list of agent teams is obtained, the supervisor could use
MONITOR_AGENT_TEAM_START_REQ to start monitoring agent teams. The agent states of the agent
team will be send to the requesting supervisor session until a MONITOR_AGENT_TEAM_STOP_REQ is
received.
When any change is made to the agent team configuration, an AGENT_TEAM_CONFIG_EVENT will be
sending out. If agent team and supervisor mapping are changed (add or remove), an
AGENT_TEAM_CONFIG_EVENT will be sending out with AgentFlags set to 0x0004 for supervisor.
The LIST_AGENT_TEAM_REQ message allows a CTI Supervisor Client to obtain the list of agent team
that the supervisor can monitor. The list should be pre-configured in the Agent Team Supervisor Table.

Table 70: LIST_AGENT_TEAM_REQ Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 133. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

SupervisorID Skill target ID of the requesting supervisor. UINT 4

The LIST_AGENT_TEAM_CONF message contains the list of agent teams that associated with the requesting
supervisor.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
117
Application Level Interfaces
MONITOR_AGENT_TEAM_START_REQ

Table 71: LIST_AGENT_TEAM_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 134. MHDR 8

InvokeID Same ID as the request message. UINT 4

NumberOfAgent The number of TeamID present in the floating part of the USHORT 2
Teams message, up to a maximum of 64.

Segment Number Indicates the segment number of this message. USHORT 2

More Indicates if this message is the last confirmation. (More than USHORT 2
one confirmations are sent out if more than 64 Agent Teams
are associated with the supervisor).
0: last message;
1: more messages to follow;

Floating Part

Field Name Value Data Type Max.


Size

TeamID The agent team ID. There may be more than one TeamID UINT 4
field in the message (see NumberOf AgentTeams).

MONITOR_AGENT_TEAM_START_REQ
The MONITOR_AGENT_TEAM_START_REQ allows a CTI Supervisor Client to start monitoring agent
team.

Table 72: MONITOR_AGENT_TEAM _START_REQ Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 135. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

TeamID The agent team ID. UINT 4

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
118
Application Level Interfaces
MONITOR_AGENT_TEAM_STOP_REQ

When the request has been received, the CTI Server responds to the CTI Client with the
MONITOR_AGENT_TEAM_START_CONF message.

Table 73: MONITOR_AGENT_TEAM _START_CONF Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 136. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

MonitorID The Monitor ID. UINT 4

MONITOR_AGENT_TEAM_STOP_REQ
The MONITOR_AGENT_TEAM_STOP_REQ message allows a CTI Supervisor Client to stop monitoring
agent teams.

Table 74: MONITOR_AGENT_TEAM_STOP_REQ Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 137. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

MonitorID The Monitor ID. UINT 4

When the request has been received, the CTI Server responds to the CTI Client with the
MONITOR_AGENT_TEAM_STOP_CONF message.

Table 75: MONITOR_AGENT_TEAM _STOP_CONF Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 138. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
119
Application Level Interfaces
Call Data Update Service

Call Data Update Service


Unified CCE maintains a set of call variables for each call. Each variable is capable of storing a null terminated
string of up to 40 characters (40 variable characters + null termination character = 41 bytes, STRING [41]).
When Unified CCE pre-routes a call, it initializes each call variable to either a peripheral-determined value
or a null string prior to executing the routing script. Post-routed calls initialize all call variables to
peripheral-determined values.
Unified CCE can use the values of the call variables to make routing decisions. The variables may contain
additional information about the caller, such as result of a host database query. While routing a call, the Unified
CCE routing script may update one or more of the call variables.
A CTI client associated with the call may also set the call variables by using the SET_CALL_DATA_REQ
message. When a call terminates, the final values of the call are recorded in the Unified CCE’s central database
and are available for use in historical reports. CTI clients with the Call Data Update service enabled may set
an additional variable, CallWrapupData, for recording additional call information in the Unified CCE’s central
database. The CTI client has a small amount of time (configurable during Web setup, default is 2 minutes)
after the completion of a call to provide the call wrapup data before the call termination record is logged in
the Unified CCE.
When one or more call variables are determined by the peripheral, an Unified CCE Peripheral Configuration
entry, CallControlVariableMap, determines if a CTI client may override the peripheral-determined setting of
each call variable. You can set the value of CallControlVariableMap for each peripheral in Configure Unified
CCE. For example, the setting “/CTI = ynnnyyyyyy” allows a CTI client to set call variable 1 and call variables
5 through 10 while preserving the peripheral-determined values of call variables 2 through 4.

Table 76: Call Data Update Service Messages

Message When Sent to CTI Server

SET_CALL_DATA_REQ To set call variables and/or call wrapup data.

RELEASE_CALL_REQ To indicate that you are finished with a call and that all call
variable and call wrapup updates have been made.

SET_DEVICE_ATTRIBUTES_REQ To set the default service, skill group, and call type information
associated with a calling device that is defined in the Unified CCE
Dialer_Port_Map database table.

SET_CALL_DATA_REQ
Send this message to the CTI Server to set one or more call variables and/or call wrapup data. The combination
of ConnectionCallID, ConnectionDeviceIDType, and ConnectionDeviceID uniquely identify the call to be
operated upon. Variables not provided in the message are not affected. This figure depicts the Set Call Data
message flow

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
120
Application Level Interfaces
SET_CALL_DATA_REQ

Table 77: SET_CALL_DATA_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 26. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is located. UINT 4

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType ConnectionDeviceID floating field.

ConnectionCallID The Call ID value assigned to the call by the peripheral or UINT 4
Unified CCE.

NumNamed The number of NamedVariable floating fields present in the USHORT 2


Variables floating part of the message.

NumNamedArrays The number of NamedArray floating fields present in the USHORT 2


floating part of the message.

CallType The general classification of the call type. USHORT 2

CalledParty Indicates the disposition of called party. USHORT 2


Disposition

CampaignID Campaign ID for value that appears in the Agent Real Time UINT 4
table. Set to zero if not used.

QueryRuleID Query rule ID for value that appears in the Agent Real Time UINT 4
table. Set to zero if not used.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
121
Application Level Interfaces
SET_CALL_DATA_REQ

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The identifier of the connection between the call and the STRING 64
device.

ANI (optional) The calling line ID of the caller. STRING 40

UserToUserInfo The ISDN user-to-user information element. UNSPEC 131


(optional)

CallerEnteredDigits The digits entered by the caller in response to IVR prompting. STRING 40
(optional)

CallVariable1 Call-related variable data. STRING 41


(optional)

… … … …

CallVariable10 Call-related variable data. STRING 41


(optional)

CallWrapupData Call-related wrapup data. STRING 40


(optional)

NamedVariable Call-related variable data that has a variable name defined in NAMED 251
(optional) the Unified CCE. There may be an arbitrary number of Named VAR
Variable and NamedArray fields in the message, subject to a
combined total limit of 2000 bytes.

NamedArray Call-related variable data that has an array variable name NAMED 252
(optional) defined in the Unified CCE. There may be an arbitrary number ARRAY
of Named Variable and NamedArray fields in the message,
subject to a combined total limit of 2000 bytes.

CustomerPhone Customer phone number for value that appears in the Agent STRING 20
Number (optional) Real Time table.

CustomerAccount Customer Account Number for value that appears in the Agent STRING 32
Number (optional) Real Time table.

RouterCallKeyDay If specified, allows setting of the router call keyday. UINT 4


(optional)

RouterCallKey If specified, allows setting of theRouterCallKeyID. UINT 4


CallID

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
122
Application Level Interfaces
RELEASE_CALL_REQ

RouterCallKey If specified, allows setting of the UINT 4


SequenceNumber RouterCallKeySequenceNumber.

CallOriginated From Dialer Only ‘D’. Tags a call as being originated from the dialer. UCHAR 1

When the requested call variables have been updated and the new values are guaranteed to remain set should
the CTI session be abnormally terminated, the CTI Server responds to the CTI client that requested the update
with the SET_CALL_DATA_CONF message.

Table 78: SET_CALL_DATA_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 27. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding UINT 4
request message.

Related Topics
CallType Values, on page 275
ConnectionDeviceIDType Values, on page 277
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

RELEASE_CALL_REQ
Send this message to the CTI Server to indicate that you are finished with a call and that all call variable and
call wrapup data updates have been made. This message does not disconnect the call. The combination of
ConnectionCallID, ConnectionDeviceIDType, and ConnectionDeviceID uniquely identify the call to be
operated upon. CTI clients with Call Data Update Service should use this message to let the call termination

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
123
Application Level Interfaces
RELEASE_CALL_REQ

record be logged in the Unified CCE central database prior to the expiration of the call wrapup data timer
(default value 2 minutes).

Figure 15: Release Call Message Flow

Table 79: RELEASE_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 28. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

Connection The type of device ID in the ConnectionDevice ID USHORT 2


DeviceIDType floating field.

Connection CallID The Call ID value assigned to the call by the UINT 4
peripheral or Unified CCE.

Floating Part

Field Name Value Data Type Byte Size

Connection DeviceID The device ID of the device associated with the STRING 64
connection.

The CTI Server responds to the CTI client with the RELEASE_CALL_CONF message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
124
Application Level Interfaces
SET_DEVICE_ATTRIBUTES_REQ

Table 80: RELEASE_CALL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 29. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

SET_DEVICE_ATTRIBUTES_REQ
This message is sent by a CTI Client to set the default service, skill group, and call type information associated
with a calling device that is defined in the Unified CCE Dialer_Port_Map database table. The default attributes
are initially assigned to all subsequent calls that originate from that device, although the service, skill group,
and call type of any call may be modified during subsequent call handling. These tables define the
SET_DEVICE_ATTRIBUTES_REQ and SET_DEVICE_ATTRIBUTES_CONF messages.

Table 81: SET_DEVICE_ATTRIBUTES_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 141. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is located. UINT 4

ServiceNumber The service that the call is attributed to, as known to the UINT 4
peripheral. May contain the special value NULL_SERVICE
when not applicable or not available.

ServiceID The ServiceID of the service that the call is attributed to. UINT 4
May contain the special value NULL_SERVICE when not
applicable or not available.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
125
Application Level Interfaces
SET_DEVICE_ATTRIBUTES_REQ

SkillGroupNumber The number of the agent SkillGroup the call is attributed UINT 4
to, as known to the peripheral. May contain the special
value NULL_SKILL_GROUP when not applicable or not
available.Some ACDs ignore this field and/or use the ACD
default; see the list in the CALL_DELIVERED_EVENT
section.

SkillGroupID The SkillGroupID of the agent SkillGroup the call is UINT 4


attributed to. May contain the special value NULL_SKILL_
GROUP when not applicable or not available.

SkillGroupPriority The priority of the skill group, or 0 when skill group USHORT 2
priority is not applicable or not available.

CallType The general classification of the call type. May contain the USHORT 2
special value NULL_CALLTYPE.

CallingDeviceType Indicates the type of the device identifier supplied in the USHORT 2
CallingDeviceID floating field.

Floating Part

Field Name Value Data Type Max.


Size

CallingDeviceID The device identifier of the calling device. STRING 64


(required)

When the requested default settings have been updated the CTI Server responds to the CTI Client that requested
the update with the SET_DEVICE_ATTRIBUTES_CONF message. A FAILURE_CONF message is returned
if the provided Service or SkillGroup values are invalid, or if the CallingDevice is not configured in the Unified
CCE Dialer_Port_Map database table.

Table 82: SET_DEVICE_ATTRIBUTES_CONF Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 142. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding request UINT 4
message.

Related Topics
CALL_DELIVERED_EVENT, on page 58
CallType Values, on page 275

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
126
Application Level Interfaces
Miscellaneous Service

ConnectionDeviceIDType Values, on page 277


Special Values, on page 251

Miscellaneous Service
The Miscellaneous service is provided to all connected CTI clients. This service consists of a variety of
unsolicited event messages and request/response paired messages.

Table 83: Miscellaneous Service Messages

Message When Sent by CTI Server

SYSTEM_EVENT To report current PG status or to provide the CTI client


with event data.

CLIENT_EVENT_REPORT_REQ To report significant events through the Unified CCE


Alarm subsystem.

USER_MESSAGE_REQ To send a message to a specified client, the client agent’s


supervisor, all clients in the client agent’s team, or all
clients connected to the CTI Server.

USER_MESSAGE_EVENT To deliver a message that was sent from another CTI


Server client.

QUERY_AGENT_STATISTICS_ REQ To obtain the current call handling statistics for the
client’s agent.

QUERY_SKILL_GROUP_ STATISTICS_REQ To obtain the current call handling statistics for one of
the client agent’s skill groups.

REGISTER_VARIABLES_REQ To allow a CTI Client to register the call context


variables that it will use.

SET_APP_DATA_REQ Sent by CTI Client when it sets one of more application


variables.

START_RECORDING_REQ Sent by CTI Client on requesting the CTI Server to start


recording a call.

STOP_RECORDING_REQ Sent by CTI Client on requesting the CTI Server to stop


recording a call.

AGENT_DESK_SETTINGS_REQ To obtain current agent desk settings.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
127
Application Level Interfaces
SYSTEM_EVENT

SYSTEM_EVENT
System event messages include the current PG Status as well as data related to the specific event that has
occurred. You can use the PG Status as a general indication of the operational health of the PG. Normally
you need not be aware of any specific codes; a non-zero value indicates a component failure or data link
outage that prevents normal CTI operations.

Table 84: SYSTEM_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 31. MHDR 8

PGStatus The current operational status of the Peripheral UINT 4


Gateway. A non-zero value indicates a component
failure or communication outage that prevents
normal CTI operations.

ICMCentral The current Central Controller date and time. TIME 4


ControllerTime

SystemEventID A value that enumerates the specific system event UINT 4


that occurred (SystemEventID Values, on page
250).

SystemEventArg1 An argument value specific to the system event UINT 4


being reported. Not used by all system events.

SystemEventArg2 A second argument value specific to the system UINT 4


event being reported. Not used by all system events.

SystemEventArg3 A third argument value specific to the system event UINT 4


being reported. Not used by all system events.

EventDeviceType Indicates the type of the device identifier supplied USHORT 2


in the EventDeviceID floating field. Should be
DEVID_NONE if no floating field is provided.

Floating Part

Field Name Value Data Type Max. Size

Text (optional) A text message associated with the provided STRING 255
SystemEperiphventID.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
128
Application Level Interfaces
CLIENT_EVENT_REPORT_REQ

EventDeviceID A text value of the device ID if reported. Initially STRING 64


only used by Unified CCX for an
SYS_DEVICE_IN_SERVICE, and
SYS_DEVICE_OUT_OF_ SERVICE message.

Related Topics
DeviceIDType Values, on page 274
PGStatusCode Values, on page 266
SystemEventID Values, on page 250

CLIENT_EVENT_REPORT_REQ
Send the CLIENT_EVENT_REPORT_REQ message to report significant events through the Unified CCE
Alarm subsystem. The Unified CCE Alarm subsystem allows simple textual event reports as well as an
object-oriented model that tracks the current state of named objects. The Unified CCE Alarm subsystem can
also forward these events as SNMP traps.
A CTI client that elects to report events with named objects should initialize the objects in the Unified CCE
Alarm subsystem soon after establishing its session with the CTI Server by reporting the current state of each
named object. The object name given uniquely identifies the alarm object. Therefore, CTI client applications
that wish to create multiple instances of an alarm object must include some instance-identifying characters
(such as ClientID or ACD extension) in the object name.
For example, if a CTI client “A” and a CTI client “B” both report events on an object named “C”, there will be
one Unified CCE Alarm object “C” that is manipulated by both clients. If, on the other hand, the Client ID
were included in the object name, then two Unified CCE Alarm objects would result; object “A:C” being
manipulated by client “A” and object “B:C” being independently manipulated by client “B”.

Table 85: CLIENT_EVENT_REPORT_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 32. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

State One of the following values indicating the seriousness USHORT 2


of the event and the state of the named object, if
present. 0: normal (green), 1: warning (yellow), 2:
error (red).

Floating Part

Field Name Value Data Type Max.


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
129
Application Level Interfaces
USER_MESSAGE_REQ

ObjectName (optional) The name of the Unified CCE Alarm object affected STRING 128
by this event. The object is created if it does not
already exist.

Text A text message associated with the event being STRING 255
reported.

The CTI Server responds to the CTI client with the CLIENT_EVENT_REPORT_CONF message:

Table 86: CLIENT_EVENT_REPORT_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. Message Type = 33. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

USER_MESSAGE_REQ
The USER_MESSAGE_REQ message allows a CTI Client to send a message to a specified client, the client
agent’s supervisor, all clients in the client agent’s team, or all clients connected to the CTI Server.

Table 87: USER_MESSAGE_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 107. MHDR 8

InvokeID An ID for this request message, returned in the corresponding UINT 4


confirm message.

PeripheralID The PeripheralID of the ACD where the agent indicated by Agent UINT 4
Extension, AgentID, or Agent Instrument is located. For clients
with All Events or Peripheral Monitor service, this value must be
provided if the Distribution field specifies DISTRIBUTE_TO_
SUPERVISOR or DISTRIBUTE_ TO_TEAM.

Distribution A Message Distribution value specifying the desired distribution USHORT 2


of this message.

Floating Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
130
Application Level Interfaces
USER_MESSAGE_REQ

Field Name Value Data Type Byte


Size

ClientID The clientid of the intended message recipient. Required if the STRING 64
(optional) distribution field specifies DISTRIBUTE_TO_ CLIENT.

AgentExtension The agent’s ACD teleset extension. For clients with ALL EVENTS STRING 16
or PERIPHERAL MONITOR service, at least one of Agent
Extension, AgentID, or Agent Instrument must be provided if the
Distribution field specifies DISTRIBUTE_TO_ SUPERVISOR
or DISTRIBUTE_ TO_TEAM.

AgentID The agent’s ACD login ID. For clients with ALL EVENTS or STRING 12
PERIPHERAL MONITOR service, at least one of
AgentExtension, AgentID, or AgentInstrument must be provided
if the Distribution field specifies DISTRIBUTE_TO_
SUPERVISOR or DISTRIBUTE_ TO_TEAM.

AgentInstrument The agent’s ACD instrument number. For clients with ALL STRING 64
EVENTS or PERIPHERAL MONITOR service, at least one of
AgentExtension, AgentID, or AgentInstrument must be provided
if the Distribution field specifies DISTRIBUTE_TO_
SUPERVISOR or DISTRIBUTE_ TO_TEAM.

Text The text of the message to be sent. STRING 255

CTIOSCILClient Unique ID for use by CTI OS to identify CIL Client STRING 64


ID

Table 88: Message Distribution Values

Distribution Code Description Value

DISTRIBUTE_TO_ CLIENT The message is to be sent to the client indicated by the 0


ClientID field.

DISTRIBUTE_TO_ SUPERVISOR The message is to be sent to the agent team supervisor. 1

DISTRIBUTE_TO_ TEAM The message is to be sent to all clients in the same 2


agent team.

DISTRIBUTE_TO_ ALL The message is to be sent to all CTI Server clients. 3

The CTI Server responds to the CTI Client with the USER_MESSAGE_CONF message:

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
131
Application Level Interfaces
USER_MESSAGE_EVENT

Table 89: USER_MESSAGE_CONF Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. Message Type = 108. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding request UINT 4
message.

USER_MESSAGE_EVENT
The USER_MESSAGE_EVENT message delivers a message that was sent from another CTI Server client:

Table 90: USER_MESSAGE_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 109. MHDR 8

ICMCentral The current Central Controller date and time. TIME 4


ControllerTime

Distribution A Message Distribution value specifying the desired USHORT 2


distribution of this message.

Floating Part

Field Name Value Data Type Max.


Size

ClientID The ClientID of the message sender. STRING 64

Text The text of the message to be sent. STRING 255

Related Topics
USER_MESSAGE_REQ, on page 130

QUERY_AGENT_STATISTICS_REQ
The QUERY_AGENT_STATISTICS_REQ message allows a CTI Client to obtain the current call handling
statistics for the client’s agent. To avoid impacting system performance, clients should not request agent

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
132
Application Level Interfaces
QUERY_AGENT_STATISTICS_REQ

statistics too frequently. Depending upon the needs of the client application, updating agent statistics after
each call is handled my be appropriate.

Table 91: QUERY_AGENT_STATISTICS_REQ Message Format

Fixed Part

Field Name Value Data Byte


Type Size

MessageHeader Standard message header. MessageType = 112. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the agent is located. UINT 4

Floating Part

Field Name Value Data Max.


Type Size

AgentExtension The agent’s ACD teleset extension. For clients with ALL STRING 16
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

AgentID The agent’s ACD login ID. For clients with ALL EVENTS or STRING 12
PERIPHERAL MONITOR service, at least one of
AgentExtension, AgentID, or AgentInstrument must be
provided.

AgentInstrument The agent’s ACD instrument number. For clients with ALL STRING 64
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

The CTI Server responds to the CTI Client with the QUERY_AGENT_STATISTICS_CONF message.
“Session” values represent statistics accumulated since the agent logged in. “Today” values represent statistics
accumulated since midnight. Call counts and times are updated when any after-call work for the call is
completed (calls currently in progress are not included in the statistics):

Table 92: QUERY_AGENT_STATISTICS_CONF Message Format

Fixed Part

Field Name Value Data Byte


Type Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
133
Application Level Interfaces
QUERY_AGENT_STATISTICS_REQ

MessageHeader Standard message header. MessageType = 113. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding request UINT 4
message.

PeripheralID The PeripheralID of the ACD where the agent is located. UINT 4

AvailTime Session Total time, in seconds, the agent was in the Available state for any UINT 4
skill group.

LoggedOnTime Total time, in seconds, the agent has been logged on. UINT 4
Session

NotReadyTime Total time, in seconds, the agent was in the Not Ready state for all UINT 4
Session skill groups.

ICMAvailable Total time, in seconds, the agent was in the Unified CCE Available UINT 4
TimeSession state.

RoutableTime Total time, in seconds, the agent was in the Routable state for all UINT 4
Session skill groups.

AgentOutCalls Total number of completed outbound ACD calls made by agent. UINT 4
Session

AgentOutCalls Total talk time, in seconds, for completed outbound ACD calls UINT 4
TalkTimeSession handled by the agent. The value includes the time spent from the call
being initiated by the agent to the time the agent begins after call
work for the call. The time includes hold time associated with the
call.

AgentOutCalls Total handle time, in seconds, for completed outbound ACD calls UINT 4
Time Session handled by the agent. The value includes the time spent from the call
being initiated by the agent to the time the agent completes after call
work time for the call. The time includes hold time associated with
the call.

AgentOutCalls The total number of completed outbound ACD calls the agent has UINT 4
Held Session placed on hold at least once.

AgentOutCalls Total number of seconds outbound ACD calls were placed on hold. UINT 4
HeldTime Session

HandledCalls The number of inbound ACD calls handled by the agent. UINT 4
Session

HandledCalls Total talk time in seconds for Inbound ACD calls counted as handled UINT 4
TalkTime Session by the agent. Includes hold time associated with the call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
134
Application Level Interfaces
QUERY_AGENT_STATISTICS_REQ

HandledCalls Total after call work time in seconds for Inbound ACD calls counted UINT 4
AfterCall as handled by the agent.
TimeSession

HandledCalls Total handle time, in seconds, for inbound ACD calls counted as UINT 4
Time Session handled by the agent. The time spent from the call being answered
by the agent to the time the agent completed after call work time for
the call. Includes hold time associated with the call.

IncomingCalls The total number of completed inbound ACD calls the agent placed UINT 4
Held Session on hold at least once.

IncomingCalls Total number of seconds completed inbound ACD calls were placed UINT 4
HeldTime Session on hold.

InternalCallsSession Number of internal calls initiated by the agent. UINT 4

InternalCalls Number of seconds spent on internal calls initiated by the agent. UINT 4
TimeSession

InternalCalls Number of internal calls received by the agent. UINT 4


RcvdSession

InternalCalls Number of seconds spent on internal calls received by the agent. UINT 4
RcvdTime Session

InternalCalls The total number of internal calls the agent placed on hold at least UINT 4
HeldSession once.

InternalCalls Total number of seconds completed internal calls were placed on UINT 4
HeldTime Session hold.

AutoOutCalls Total number of AutoOut (predictive) calls completed by the agent. UINT 4
Session

AutoOutCalls Total talk time, in seconds, of AutoOut (predictive) calls completed UINT 4
TalkTime Session by the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent begins after call work for
the call. The time includes hold time associated with the call.

AutoOutCalls Total handle time, in seconds, for AutoOut (predictive) calls UINT 4
Time Session completed by the agent. The value includes the time spent from the
call being initiated by the agent to the time the agent completes after
call work time for the call. The time includes hold time associated
with the call.

AutoOutCalls The total number of completed AutoOut (predictive) calls the agent UINT 4
Held Session has placed on hold at least once.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
135
Application Level Interfaces
QUERY_AGENT_STATISTICS_REQ

AutoOutCalls Total number of seconds AutoOut (predictive) calls were placed on UINT 4
HeldTime Session hold.

PreviewCalls Total number of outbound Preview calls completed by the agent. UINT 4
Session

PreviewCalls Total talk time, in seconds, of outbound Preview calls completed by UINT 4
TalkTime Session the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent begins after call work for
the call. The time includes hold time associated with the call.

PreviewCalls Total handle time, in seconds, outbound Preview calls completed by UINT 4
TimeSession the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent completes after call work
time for the call. The time includes hold time associated with the
call.

PreviewCalls The total number of completed outbound Preview calls the agent has UINT 4
HeldSession placed on hold at least once.

PreviewCalls Total number of seconds outbound Preview calls were placed on UINT 4
HeldTime Session hold.

Reservation Total number of agent reservation calls completed by the agent. UINT 4
CallsSession

Reservation Total talk time, in seconds, of agent reservation calls completed by UINT 4
CallsTalk the agent. The value includes the time spent from the call being
TimeSession initiated by the agent to the time the agent begins after call work for
the call. The time includes hold time associated with the call.

Reservation Total handle time, in seconds, agent reservation calls completed by UINT 4
CallsTime Session the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent completes after call work
time for the call. The time includes hold time associated with the
call.

Reservation The total number of completed agent reservation calls the agent has UINT 4
CallsHeld Session placed on hold at least once.

Reservation Total number of seconds agent reservation calls were placed on hold. UINT 4
CallsHeld
TimeSession

BargeInCalls Total number of supervisor call barge-ins completed. UINT 4


Session

InterceptCalls Total number of supervisor call intercepts completed. UINT 4


Session

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
136
Application Level Interfaces
QUERY_AGENT_STATISTICS_REQ

MonitorCalls Total number of supervisor call monitors completed. UINT 4


Session

WhisperCalls Total number of supervisor whisper calls completed. UINT 4


Session

EmergencyCallsSession Total number of emergency calls. UINT 4

AvailTimeToday Total time, in seconds, the agent was in the Available state for any UINT 4
skill group.

LoggedOnTime Total time, in seconds, the agent has been logged on. UINT 4
Today

NotReadyTime Total time, in seconds, the agent was in the Not Ready state for all UINT 4
Today skill groups.

ICMAvailable Total time, in seconds, the agent was in the Unified CCE Available UINT 4
TimeToday state.

RoutableTime Total time, in seconds, the agent was in the Routable state for all UINT 4
Today skill groups.

AgentOutCalls Total number of completed outbound ACD calls made by agent. UINT 4
Today

AgentOutCalls Total talk time, in seconds, for completed outbound ACD calls UINT 4
TalkTime Today handled by the agent. The value includes the time spent from the call
being initiated by the agent to the time the agent begins after call
work for the call. The time includes hold time associated with the
call.

AgentOutCalls Total handle time, in seconds, for completed outbound ACD calls UINT 4
Time Today handled by the agent. The value includes the time spent from the call
being initiated by the agent to the time the agent completes after call
work time for the call. The time includes hold time associated with
the call.

AgentOutCalls The total number of completed outbound ACD calls the agent has UINT 4
HeldToday placed on hold at least once.

AgentOutCalls Total number of seconds outbound ACD calls were placed on hold. UINT 4
HeldTime Today

HandledCalls The number of inbound ACD calls handled by the agent. UINT 4
Today

HandledCalls Total talk time in seconds for Inbound ACD calls counted as handled UINT 4
TalkTime Today by the agent. Includes hold time associated with the call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
137
Application Level Interfaces
QUERY_AGENT_STATISTICS_REQ

HandledCalls Total after call work time in seconds for Inbound ACD calls counted UINT 4
AfterCall as handled by the agent.
TimeToday

HandledCalls Total handle time, in seconds, for inbound ACD calls counted as UINT 4
TimeToday handled by the agent. The time spent from the call being answered
by the agent to the time the agent completed after call work time for
the call. Includes hold time associated with the call.

IncomingCalls The total number of completed inbound ACD calls the agent placed UINT 4
HeldToday on hold at least once.

IncomingCalls Total number of seconds completed inbound ACD calls were placed UINT 4
HeldTime Today on hold.

InternalCalls Number of internal calls initiated by the agent. UINT 4


Today

InternalCalls Number of seconds spent on internal calls initiated by the agent. UINT 4
TimeToday

InternalCalls Number of internal calls received by the agent. UINT 4


RcvdToday

InternalCalls Number of seconds spent on internal calls received by the agent. UINT 4
RcvdTime Today

InternalCalls The total number of internal calls the agent placed on hold at least UINT 4
HeldToday once.

InternalCalls Total number of seconds completed internal calls were placed on UINT 4
HeldTime Today hold.

AutoOutCalls Total number of AutoOut (predictive) calls completed by the agent. UINT 4
Today

AutoOutCalls Total talk time, in seconds, of AutoOut (predictive) calls completed UINT 4
TalkTime Today by the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent begins after call work for
the call. The time includes hold time associated with the call.

AutoOutCalls Total handle time, in seconds, for AutoOut (predictive) calls UINT 4
TimeToday completed by the agent. The value includes the time spent from the
call being initiated by the agent to the time the agent completes after
call work time for the call. The time includes hold time associated
with the call.

AutoOutCalls The total number of completed AutoOut (predictive) calls the agent UINT 4
HeldToday has placed on hold at least once.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
138
Application Level Interfaces
QUERY_AGENT_STATISTICS_REQ

AutoOutCalls Total number of seconds AutoOut (predictive) calls were placed on UINT 4
HeldTime Today hold.

PreviewCalls Total number of outbound Preview calls completed by the agent. UINT 4
Today

PreviewCalls Total talk time, in seconds, of outbound Preview calls completed by UINT 4
TalkTimeToday the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent begins after call work for
the call. The time includes hold time associated with the call.

PreviewCalls Total handle time, in seconds, outbound Preview calls completed by UINT 4
TimeToday the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent completes after call work
time for the call. The time includes hold time associated with the
call.

PreviewCalls The total number of completed outbound Preview calls the agent has UINT 4
HeldToday placed on hold at least once.

PreviewCalls Total number of seconds outbound Preview calls were placed on UINT 4
HeldTimeToday hold.

Reservation Total number of agent reservation calls completed by the agent. UINT 4
CallsToday

Reservation Total talk time, in seconds, of agent reservation calls completed by UINT 4
CallsTalk the agent. The value includes the time spent from the call being
TimeToday initiated by the agent to the time the agent begins after call work for
the call. The time includes hold time associated with the call.

Reservation Total handle time, in seconds, agent reservation calls completed by UINT 4
CallsTimeToday the agent. The value includes the time spent from the call being
initiated by the agent to the time the agent completes after call work
time for the call. The time includes hold time associated with the
call.

Reservation The total number of completed agent reservation calls the agent has UINT 4
CallsHeldToday placed on hold at least once.

Reservation Total number of seconds agent reservation calls were placed on hold. UINT 4
CallsHeld
TimeToday

BargeInCalls Total number of supervisor call barge-ins completed. UINT 4


Today

InterceptCalls Total number of supervisor call intercepts completed. UINT 4


Today

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
139
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

MonitorCalls Total number of supervisor call monitors completed. UINT 4


Today

WhisperCalls Total number of supervisor whisper calls completed. UINT 4


Today

EmergencyCalls Total number of emergency calls. UINT 4


Today

Floating Part

Field Name Value Data Max.


Type Size

AgentExtension The agent’s ACD teleset extension. STRING 16

AgentID The agent’s ACD login ID. STRING 12

AgentInstrument The agent’s ACD instrument number. STRING 64

QUERY_SKILL_GROUP_STATISTICS_REQ
The QUERY_SKILL_GROUP_STATISTICS_REQ message allows a CTI Client to obtain the current call
handling statistics for one of the client agent’s skill groups. To avoid impacting system performance, clients
should not request skill group statistics too frequently. Depending upon the needs of the client application,
updating skill group statistics after each call is handled my be appropriate.

Table 93: QUERY_SKILL_GROUP_STATISTICS_REQ Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MHDR 8


MessageType = 114.

InvokeID An ID for this request message that UINT 4


will be returned in the corresponding
confirm message.

PeripheralID The PeripheralID of the ACD where UINT 4


the skill group is located.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
140
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

SkillGroupNumber The number of the desired agent UINT 4


SkillGroup, as known to the
peripheral. May contain the special
value NULL_SKILL_GROUP when
SkillGroupID is supplied. Some
ACDs ignore this field and/or use
the ACD default; see the list in the
CALL_DELIVERED_EVENT
section.

SkillGroupID The SkillGroupID of the desired UINT 4


agent SkillGroup. May contain the
special value
NULL_SKILL_GROUP when
SkillGroupNumber is supplied.

The CTI Server responds to the CTI Client with the QUERY_SKILL_GROUP_STATISTICS_CONF message.
“ToHalf” values represent statistics accumulated in the current half hour period. “Today” values represent
statistics accumulated since midnight. Call counts and times are updated when any after-call work for the call
is completed (calls currently in progress are not included in the statistics):

Table 94: QUERY_SKILL_GROUP_STATISTICS_CONF Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MHDR 8


MessageType = 115.

InvokeID Set to the same value as the UINT 4


InvokeID from the corresponding
request message.

PeripheralID The PeripheralID of the ACD UINT 4


where the skill group is located.

SkillGroupNumber The number of the desired agent UINT 4


SkillGroup, as known to the
peripheral. May contain the special
value NULL_SKILL_GROUP
when SkillGroupID is supplied.
Some ACDs ignore this field and/or
use the ACD default; see the list in
the CALL_DELIVERED_EVENT
section.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
141
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

SkillGroupID The SkillGroupID of the desired UINT 4


agent SkillGroup. May contain the
special value
NULL_SKILL_GROUP when not
available.

Real-Time Statistics

AgentsLoggedOn Number of agents that are currently UINT 4


logged on to the skill group.

AgentsAvail Number of agents for the skill UINT 4


group in Available state.

AgentsNotReady Number of agents in the Not Ready UINT 4


state for the skill group.

AgentsReady Number of agents in the Ready UINT 4


state for the skill group.

AgentsTalkingIn Number of agents in the skill group UINT 4


currently talking on inbound calls.

AgentsTalkingOut Number of agents in the skill group UINT 4


currently talking on outbound calls.

AgentsTalkingOther Number of agents in the skill group UINT 4


currently talking on internal (not
inbound or outbound) calls.

AgentsWorkNot Ready Number of agents in the skill group UINT 4


in the Work Not Ready state.

AgentsWorkReady Number of agents in the skill group UINT 4


in the Work Ready state.

AgentsBusyOther Number of agents currently busy UINT 4


with calls assigned to other skill
groups.

AgentsReserved Number of agents for the skill UINT 4


group currently in the Reserved
state.

AgentsHold Number of calls to the skill group UINT 4


currently on hold.

AgentsICM Available Number of agents in the skill group UINT 4


currently in the Unified CCE
Available state.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
142
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

AgentsApplication Available Number of agents in the skillgroup UINT 4


currently in the Application
Available state.

AgentsTalkingAutoOut Number of calls to the skill group UINT 4


currently talking on AutoOut
(predictive) calls.

AgentsTalking Preview Number of calls to the skill group UINT 4


currently talking on outbound
Preview calls.

AgentsTalking Reservation Number of calls to the skill group UINT 4


currently talking on agent
reservation calls.

RouterCallsQNow The number of calls currently UINT 4


queued by the Unified CCE call
router for this skill group. This field
is set to 0xFFFFFFFF when this
value is unknown or unavailable.

LongestRouterCallQNow The queue time, in seconds, of the UINT 4


currently Unified CCE call router
queued call that has been queued
to the skill group the longest. This
field is set to 0xFFFFFFFF when
this value is unknown or
unavailable.

CallsQNow The number of calls currently UINT 4


queued to the skill group. This field
is set to 0xFFFFFFFF when this
value is unknown or unavailable.

CallsQTimeNow The total queue time, in seconds, UINT 4


of calls currently queued to the skill
group. This field is set to
0xFFFFFFFF when this value is
unknown or unavailable.

LongestCallQNow The queue time, in seconds, of the UINT 4


currently queued call that has been
queued to the skill group the
longest. This field is set to
0xFFFFFFFF when this value is
unknown or unavailable.

AvailTimeTo5 Total seconds agents in the skill UINT 4


group were in the Available state.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
143
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

LoggedOnTimeTo5 Total time, in seconds, agents in the UINT 4


skill group were logged on.

NotReadyTimeTo5 Total seconds agents in the skill UINT 4


group were in the Not Ready state.

AgentOutCallsTo5 Total number of completed UINT 4


outbound ACD calls made by
agents in the skill group.

AgentOutCallsTalk TimeTo5 Total talk time, in seconds, for UINT 4


completed outbound ACD calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
by the agent to the time the agent
begins after call work for the call.
The time includes hold time
associated with the call.

AgentOutCallsTimeTo5 Total handle time, in seconds, for UINT 4


completed outbound ACD calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
by the agent to the time the agent
completes after call work time for
the call. The time includes hold
time associated with the call.

AgentOutCallsHeldTo5 The total number of completed UINT 4


outbound ACD calls agents in the
skill group have placed on hold at
least once.

AgentOutCallsHeldTimeTo5 Total number of seconds outbound UINT 4


ACD calls were placed on hold by
agents in the skill group.

HandledCallsTo5 The number of inbound ACD calls UINT 4


handled by agents in the skill
group.

HandledCallsTalk TimeTo5 Total talk time in seconds for UINT 4


Inbound ACD calls counted as
handled by agents in the skill
group. Includes hold time
associated with the call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
144
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

HandledCallsAfter CallTimeTo5 Total after call work time in UINT 4


seconds for Inbound ACD calls
counted as handled by agents in the
skill group.

HandledCallsTime To5 Total handle time, in seconds, for UINT 4


inbound ACD calls counted as
handled by agents in the skill
group. The time spent from the call
being answered by the agent to the
time the agent completed after call
work time for the call. Includes
hold time associated with the call.

IncomingCallsHeldTo5 The total number of completed UINT 4


inbound ACD calls agents in the
skill group placed on hold at least
once.

IncomingCallsHeldTimeTo5 Total number of seconds completed UINT 4


inbound ACD calls were placed on
hold by agents in the skill group.

InternalCallsRcvdTo5 Number of internal calls received UINT 4


by agents in the skill group.

InternalCallsRcvd TimeTo5 Number of seconds spent on UINT 4


internal calls received by agents in
the skill group.

InternalCallsHeldTo5 The total number of internal calls UINT 4


agents in the skill group placed on
hold at least once.

InternalCallsHeld TimeTo5 Total number of seconds completed UINT 4


internal calls were placed on hold
by agents in the skill group.

AutoOutCallsTo5 Total number of AutoOut UINT 4


(predictive) calls completed by
agents in the skill group.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
145
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

AutoOutCallsTalk TimeTo5 Total talk time, in seconds, for UINT 4


completed AutoOut (predictive)
calls handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

AutoOutCallsTime To5 Total handle time, in seconds, for UINT 4


completed AutoOut (predictive)
calls handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

AutoOutCallsHeld To5 The total number of completed UINT 4


AutoOut (predictive) calls that
agents in the skill group have
placed on hold at least once.

AutoOutCallsHeld TimeTo5 Total number of seconds AutoOut UINT 4


(predictive) calls were placed on
hold by agents in the skill group.

PreviewCallsTo5 Total number of outbound Preview UINT 4


calls completed by agents in the
skill group.

PreviewCallsTalk TimeTo5 Total talk time, in seconds, for UINT 4


completed outbound Preview calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
146
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

PreviewCallsTime To5 Total handle time, in seconds, for UINT 4


completed outbound Preview calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

PreviewCallsHeld To5 The total number of completed UINT 4


outbound Preview calls that agents
in the skill group have placed on
hold at least once.

PreviewCallsHeld TimeTo5 Total number of seconds outbound UINT 4


Preview calls were placed on hold
by agents in the skill group.

ReservationCallsTo5 Total number of agent reservation UINT 4


calls completed by agents in the
skill group.

ReservationCalls TalkTimeTo5 Total talk time, in seconds, for UINT 4


completed agent reservation calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

ReservationCalls TimeTo5 Total handle time, in seconds, for UINT 4


completed agent reservation calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

ReservationCalls HeldTo5 The total number of agent UINT 4


reservation calls that agents in the
skill group have placed on hold at
least once.

ReservationCalls HeldTimeTo5 Total number of seconds agent UINT 4


reservation calls were placed on
hold by agents in the skill group.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
147
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

BargeInCallsTo5 Total number of supervisor call UINT 4


barge-ins completed in the skill
group.

InterceptCallsTo5 Total number of supervisor call UINT 4


intercepts completed in the skill
group.

MonitorCallsTo5 Total number of supervisor call UINT 4


monitors completed in the skill
group.

WhisperCallsTo5 Total number of supervisor call UINT 4


whispers completed by agents in
the skill group.

EmergencyCallsTo5 Total number of emergency calls UINT 4


completed by agents in the skill
group.

CallsQ5 The number of calls queued to the UINT 4


skill group during the current
five-minute. This field is set to
0xFFFFFFFF when this value is
unknown or unavailable.

CallsQTime5 The total queue time, in seconds, UINT 4


of calls queued to the skill group
during the current five-minute. This
field is set to 0xFFFFFFFF when
this value is unknown or
unavailable.

LongestCallQ5 The longest queue time, in seconds, UINT 4


of all calls queued to the skill group
during the current five-minute. This
field is set to 0xFFFFFFFF when
this value is unknown or
unavailable.

AvailTimeToHalf Total seconds agents in the skill UINT 4


group were in the Available state.

LoggedOnTime ToHalf Total time, in seconds, agents in the UINT 4


skill group were logged on.

NotReadyTime ToHalf Total seconds agents in the skill UINT 4


group were in the Not Ready state.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
148
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

AgentOutCallsTo Half Total number of completed UINT 4


outbound ACD calls made by
agents in the skill group.

AgentOutCallsTalk TimeToHalf Total talk time, in seconds, for UINT 4


completed outbound ACD calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
by the agent to the time the agent
begins after call work for the call.
The time includes hold time
associated with the call.

AgentOutCallsTimeToHalf Total handle time, in seconds, for UINT 4


completed outbound ACD calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
by the agent to the time the agent
completes after call work time for
the call. The time includes hold
time associated with the call.

AgentOutCallsHeldToHalf The total number of completed UINT 4


outbound ACD calls agents in the
skill group have placed on hold at
least once.

AgentOutCallsHeldTimeToHalf Total number of seconds outbound UINT 4


ACD calls were placed on hold by
agents in the skill group.

HandledCallsToHalf The number of inbound ACD calls UINT 4


handled by agents in the skill
group.

HandledCallsTalk TimeToHalf Total talk time in seconds for UINT 4


Inbound ACD calls counted as
handled by agents in the skill
group. Includes hold time
associated with the call.

HandledCallsAfter CallTimeToHalf Total after call work time in UINT 4


seconds for Inbound ACD calls
counted as handled by agents in the
skill group.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
149
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

HandledCallsTime ToHalf Total handle time, in seconds, for UINT 4


inbound ACD calls counted as
handled by agents in the skill
group. The time spent from the call
being answered by the agent to the
time the agent completed after call
work time for the call. Includes
hold time associated with the call.

IncomingCallsHeldToHalf The total number of completed UINT 4


inbound ACD calls agents in the
skill group placed on hold at least
once.

IncomingCallsHeldTimeToHalf Total number of seconds completed UINT 4


inbound ACD calls were placed on
hold by agents in the skill group.

InternalCallsRcvdToHalf Number of internal calls received UINT 4


by agents in the skill group.

InternalCallsRcvd TimeToHalf Number of seconds spent on UINT 4


internal calls received by agents in
the skill group.

InternalCallsHeldToHalf The total number of internal calls UINT 4


agents in the skill group placed on
hold at least once.

InternalCallsHeld TimeToHalf Total number of seconds completed UINT 4


internal calls were placed on hold
by agents in the skill group.

AutoOutCallsToHalf Total number of AutoOut UINT 4


(predictive) calls completed by
agents in the skill group.

AutoOutCallsTalk TimeToHalf Total talk time, in seconds, for UINT 4


completed AutoOut (predictive)
calls handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
150
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

AutoOutCallsTime ToHalf Total handle time, in seconds, for UINT 4


completed AutoOut (predictive)
calls handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

AutoOutCallsHeld ToHalf The total number of completed UINT 4


AutoOut (predictive) calls that
agents in the skill group have
placed on hold at least once.

AutoOutCallsHeld TimeToHalf Total number of seconds AutoOut UINT 4


(predictive) calls were placed on
hold by agents in the skill group.

PreviewCallsToHalf Total number of outbound Preview UINT 4


calls completed by agents in the
skill group.

PreviewCallsTalk TimeToHalf Total talk time, in seconds, for UINT 4


completed outbound Preview calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

PreviewCallsTime ToHalf Total handle time, in seconds, for UINT 4


completed outbound Preview calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

PreviewCallsHeldToHalf The total number of completed UINT 4


outbound Preview calls that agents
in the skill group have placed on
hold at least once.

PreviewCallsHeld TimeToHalf Total number of seconds outbound UINT 4


Preview calls were placed on hold
by agents in the skill group.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
151
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

ReservationCallsToHalf Total number of agent reservation UINT 4


calls completed by agents in the
skill group.

ReservationCalls TalkTimeToHalf Total talk time, in seconds, for UINT 4


completed agent reservation calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

ReservationCalls TimeToHalf Total handle time, in seconds, for UINT 4


completed agent reservation calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

ReservationCalls HeldToHalf The total number of agent UINT 4


reservation calls that agents in the
skill group have placed on hold at
least once.

ReservationCalls HeldTimeToHalf Total number of seconds agent UINT 4


reservation calls were placed on
hold by agents in the skill group.

BargeInCallsToHalf Total number of supervisor call UINT 4


barge-ins completed in the skill
group.

InterceptCallsTo Half Total number of supervisor call UINT 4


intercepts completed in the skill
group.

MonitorCallsToHalf Total number of supervisor call UINT 4


monitors completed in the skill
group.

WhisperCallsToHalf Total number of supervisor call UINT 4


whispers completed by agents in
the skill group.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
152
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

EmergencyCalls ToHalf Total number of emergency calls UINT 4


completed by agents in the skill
group.

CallsQHalf The number of calls queued to the UINT 4


skill group during the current half
hour. This field is set to
0xFFFFFFFF when this value is
unknown or unavailable.

CallsQTimeHalf The total queue time, in seconds, UINT 4


of calls queued to the skill group
during the current half hour. This
field is set to 0xFFFFFFFF when
this value is unknown or
unavailable.

LongestCallQHalf The longest queue time, in seconds, UINT 4


of all calls queued to the skill group
during the current half hour. This
field is set to 0xFFFFFFFF when
this value is unknown or
unavailable.

AvailTimeToday Total seconds agents in the skill UINT 4


group were in the Available state.

LoggedOnTime Today Total time, in seconds, agents in the UINT 4


skill group were logged on.

NotReadyTime Today Total seconds agents in the skill UINT 4


group were in the Not Ready state.

AgentOutCalls Today Total number of completed UINT 4


outbound ACD calls made by
agents in the skill group.

AgentOutCallsTalk TimeToday Total talk time, in seconds, for UINT 4


completed outbound ACD calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
by the agent to the time the agent
begins after call work for the call.
The time includes hold time
associated with the call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
153
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

AgentOutCallsTimeToday Total handle time, in seconds, for UINT 4


completed outbound ACD calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
by the agent to the time the agent
completes after call work time for
the call. The time includes hold
time associated with the call.

AgentOutCallsHeldToday The total number of completed UINT 4


outbound ACD calls agents in the
skill group have placed on hold at
least once.

AgentOutCallsHeldTimeToday Total number of seconds outbound UINT 4


ACD calls were placed on hold by
agents in the skill group.

HandledCallsToday The number of inbound ACD calls UINT 4


handled by agents in the skill
group.

HandledCallsTalk TimeToday Total talk time in seconds for UINT 4


Inbound ACD calls counted as
handled by agents in the skill
group. Includes hold time
associated with the call.

HandledCallsAfter CallTimeToday Total after call work time in UINT 4


seconds for Inbound ACD calls
counted as handled by agents in the
skill group.

HandledCallsTime Today Total handle time, in seconds, for UINT 4


inbound ACD calls counted as
handled by agents in the skill
group. The time spent from the call
being answered by the agent to the
time the agent completed after call
work time for the call. Includes
hold time associated with the call.

IncomingCallsHeldToday The total number of completed UINT 4


inbound ACD calls agents in the
skill group placed on hold at least
once.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
154
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

IncomingCallsHeldTimeToday Total number of seconds completed UINT 4


inbound ACD calls were placed on
hold by agents in the skill group.

InternalCallsRcvd Today Number of internal calls received UINT 4


by agents in the skill group.

InternalCallsRcvd TimeToday Number of seconds spent on UINT 4


internal calls received by agents in
the skill group.

InternalCallsHeld Today The total number of internal calls UINT 4


agents in the skill group placed on
hold at least once.

InternalCallsHeld TimeToday Total number of seconds completed UINT 4


internal calls were placed on hold
by agents in the skill group.

AutoOutCallsToday Total number of AutoOut UINT 4


(predictive) calls completed by
agents in the skill group.

AutoOutCallsTalk TimeToday Total talk time, in seconds, for UINT 4


completed AutoOut (predictive)
calls handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

AutoOutCallsTime Today Total handle time, in seconds, for UINT 4


completed AutoOut (predictive)
calls handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

AutoOutCallsHeld Today The total number of completed UINT 4


AutoOut (predictive) calls that
agents in the skill group have
placed on hold at least once.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
155
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

AutoOutCallsHeld TimeToday Total number of seconds AutoOut UINT 4


(predictive) calls were placed on
hold by agents in the skill group.

PreviewCallsToday Total number of outbound Preview UINT 4


calls completed by agents in the
skill group.

PreviewCallsTalk TimeToday Total talk time, in seconds, for UINT 4


completed outbound Preview calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

PreviewCallsTime Today Total handle time, in seconds, for UINT 4


completed outbound Preview calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

PreviewCallsHeld Today The total number of completed UINT 4


outbound Preview calls that agents
in the skill group have placed on
hold at least once.

PreviewCallsHeld TimeToday Total number of seconds outbound UINT 4


Preview calls were placed on hold
by agents in the skill group.

ReservationCalls Today Total number of agent reservation UINT 4


calls completed by agents in the
skill group.

ReservationCalls TalkTimeToday Total talk time, in seconds, for UINT 4


completed agent reservation calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent begins after
call work for the call. The time
includes hold time associated with
the call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
156
Application Level Interfaces
QUERY_SKILL_GROUP_STATISTICS_REQ

ReservationCalls TimeToday Total handle time, in seconds, for UINT 4


completed agent reservation calls
handled by agents in the skill
group. The value includes the time
spent from the call being initiated
to the time the agent completes
after call work time for the call. The
time includes hold time associated
with the call.

ReservationCalls HeldToday The total number of agent UINT 4


reservation calls that agents in the
skill group have placed on hold at
least once.

ReservationCalls HeldTimeToday Total number of seconds agent UINT 4


reservation calls were placed on
hold by agents in the skill group.

BargeInCallsToday Total number of supervisor call UINT 4


barge-ins completed in the skill
group.

InterceptCallsToday Total number of supervisor call UINT 4


intercepts completed in the skill
group.

MonitorCallsToday Total number of supervisor call UINT 4


monitors completed in the skill
group.

WhisperCallsToday Total number of supervisor call UINT 4


whispers completed by agents in
the skill group.

EmergencyCalls Today Total number of emergency calls UINT 4


completed by agents in the skill
group.

CallsQToday The number of calls queued to the UINT 4


skill. This field is set to
0xFFFFFFFF when this value is
unknown or unavailable.

CallsQTimeToday The total queue time, in seconds, UINT 4


of calls queued to the skill group.
This field is set to 0xFFFFFFFF
when this value is unknown or
unavailable.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
157
Application Level Interfaces
REGISTER_VARIABLES_REQ

LongestCallQToday The longest queue time, in seconds, UINT 4


of all calls queued to the skill
group. This field is set to
0xFFFFFFFF when this value is
unknown or unavailable.

Related Topics
CALL_DELIVERED_EVENT, on page 58
Special Values, on page 251

REGISTER_VARIABLES_REQ
The REGISTER_VARIABLES_REQ message allows a CTI Client to register the call context variables that
it will use. By default, a CTI Client that does not explicitly register variables will receive all call and ECC
variables. If a CTI Client does not want to receive all possible variables, it must explicitly register for each
variable that it wants.

Table 95: REGISTER_VARIABLES_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 110. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding request UINT 4
message.

CallVariable A bitwise combination of Call Variable Masks corresponding to USHORT 2


Mask the call variables that the client wishes to receive.

NumNamed The number of NamedVariable floating fields present in the USHORT 2


Variables floating part of the message.

NumNamed The number of NamedArray floating fields present in the floating USHORT 2
Arrays part of the message.

Floating Part

Field Name Value Data Type Max.


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
158
Application Level Interfaces
REGISTER_VARIABLES_REQ

NamedVariable A variable name defined in the Unified CCE that the CTI Client NAMED 251
(optional) wishes to use. There may be an arbitrary number of Named VAR
Variable and NamedArray fields in the message, up to a combined
total limit of 2000 bytes. The variable value provided is ignored
in this request.

NamedArray An array variable name defined in the Unified CCE that the CTI NAMED 252
(optional) Client wishes to use. There may be an arbitrary number of Named ARRAY
Variable and NamedArray fields in the message, up to a combined
total limit of 2000 bytes. The array index and value provided are
ignored in this request.

If any specified Named Variable or Named Array is subsequently removed from the Unified CCE while the
CTI Client session is still open, the CTI Server will send a FAILURE_EVENT message to the CTI Client.

Table 96: Call Variable Masks

Mask Name Description Value


CALL_VAR_1_MASK CallVariable1 0x0001

CALL_VAR_2_MASK CallVariable2 0x0002

CALL_VAR_3_MASK CallVariable3 0x0004

CALL_VAR_4_MASK CallVariable4 0x0008

CALL_VAR_5_MASK CallVariable5 0x0010

CALL_VAR_6_MASK CallVariable6 0x0020

CALL_VAR_7_MASK CallVariable7 0x0040

CALL_VAR_8_MASK CallVariable8 0x0080

CALL_VAR_9_MASK CallVariable9 0x0100

CALL_VAR_10_MASK CallVariable10 0x0200

If any specified Named Variable or Named Array is not currently configured in the Unified CCE, the CTI
Server responds to the CTI Client with a FAILURE_CONF message. Otherwise, the CTI Server responds
with a REGISTER_VARIABLES_CONF message:

Table 97: REGISTER_VARIABLES_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 118. MHDR 8

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
159
Application Level Interfaces
SET_APP_DATA_REQ

InvokeID An ID for this request message that will be returned UINT 4


in the corresponding confirm message.

Related Topics
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

SET_APP_DATA_REQ
This message is sent by a CTI Client to set one or more application variables. Variables not provided in the
message are not affected.

Table 98: SET_APP_DATA_REQ Message Format

Fixed Part

Field Name Value Data Byte


Type Size

MessageHeader Standard message header. MessageType = 129. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

Floating Part

Field Name Value Data Max.


Type Size

ApplicationPathID The ID of the ApplicationPath which the variables belong. INT 4

CallVariable1 Call-related variable data. STRING 41


(optional)

… … … …

CallVariable10 Call-related variable data. STRING 41


(optional)

FltCallTypeID If present, shows the call type of the call. UINT 4


(optional)

PreCallInvokeID If present, specifies the invoke of the PreCall related to this UNIT 4
(optional) event.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
160
Application Level Interfaces
START_RECORDING_REQ

When the requested call variables have been updated, and the new values are guaranteed to remain set in the
event that the CTI session is abnormally terminated, the CTI Server responds to the CTI Client that requested
the update with the SET_APP_DATA_CONF message:

Table 99: SET_APP_DATA_CONF Message Format

Field Name Value Data Byte


Type Size

MessageHeader Standard message header. MessageType = 130. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

START_RECORDING_REQ
A CTI client may send a START_RECORDING_REQ message, requesting CTI server to start recording a
call. Upon receiving the START_RECORDING_REQ, CTI server will try to find an available recording
server to satisfy the recording request. The recording server will return START_RECORDING_CONF to
CTI Server. Upon receipt of the START_RECORDING_CONF from the recording server, it will send
START_RECORDING_CONF to the requesting CTI client.

Table 100: START_RECORDING_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 147. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is located. UINT 4

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

ClientPort The TCP/IP port number of the VoIP media stream. UINT 4

BitRate The media bit rate, used for g.723 payload only. UINT 4

PacketSize In milliseconds. UINT 4

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType ConnectionDeviceID floating field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
161
Application Level Interfaces
START_RECORDING_REQ

Direction The direction of the event. One of the following values: USHORT 2
0: Input;
1: Output;
2: Bi-directional.

RTPType The type of the event. USHORT 2


One of the following values:
0: Audio;
1: Video;
2: Data.

EchoCancellation on/off USHORT 2

PayloadType The audio codec type. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The identifier of the connection between the call and the device. STRING 64
ID

ClientID (server The ClientID of the CTI client requesting call recording, STRING 64
only) provided by CTIServer when this message is sent to a server
application.

ClientAddress The IP address of the CTI client requesting call recording, STRING 64
(server only) provided by CTIServer when this message is sent to a server
application.

AgentExtension The agent’s ACD teleset extension. For requesting clients with STRING 16
ALL EVENTS or PERIPHERAL MONITOR service, at least
one of AgentExtension, AgentID, or AgentInstrument must
be provided.

AgentID The agent’s ACD login ID. For requesting clients with ALL STRING 12
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

AgentInstrument The agent’s ACD instrument number. For requesting clients STRING 64
with ALL EVENTS or PERIPHERAL MONITOR service, at
least one of AgentExtension, AgentID, or AgentInstrument
must be provided.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
162
Application Level Interfaces
START_RECORDING_REQ

The CTIServer forwards the START_RECORDING_REQ message to one or more servers applications that
have registered the “Cisco:CallRecording” service. The recording server will return the
START_RECORDING_CONF message when call recording has been activated. Upon receipt of the
START_RECORDING_CONF, the CTI Server forwards the response to the requesting CTI Client:

Table 101: START_RECORDING _CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 148. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

SessionID A value that uniquely identifies the server application session UINT 4
providing the call recording service that should be supplied by
the client in the STOP_RECORDING_REQ message that
terminates this recording. Server applications should set this
field to 0xffffffff if the subsequent STOP_ RECORDING_REQ
should be sent only to that server, or set to zero if the
STOP_RECORDING_REQ may be sent to any registered
server.

ServerData An ID or other server value associated with this call recording UINT 4
that should be supplied by the client in the
STOP_RECORDING_REQ message that terminates this
recording.

Floating Part

Field Name Value Data Type Max.


Size

ClientID (client The ClientID of the server application providing the call STRING 64
only) recording service, provided by CTIServer when this message
is sent to a client application.

ClientAddress The IP address of the server application providing the call STRING 64
(client only) recording service, provided by CTIServer when this message
is sent to a client application.

Related Topics
ConnectionDeviceIDType Values, on page 277

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
163
Application Level Interfaces
STOP_RECORDING_REQ

STOP_RECORDING_REQ
This table defines the format of the STOP_RECORDING_REQ message:

Table 102: STOP_RECORDING_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 149. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is located. UINT 4

ConnectionCallID The Call ID value assigned to this call by the peripheral or UINT 4
Unified CCE.

ClientPort The TCP/IP port number of the VoIP media stream. UINT 4

SessionID A value that uniquely identifies the server application session UINT 4
providing the call recording service that was returned to the
client in the START_RECORDING_CONF message that
initiated this recording. A zero value indicates that the request
may be directed to any registered server.

ServerData The ID or other server value associated with this call recording UINT 4
that was returned to the client in the
START_RECORDING_CONF message that initiated this
recording.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType ConnectionDeviceID floating field.

Direction The direction of the event. One of the following values: USHORT 2
0: Input;
1: Output;
2: Bi-directional.

Floating Part

Field Name Value Data Type Max.


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
164
Application Level Interfaces
STOP_RECORDING_REQ

ConnectionDevice The identifier of the connection between the call and the device. STRING 64
ID

ClientID (server The ClientID of the CTI client making this request, provided STRING 64
only) by CTIServer when this message is sent to a server application.

ClientAddress The IP address of the CTI making this request, provided by STRING 64
(server only) CTIServer when this message is sent to a server application.

AgentExtension The agent’s ACD teleset extension. For requesting clients with STRING 16
ALL EVENTS or PERIPHERAL MONITOR service, at least
one of AgentExtension, AgentID, or AgentInstrument must
be provided.

AgentID The agent’s ACD login ID. For requesting clients with ALL STRING 12
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

AgentInstrument The agent’s ACD instrument number. For requesting clients STRING 64
with ALL EVENTS or PERIPHERAL MONITOR service, at
least one of AgentExtension, AgentID, or AgentInstrument
must be provided.

The CTIServer forwards the STOP_RECORDING_REQ message to the server application with session
SessionID if non-zero, or if SessionID is zero to one or more server applications that have registered the
“Cisco:CallRecording” service. The recording server will return the STOP_RECORDING_CONF message
when call recording has been terminated. Upon receipt of the STOP_RECORDING_CONF, the CTI Server
forwards the response to the requesting CTI Client:

Table 103: STOP_RECORDING_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType= 150. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

Floating Part

Field Name Value Data Type Max.


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
165
Application Level Interfaces
AGENT_DESK_SETTINGS_REQ

ClientID (client only) The ClientID of the server application terminating the call STRING 64
recording service, provided by CTIServer when this message
is sent to a client application.

ClientAddress (client The IP address of the server application terminating the call STRING 64
only) recording service, provided by CTIServer when this message
is sent to a client application.

Related Topics
ConnectionDeviceIDType Values, on page 277

AGENT_DESK_SETTINGS_REQ
This table defines the format of the AGENT_DESK_SETTINGS_REQ message:

Table 104: AGENT_DESK_SETTINGS_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 131. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

PeripheralID The PeripheralID of the ACD where the device is UINT 4


located.

Floating Part

Field Name Value Data Type Max.


Size

AgentID (optional) The agent’s ACD login ID. STRING 12

Table 105: AGENT_DESK_SETTINGS_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 132. MHDR 8

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
166
Application Level Interfaces
AGENT_DESK_SETTINGS_REQ

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

PeripheralID The PeripheralID of the ACD where the device UINT 4


is located.

DeskSettingsMask A bitwise combination of the Boolean desk setting UINT 4


Masks listed in following table.

WrapupData Indicates whether the agent is allowed or required UINT 4


IncomingMode to enter wrap-up data after an inbound call:
0 = Required, 1 = Optional, 2 = Not allowed, 3 =
Required With WrapupData.

WrapupData Indicates whether the agent is allowed or required UINT 4


OutgoingMode to enter wrap-up data after an outbound call:
0 = Required, 1 = Optional, 2 = Not allowed.

LogoutNonActivityTime Number of seconds on non-activity at the desktop UINT 4


after which the Unified CCE automatically logs
out the agent.

QualityRecording Rate Indicates how frequently calls to the agent are UINT 4
recorded.

RingNoAnswer Time Number of seconds a call may ring at the agent’s UINT 4
station before being redirected.

SilentMonitor Set when a warning message box will prompt on UINT 4


WarningMessage agent desktop when silent monitor starts.

SilentMonitor Set for an audio click at beginning of the silent UINT 4


AudibleIndication monitor.

SupervisorAssist Set for Unified CCE PIM will create a blind UINT 4
CallMethod conference call for supervisor assist request;
otherwise will create consultative call.

EmergencyCall Method Set for Unified CCE PIM will create a blind UINT 4
conference call for emergency call request;
otherwise create a consultative call.

AutoRecordOn Emergency Set for automatically record when emergency call UINT 4
request.

RecordingMode Set for the recording request go through Unified UINT 4


CM/PIM.

WorkModeTimer Auto Wrap-up time out. UINT 4

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
167
Application Level Interfaces
AGENT_DESK_SETTINGS_REQ

RingNoAnswerDN The dialed number identifier for new re-route UINT 4


destination in the case of ring no answer.

Floating Part

Field Name Value Data Type Max.


Size

DefaultDevicePort Address Optional value to override the default port address STRING 32
for the agent telephony device.

Table 106: Boolean Desk Settings Masks

Mask Name Description Value

DESK_AVAIL_AFTER_ INCOMING_MASK Set for automatically consider 0x00000001


the agent available after
handling an incoming call.

DESK_AVAIL_AFTER_ OUTGOING_MASK Set for automatically consider 0x00000002


the agent available after
handling an outbound call.

DESK_AUTO_ANSWER_ ENABLED_MASK Set when calls to the agent are 0x00000004


automatically answered.

DESK_IDLE_REASON_ REQUIRED_MASK Set when the agent must enter 0x00000008


a reason before entering the
Idle state.

DESK_LOGOUT_REASON_ REQUIRED_MASK Set when the agent must enter 0x00000010


a reason before logging out.

DESK_SUPERVISOR_CALLS_ALLOWED_MASK Set when the agent can initiate 0x00000020


supervisor assisted calls.

DESK_AGENT_TO_AGENT_ CALLS_ALLOWED Set when calls to other agents 0x00000040


are allowed.

DESK_OUTBOUND_ACCESS_INTERNATIONAL_MASK Set when the agent can initiate 0x00000080


international calls.

DESK_OUTBOUND_ACCESS_PUBLIC_NET_ MASK Set when the agent can initiate 0x00000100


calls through the public
network.

DESK_OUTBOUND_ACCESS_PRIVATE_NET_ MASK Set when the agent can initiate 0x00000200


calls through the private
network.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
168
Application Level Interfaces
Connection Monitor Service

DESK_OUTBOUND_ACCESS_OPERATOR_ Set when the agent can initiate 0x00000400


ASSISTED_MASK operator assisted calls.

DESK_OUTBOUND_ACCESS_PBX_MASK Set when the agent can initiate 0x00000800


outbound PBX calls.

DESK_NON_ACD_CALLS_ ALLOWED_MASK Set when the agent can place 0x00001000


or handle non-ACD calls.

DESK_AGENT_CAN_SELECT_GROUP_MASK Set when the agent can select 0x00002000


which groups they are logged
in to.

Connection Monitor Service


The Connection Monitor service generates Unified CCE Alarm Events whenever a CTI client session that
has been granted this service is established or is terminated. The alarm messages contain the ClientID, Client
Signature, and IP address of the CTI client and indicate whether the session was established, terminated
normally (i.e. a CTI client CLOSE_REQ), or terminated abnormally. You can use these alarms to notify
administrative personnel when, for example, an unattended CTI Bridge Server client may need attention. This
service has no CTI client messages.

Client Control Service


The Client Control service lets CTI client applications request changes to agent states, establish, answer,
control, and terminate calls on behalf of a specified agent position, and manipulate telephone features associated
with a desktop telephone device. The Client Control service permits a CTI client with Client Events service
to control the associated agent device and rejects attempts to control any other devices. CTI clients with All
Events service may attempt to control any agent device (subject to any limitations imposed by the peripheral).
Client Control service messages that initiate new calls contain a boolean PostRoute field. When this field is
set to TRUE, the value in the DialedNumber field of the message and the accumulated call context data is
presented to Unified CCE r as a Post-Route request from the peripheral’s routing client. The label returned in
the Unified CCE’s route response then initiates the call instead of the given dialed number. This enables the
CTI client to harness the power of the Unified CCE to find the most appropriate destination for the call.
The Client Control service consists of paired request/response messages. The CTI client sends a request
message for the desired control action, and the CTI Server response indicates the outcome of the request.
Depending on the specifics of the request, 10 to 15 seconds may elapse before the CTI Server returns the
response message.
Receipt of the request is indicated by the corresponding control action confirmation message. If a request is
unsuccessful, the CTI server instead sends a CONTROL_FAILURE_CONF message to indicate that the
requested control service function identified by the given InvokeID was unsuccessful.

Table 107: CONTROL_FAILURE_CONF Message Format

Field Name Value Data Type Byte Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
169
Application Level Interfaces
Client Control Service

MessageHeader Standard message header. MessageType = 35. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

FailureCode A Status Code value specifying the reason that the USHORT 2
request failed.

PeripheralError Code Peripheral-specific error data, if available. Zero UINT 4


otherwise.

The CTI client may receive unsolicited call or agent event messages that are caused by the request before or
after the request confirmation message.
This figure illustrates the general Client Control message flow (using the messages to control agent state,
described later in this section):

This table summarizes the Client Control service messages:

Table 108: Client Control Service Messages

Message Action Requested Server Response Message

QUERY_AGENT_STATE_ Retrieve the current state of an agent at QUERY_AGENT_STATE_


REQ a specified device. CONF

SET_AGENT_STATE_ REQ Change an ACD agent’s state. SET_AGENT_STATE_ CONF

ALTERNATE_CALL_REQ Place an active call on hold and then ALTERNATE_CALL_CONF


retrieve a previously held call or answer
an alerting call at the same device.

ANSWER_CALL_REQ Connect an alerting call at the device that ANSWER_CALL_CONF


is alerting.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
170
Application Level Interfaces
Client Control Service

CLEAR_CALL_REQ Release all devices from the specified CLEAR_CALL_CONF


call.

CLEAR_CONNECTION_ Release a specific device connection CLEAR_CONNECTION_ CONF


REQ from the designated call.

CONFERENCE_CALL_ REQ Conference an existing held call with CONFERENCE_CALL_ CONF


another active call.

CONSULTATION_CALL_REQ Place an active call on hold and then CONSULTATION_CALL_


make a new call. CONF

DEFLECT_CALL_REQ Move an alerting call from a known DEFLECT_CALL_CONF


device to another device.

HOLD_CALL_REQ Place an existing call connection into the HOLD_CALL_CONF


held state.

MAKE_CALL_REQ Initiate a call between two devices. MAKE_CALL_CONF

RECONNECT_CALL_ REQ Clear an active call and retrieve an RECONNECT_CALL_CONF


existing held call.

RETRIEVE_CALL_REQ Retrieve an existing held connection. RETRIEVE_CALL_CONF

TRANSFER_CALL_REQ Transfer a held call to another active call TRANSFER_CALL_CONF


at the same device.

QUERY_DEVICE_INFO_ Retrieve general information about a QUERY_DEVICE_INFO_


REQ specified device. CONF

SNAPSHOT_CALL_REQ Retrieve information about a specified SNAPSHOT_CALL_CONF


call.

SNAPSHOT_DEVICE_ REQ Retrieve information about a specified SNAPSHOT_DEVICE_CONF


device.

SEND_DTMF_SIGNAL_ Transmit a series of DTMF tones. SEND_DTMF_SIGNAL_ CONF


REQ

SUPERVISOR_ASSIST_ Assistance from a supervisor. SUPERVISOR_ASSIST_ CONF


REQ

EMERGENCY_CALL_ REQ Emergency call to supervisor. EMERGENCY_CALL_ CONF

BAD_CALL_REQ Indicate a bad line condition. BAD_CALL_CONF

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
171
Application Level Interfaces
QUERY_AGENT_STATE_REQ

Related Topics
Failure Indication Message Status Codes, on page 244

QUERY_AGENT_STATE_REQ
Send this message to retrieve the current state of an agent at a specified device.

Table 109: QUERY_AGENT_STATE_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 36. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the device is UINT 4


located.

MRDID Media Routing Domain ID as configured in Unified INT 4


CCE and the ARM client. MRDID and one of
ICMAgentID, AgentExtension, AgentID, or
AgentInstrument must be provided.

ICMAgentID The Skill Target ID, a unique agent identifier for INT 4
Unified CCE. At least one of ICMAgentID,
AgentExtension, AgentID, or AgentInstrument must
be provided.

Floating Part

Field Name Value Data Type Max. Size

AgentExtension The agent’s ACD teleset extension. At least one of STRING 16


ICMAgentID, AgentExtension, AgentID, or
AgentInstrument must be provided.

AgentID The agent’s ACD login ID. At least one of STRING 12


ICMAgentID, AgentExtension, AgentID, or
AgentInstrument must be provided.

AgentInstrument The agent’s ACD instrument number. At least one STRING 64


of ICMAgentID, AgentExtension, AgentID, or
AgentInstrument must be provided.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
172
Application Level Interfaces
QUERY_AGENT_STATE_REQ

The CTI Server sends the QUERY_AGENT_STATE CONF message as the query response:

Table 110: QUERY_AGENT_STATE_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 37. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding UINT 4
request message.

AgentState An AgentState value representing the current state of USHORT 2


the associated agent.

NumSkillGroups The number of Skill Groups that the agent is currently USHORT 2
associated with, up to a maximum of 20. This value also
indicates the number of SkillGroup Number,
SkillGroupID, SkillGroup Priority, and Skill GroupState
floating fields in the floating part of the message.

MRDID Media Routing Domain ID as configured in Unified INT 4


CCE and the ARM client.

NumTasks The number of tasks currently assigned to the agent – UINT 4


this is the number that Unified CCE compares to the
MaxTaskLimit to decide if the agent is available to be
assigned additional tasks. This includes active tasks as
well as those that are offered, paused, and in wrapup.

AgentMode The mode that the agent will be in when the login USHORT 2
completes. ROUTABLE = 1, NOT ROUTABLE = 0

MaxTaskLimit The maximum number of tasks that the agent can be UINT 4
simultaneously working on.

ICMAgentID The Skill Target ID, a unique agent identifier for Unified INT 4
CCE.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
173
Application Level Interfaces
QUERY_AGENT_STATE_REQ

Agent Availability An agent is available to work on a task in this Media UINT 4


Status Routing Domain if the agent meets all of these
conditions:
• The agent is routable for this Media Routing Domain
• The agent is not in Not Ready state for skill groups in
other Media Routing Domain
• The agent is temp routable, meaning that the agent is
not in Reserved, Active, Work-Ready, or Work-Not
Ready state on a non-interruptible task in another Media
Routing Domain.
• The agent has not reached the maximum task limit for
this Media Routing Domain
An available agent is eligible to be assigned a task. Who
can assign a task to the agent is determined by whether
or not the agent is Routable.
An agent is ICMAvailable in MRD X if he is available
in X and Routable with respect to X. An agent is
ApplicationAvailable in MRD X if he is available in X
and not Routable with respect to X. Otherwise an agent
is NotAvailable in MRD X.
NOT AVAILABLE = 0,
ICM AVAILABLE = 1,
APPLICATION AVAILABLE=2

DepartmentID Department ID of the Agent INT 4

Floating Part

Field Name Value Data Type Max


Size

AgentID (optional) The agent’s ACD login ID, if an agent is logged into the STRING 12
specified device.

AgentExtension The agent’s ACD teleset extension, if an agent is logged STRING 16


(optional) into the specified device.

AgentInstrument The agent’s ACD instrument number, if an agent is STRING 64


(optional) logged into the specified device.

SkillGroup Number The number of an agent Skill Group queue that the call UINT 4
has been added to, as known to the peripheral. May
contain the special value NULL_SKILL_GROUP when
not applicable or not available. There may be more than
one SkillGroupNumber field in the message (see
NumSkillGroups).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
174
Application Level Interfaces
SET_AGENT_STATE_REQ

SkillGroupID The SkillGroupID of the agent SkillGroup queue that UINT 4


the call has been added to. May contain the special value
NULL_SKILL_ GROUP when not applicable or not
available. There may be more than one SkillGroup ID
field in the message (see Num SkillGroups). This field
always immediately follows the corresponding
SkillGroupNumber field.

SkillGroup Priority The priority of the skill group, or 0 when skill group USHORT 2
priority is not applicable or not available. There may be
more than one SkillGroup Priority field in the message
(see NumSkillGroups). This field always immediately
follows the corresponding SkillGroupID field.

SkillGroupState One of the values from representing the current state of USHORT 2
the associated agent with respect to the skill group.
There may be more than one SkillGroupState field in
the message (see NumSkillGroups). This field always
immediately follows the corresponding
SkillGroupPriority field.

InternalAgentState A value representing the agent's internal state. All the USHORT 2
transitional states the agent goes through are part of
agent internal states values. Cisco reserved this tag for
internal use only.

Related Topics
Agent Internal States Message Values, on page 296
AgentState Values, on page 265
Special Values, on page 251

SET_AGENT_STATE_REQ
Use this message to change an ACD agent state to one of the values defined below.

Note For Remote Agent login, use “;” to separate the instrument and agent phone number in the AgentInstrument
field. Use RA_CALL_BY_CALL or RA_NAILED_CONNECTION in the AgentWorkMode field for
the Remote Agent login mode.

Table 111: SET_AGENT_STATE_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
175
Application Level Interfaces
SET_AGENT_STATE_REQ

MessageHeader Standard message header. MessageType = 38. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the device UINT 4


is located.

AgentState An AgentState value representing the desired USHORT 2


state of the associated agent.

AgentWorkMode An AgentWorkMode value representing the USHORT 2


desired work mode of the associated agent.

NumSkillGroups The number of SkillGroup Number and USHORT 2


SkillGroup Priority fields in the floating part
of the message, up to a maximum of 10.

EventReasonCode A peripheral-specific code indicating the reason USHORT 2


for the state change.

ForcedFlag The CTI Server is requested to force this state UCHAR 1


change regardless of its validity. Used only
with AGENT_STATE_LOGIN or
AGENT_STATE_LOGOFF:
0 = FALSE
1 = TRUE
2 = Agent authentication only. No agent state
change. Use with AGENT_STATE_LOGIN.
Note that this parameter is not used in CTI
Server and is reserved for future use.

AgentServiceReq BitMask indicates what services the agent UINT 4


expects.

Floating Part

Field Name Value Data Type Max.


Size

AgentInstrument The agent’s ACD instrument number STRING 64

AgentID (optional) The agent’s ACD login ID. This field is STRING 12
required when AgentState is AGENT_
STATE_LOGIN or AGENT_
STATE_LOGOUT.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
176
Application Level Interfaces
SET_AGENT_STATE_REQ

AgentPassword (optional) The password that allows an agent to log into STRING 64
or out of an agent SkillGroup. This field is
required when AgentState is
AGENT_STATE_LOGIN or AGENT_
STATE_LOGOUT and the SSOEnabled
element is not set to 1.

PositionID (optional) Required by some peripherals when AgentState STRING 12


is AGENT_ STATE_LOGIN.

SupervisorID (optional) Required by some peripherals when AgentState STRING 12


is AGENT_ STATE_LOGIN.

SSOEnabled (optional) When AgentState is AGENT_


STATE_LOGIN, this field indicates the agent's
SSO configuration at the client:
• 0 = SSO disabled
• 1 = SSO enabled

SkillGroupNumber (optional) When AgentState is AGENT_ STATE_LOGIN INT 4


or AGENT_ STATE_LOGOUT, this field may
be required by some peripherals and specifies
the number (as known to the peripheral) of the
agent Skill Group that the agent will be logged
into or out of. There may be more than one
Skill GroupNumber field in the message (see
NumSkill Groups). If AgentState is AGENT_
STATE_LOGOUT and no SkillGroupNumber
fields are provided, the agent will be logged
out of ALL currently logged-in skill groups.
Some ACDs ignore this field and/or use the
ACD default; see the list in the
CALL_DELIVERED_EVENT section.

SkillGroupPriority The priority of the skill group, or 0 when skill USHORT 2


group priority is not applicable or not available.
There may be more than one SkillGroup
Priority field in the message (see NumSkill
Groups). This field always immediately follows
the corresponding SkillGroup Number field.

The CTI Server sends the SET_AGENT_STATE_CONF message to confirm receipt of the request:

Table 112: SET_AGENT_STATE_CONF Message Format

Field Name Value Data Type Byte


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
177
Application Level Interfaces
ALTERNATE_CALL_REQ

MessageHeader Standard message header. MessageType = 39. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding request UINT 4
message.

Related Topics
AgentState Values, on page 265
AgentWorkMode Values, on page 291
CALL_DELIVERED_EVENT, on page 58

ALTERNATE_CALL_REQ
Use this message to alternate between calls. This message requests the compound action of placing an active
call on hold and then either retrieving a previously held call or answering an alerting call at the same device.

Table 113: ALTERNATE_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 40. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the calls are located. UINT 4

ActiveConnection The Call ID value assigned to the currently active call by UINT 4
CallID the peripheral or Unified CCE.

OtherConnection CallID The Call ID value assigned to the other call by the peripheral UINT 4
or Unified CCE.

ActiveConnection The type of device ID in the ActiveConnectionDeviceID USHORT 2


DeviceIDType floating field.

OtherConnection The type of device ID in the Other ConnectionDeviceID USHORT 2


DeviceIDType floating field.

Floating Part

Field Name Value Data Type Max.


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
178
Application Level Interfaces
ANSWER_CALL_REQ

ActiveConnection The device ID of the device associated with the currently STRING 64
DeviceID active connection.

OtherConnection Device The device ID of the device associated with the other STRING 64
ID connection.

AgentInstrument The agent’s ACD instrument number. STRING 64


(optional)

The CTI Server sends the ALTERNATE_CALL_CONF message to confirm receipt of the request:

Table 114: ALTERNATE_CALL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 41. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

ANSWER_CALL_REQ
Use this message upon delivery of an alerting call, to connect the alerting call at the device that is alerting.
The ANSWER_CALL_REQ message is defined in this table:

Table 115: ANSWER_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 42. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
179
Application Level Interfaces
CLEAR_CALL_REQ

ConnectionCallID The Call ID value assigned to the call by the UINT 4


peripheral or Unified CCE. May contain the
special value 0xffffffff if the alerting Call ID
value is not provided.

ConnectionDevice IDType The type of device ID in the USHORT 2


ConnectionDeviceID floating field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the STRING 64


connection.

AgentInstrument (optional) The ACD instrument number of the instrument STRING 64


that should answer the call.

The CTI Server sends the ANSWER_CALL_CONF message to confirm receipt of the request:

Table 116: ANSWER_CALL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. Message Type = 43. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding UINT 4
request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

CLEAR_CALL_REQ
Use this message on hanging up a call, to release all devices from the specified call.

Table 117: CLEAR_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 44. MHDR 8

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
180
Application Level Interfaces
CLEAR_CONNECTION_REQ

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is located. UINT 4

ConnectionCallID The Call ID value assigned to the call by the peripheral or UINT 4
Unified CCE.

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the connection. STRING 64

AgentInstrument The agent’s ACD instrument number. STRING 64


(optional)

The CTI Server sends the CLEAR_CALL_CONF message to confirm receipt of the request:

Table 118: CLEAR_CALL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. Message Type = 45. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

CLEAR_CONNECTION_REQ
Use this message on hanging up a specific phone, to release the device connection from the designated call.

Table 119: CLEAR_CONNECTION_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
181
Application Level Interfaces
CLEAR_CONNECTION_REQ

MessageHeader Standard message header. MessageType = 46. MHDR 8

InvokeID An ID for this request message, returned in the corresponding UINT 4


confirm message.

PeripheralID The PeripheralID of the ACD where the call is located. UINT 4

ConnectionCallID The Call ID value assigned to the call by the peripheral or UINT 4
Unified CCE.

ConnectionDevice The type of device ID in the ConnectionDeviceID floating USHORT 2


IDType field.

RequestingDevice Indicates the type of the device identifier supplied in the USHORT 2
IDType (optional) RequestingDeviceID field. NONE is an acceptable value.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID The device ID of the device connection that is to be released. STRING 64

AgentInstrument The ACD instrument number of the instrument with device STRING 64
(optional) connection that is to be released.

CTIOSCILClientID Unique ID for use by CTI OS to identify the CIL Client. STRING 64

RequestingDeviceID Optionally specifies the controller device requesting the clear STRING 64
(optional) operation.

The CTI Server sends the CLEAR_CONNECTION_CONF message to confirm receipt of the request:

Table 120: CLEAR_CONNECTION_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 47. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding UINT 4
request message.

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
182
Application Level Interfaces
CONFERENCE_CALL_REQ

CONFERENCE_CALL_REQ
Use this message to conference an existing held call with another active call. The two calls are merged and
the two connections at the conferencing device are in the connected state.

Table 121: CONFERENCE_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 48. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

HeldConnection CallID The Call ID value assigned to the held call by UINT 4
the peripheral or Unified CCE.

ActiveConnection CallID The Call ID value assigned to the active call by UINT 4
the peripheral or Unified CCE.

HeldConnection The type of device ID in the USHORT 2


DeviceIDType HeldConnectionDeviceID floating field.

ActiveConnection The type of device ID in the USHORT 2


DeviceIDType ActiveConnectionDevice ID floating.

CallPlacementType A CallPlacementType value specifying how the USHORT 2


call is to be placed.

CallMannerType A CallMannerType value specifying additional USHORT 2


call processing options.

AlertRings The maximum amount of time that the call’s USHORT 2


destination will remain alerting, specified as an
approximate number of rings. A zero value
indicates that the peripheral default (typically
10 rings) should be used.

CallOption A CallOption value specifying additional USHORT 2


peripheral-specific call options.

FacilityType A FacilityType value indicating the type of USHORT 2


facility to be used.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
183
Application Level Interfaces
CONFERENCE_CALL_REQ

AnsweringMachine An AnsweringMachine value specifying the USHORT 2


action to be taken if the call is answered by an
answering machine.

Priority Set to TRUE if the call should receive priority BOOL 2


handling.

PostRoute When this field is set to TRUE and a BOOL 2


DialedNumber is provided instead of a held call
(single step conference), the Unified CCE
post-routing capabilities determine the new call
destination.

NumNamed Variables The number of NamedVariable floating fields USHORT 2


present in the floating part of the message.

NumNamed Arrays The number of NamedArray floating fields USHORT 2


present in the floating part of the message.

Floating Part

Field Name Value Data Type Max.


Size

ActiveConnection DeviceID The device ID of the device associated with the STRING 64
active connection.

HeldConnection Device ID The device ID of the device associated with the STRING 64
held connection.

AgentInstrument (optional) The agent’s ACD instrument number. STRING 64

DialedNumber (optional) The number to be dialed to effect a single step STRING 40


conference of the active call. Either a
HeldConnection DeviceID or DialedNumber is
required.

UserToUserInfo (optional) The ISDN user-to-user information. UNSPEC 131

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrapup data. STRING 40

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
184
Application Level Interfaces
CONFERENCE_CALL_REQ

NamedVariable (optional) Call-related variable data that has a variable NAMEDVAR 251
name defined in the Unified CCE. There may
be an arbitrary number of NamedVariable and
NamedArray fields in the message, subject to a
combined total limit of 2000 bytes.

NamedArray (optional) Call-related variable data that has an array NAMED 252
variable name defined in the Unified CCE. There ARRAY
may be an arbitrary number of Named Variable
and NamedArray fields in the message, subject
to a combined total limit of 2000 bytes.

FacilityCode (optional) A trunk access code, split extension, or other STRING 40


data needed to access the chosen facility.

Authorization Code An authorization code needed to access the STRING 40


(optional) resources required to initiate the call.

AccountCode (optional) A cost-accounting or client number used by the STRING 40


peripheral for charge-back purposes.

The CTI Server sends the CONFERENCE_CALL_CONF message to confirm receipt of the request:

Table 122: CONFERENCE_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 49. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

NewConnection CallID The Call ID value assigned to the resulting UINT 4


conference call by the peripheral or Unified CCE.

NewConnection The type of device ID in the USHORT 2


DeviceIDType NewConnectionDeviceID floating field.

NumParties The number of active connections associated with USHORT 2


this conference call, up to a maximum of 16. This
value also indicates the number of Connected
PartyCallID, ConnectedParty DeviceIDType, and
Connected PartyDeviceID floating fields in the
floating part of the message.

LineHandle This field identifies the teleset line used, if known. USHORT 2
Otherwise this field is set to 0xffff.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
185
Application Level Interfaces
CONSULTATION_CALL_REQ

LineType The type of the teleset line in the LineHandle field. USHORT 2

Floating Part

Field Name Value Data Type Max. Size

NewConnection DeviceID The device ID of the device associated with the STRING 64
connection.

ConnectedParty CallID The Call ID value assigned to one of the conference UINT 4
(optional) call parties. There may be more than one
ConnectedParty CallID field in the message (see
NumParties).

ConnectedParty The type of device ID in the following USHORT 2


DeviceIDType (optional) ConnectedParty DeviceID floating field. There may
be more than one ConnectedPartyDevice IDType
field in the message (see NumParties). This field
always immediately follows the corresponding
Connected PartyCallID field.

ConnectedParty DeviceID The device identifier of one of the conference call STRING 64
(optional) parties. There may be more than one
ConnectedParty DeviceID field in the message (see
NumParties). This field always immediately follows
the corresponding Connected PartyDeviceIDType
field.

Related Topics
AnsweringMachine Values, on page 290
CallMannerType Values, on page 288
CallOption Values, on page 288
CallPlacementType Values, on page 287
ConnectionDeviceIDType Values, on page 277
FacilityType Values, on page 289
LineType Values, on page 278
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

CONSULTATION_CALL_REQ
Use this message to request the combined action of placing an active call on hold and then making a new call.
By default, the CTI Server uses the call context data of the active call to initialize the context data of the
consultation call. You can override some or all of this original call context in the consultation call by providing
the desired values in this request.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
186
Application Level Interfaces
CONSULTATION_CALL_REQ

Because this request includes putting the call on hold, you cannot use it for a call that is already on hold. If
you use this in a third-party desktop, the desktop must disable any options that make use of this call when the
active call is on hold.

Table 123: CONSULTATION_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = MHDR 8


50.

InvokeID An ID for this request message, returned UINT 4


in the corresponding confirm message.

PeripheralID The Unified CCE PeripheralID of the ACD UINT 4


where the call is located.

ActiveConnectionCallID The Call ID value assigned to the active UINT 4


call by the peripheral or Unified CCE.

ActiveConnectionDeviceIDType The type of device ID in the USHORT 2


ActiveConnectionDeviceID floating field.

CallPlacementType A CallPlacementType value specifying USHORT 2


how the call is to be placed.

CallMannerType A CallMannerType value specifying USHORT 2


additional call processing options.

ConsultType A ConsultType value indicating the reason USHORT 2


for initiating the consult call.

AlertRings The maximum amount of time that the USHORT 2


call’s destination will remain alerting,
specified as an approximate number of
rings. A zero value indicates that the
peripheral default (typically 10 rings)
should be used.

CallOption A CallOption value specifying additional USHORT 2


peripheral-specific call options.

FacilityType A FacilityType Value indicating the type USHORT 2


of facility to be used.

Answering Machine An AnsweringMachine value specifying USHORT 2


the action to be taken if the call is answered
by an answering machine.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
187
Application Level Interfaces
CONSULTATION_CALL_REQ

Priority Set this field to TRUE if the consultation BOOL 2


call should receive priority handling.

PostRoute When TRUE, the Unified CCE post-routing BOOL 2


capabilities determine the new call
destination.

NumNamed Variables The number of NamedVariable floating USHORT 2


fields present in the floating part of the
message.

NumNamed Arrays The number of NamedArray floating fields USHORT 2


present in the floating part of the message.

Floating Part

Field Name Value Data Type Max.


Size

ActiveConnection DeviceID The device ID of the device associated with STRING 64


the active connection.

DialedNumber The number to be dialed to establish the STRING 40


new call.

AgentInstrument (optional) The ACD instrument number of the STRING 64


instrument that should initiate the new call.
This field may be required for some
peripheral types.

UserToUserInfo (optional) The ISDN user-to-user information element UNSPEC 131


that should be used in place of the
corresponding data from the active call.

CallVariable1 (optional) Call-related variable data that should be STRING 41


used in place of the corresponding variable
from the active call.

… … … …

CallVariable10 (optional) Call-related variable data that should be STRING 41


used in place of the corresponding variable
from the active call.

CallWrapupData (optional) Call-related wrapup data that should be STRING 40


used in place of the corresponding data
from the active call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
188
Application Level Interfaces
CONSULTATION_CALL_REQ

NamedVariable (optional) Call-related variable data that has a variable NAMEDVAR 251
name defined in the Unified CCE. There
may be an arbitrary number of Named
Variable and NamedArray fields in the
message, subject to a combined total limit
of 2000 bytes.

NamedArray (optional) Call-related variable data that has an array NAMEDARRAY 252
variable name defined in the Unified CCE.
There may be an arbitrary number of
Named Variable and NamedArray fields
in the message, subject to a combined total
limit of 2000 bytes.

FacilityCode (optional) A trunk access code, split extension, or STRING 40


other data needed to access the chosen
facility.

Authorization Code (optional) An authorization code needed to access the STRING 40


resources required to initiate the call.

AccountCode (optional) A cost-accounting or client number used STRING 40


by the peripheral for charge-back purposes.

The CTI Server sends the CONSULTATION_CALL_CONF message to confirm receipt of the request:

Table 124: CONSULTATION_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 51. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

NewConnection CallID The Call ID value assigned to the resulting new call UINT 4
by the peripheral or Unified CCE.

NewConnection The type of device ID in the USHORT 2


DeviceIDType NewConnectionDeviceID floating field.

LineHandle This field identifies the teleset line used, if known. USHORT 2
Otherwise this field is set to 0xffff.

LineType The type of the teleset line in the LineHandle field. USHORT 2

Floating Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
189
Application Level Interfaces
DEFLECT_CALL_REQ

Field Name Value Data Type Max. Size

NewConnection DeviceID The device ID of the device associated with the new STRING 64
call.

Related Topics
AnsweringMachine Values, on page 290
CallMannerType Values, on page 288
CallOption Values, on page 288
CallPlacementType Values, on page 287
ConnectionDeviceIDType Values, on page 277
ConsultType Values, on page 289
FacilityType Values, on page 289
LineType Values, on page 278
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

DEFLECT_CALL_REQ
Use this message during a call forward operation, to take an alerting call from a known device and move it
to another device.

Table 125: DEFLECT_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 52. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

ConnectionCallID The Call ID value assigned to the alerting call by UINT 4


the peripheral or Unified CCE.

ConnectionDevice The type of device ID in the ConnectionDeviceID USHORT 2


IDType floating field.

CalledDevice Type The type of device ID in the Called DeviceID USHORT 2


floating field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
190
Application Level Interfaces
HOLD_CALL_REQ

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDeviceID The device ID of the device associated with the STRING 64


alerting connection.

CalledDeviceID The destination device address identifying where STRING 64


the call is to be deflected.

AgentInstrument The agent’s ACD instrument number. STRING 64


(optional)

The CTI Server sends the DEFLECT_CALL_CONF message to confirm receipt of the request:

Table 126: DEFLECT_CALL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 53. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274

HOLD_CALL_REQ
Use this message to place an existing call connection into the held state.

Table 127: HOLD_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 54. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
191
Application Level Interfaces
MAKE_CALL_REQ

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

ConnectionCallID The Call ID value assigned to the call by the UINT 4


peripheral or Unified CCE.

ConnectionDevice The type of device ID in the ConnectionDeviceID USHORT 2


IDType floating field.

Reservation TRUE to reserve the facility for reuse by the held BOOL 2
call. Not appropriate for most non-ISDN telephones.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the STRING 64


connection.

AgentInstrument The agent’s ACD instrument number. STRING 64


(optional)

The CTI Server sends the HOLD_CALL_CONF message to confirm receipt of the request.

Table 128: HOLD_CALL_CONF Message Format

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 55. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding request UINT 4
message.

Related Topics
ConnectionDeviceIDType Values, on page 277

MAKE_CALL_REQ
Use this message to initiate a call between two devices. This request attempts to create a new call and establish
a connection between the calling device (originator) and the called device (destination).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
192
Application Level Interfaces
MAKE_CALL_REQ

Table 129: MAKE_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MHDR 8


MessageType = 56.

InvokeID An ID for this request message, UINT 4


returned in the corresponding confirm
message.

PeripheralID The PeripheralID of the ACD where UINT 4


the devices are located.

CallPlacementType A CallPlacementType value specifying USHORT 2


how the call is to be placed.

CallMannerType A CallMannerType specifying USHORT 2


additional call processing options.

AlertRings The maximum amount of time that the USHORT 2


call’s destination will remain alerting,
specified as an approximate number of
rings. A zero value indicates to use the
peripheral default (typically 10 rings).

CallOption A CallOption value specifying USHORT 2


additional peripheral-specific call
options.

FacilityType A FacilityType value indicating the USHORT 2


type of facility to be used.

AnsweringMachine An AnsweringMachine value USHORT 2


specifying the action to be taken if the
call is answered by an answering
machine.

Priority Set this field to TRUE if the call should BOOL 2


receive priority handling.

PostRoute When TRUE, the Unified CCE BOOL 2


post-routing capabilities determine the
new call destination.

NumNamed Variables The number of NamedVariable floating USHORT 2


fields present in the floating part of the
message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
193
Application Level Interfaces
MAKE_CALL_REQ

NumNamedArrays The number of NamedArray floating USHORT 2


fields present in the floating part of the
message.

SkilGroupNumber The peripheral number of the skill UINT 4


group to make the call on behalf of.
May be NULL_SKILL_GROU P if
default is desired.

Floating Part

Field Name Value Data Type Max. Size

AgentInstrument The agent’s ACD instrument number STRING 64

DialedNumber The number to be dialed to establish STRING 40


the new call.

UserToUserInfo (optional) The ISDN user-to-user information. UNSPEC 131

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrapup data. STRING 40

NamedVariable (optional) Call-related variable data that has a NAMED 251


variable name defined in the Unified VAR
CCE. There may be an arbitrary
number of Named Variable and
NamedArray fields in the message,
subject to a combined total limit of
2000 bytes. .

NamedArray (optional) Call-related variable data that has an NAMED 252


array variable name defined in the ARRAY
Unified CCE. There may be an
arbitrary number of Named Variable
and NamedArray fields in the message,
subject to a combined total limit of
2000 bytes.

FacilityCode (optional) A trunk access code, split extension, or STRING 40


other data needed to access the chosen
facility.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
194
Application Level Interfaces
MAKE_CALL_REQ

AuthorizationCode (optional) An authorization code needed to access STRING 40


the resources required to initiate the
call.

AccountCode (optional) A cost-accounting or client number STRING 40


used by the peripheral for charge-back
purposes.

CCT (optional) Call control table, required for Aspect STRING 4


PIM unless Call Placement Type is
CPT_OUTBOUND.

The CTI Server sends the MAKE_CALL_CONF message to confirm receipt of the request.

Table 130: MAKE_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 57. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

NewConnection CallID The Call ID value assigned to the call by the UINT 4
peripheral or Unified CCE.

NewConnection The type of device ID in the NewConnection USHORT 2


DeviceIDType Device ID floating field.

LineHandle This field identifies the teleset line used, if USHORT 2


known. Otherwise this field is set to 0xffff.

LineType The type of the teleset line in the LineHandle USHORT 2


field.

Floating Part

Field Name Value Data Type Max. Size

NewConnection DeviceID The device ID of the device associated with the STRING 64
connection.

Related Topics
AnsweringMachine Values, on page 290
CallMannerType Values, on page 288

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
195
Application Level Interfaces
MAKE_PREDICTIVE_CALL_REQ

CallOption Values, on page 288


CallPlacementType Values, on page 287
ConnectionDeviceIDType Values, on page 277
FacilityType Values, on page 289
LineType Values, on page 278
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

MAKE_PREDICTIVE_CALL_REQ
Use this message to request the initiation of a call between a group of devices and a logical device on behalf
of a calling device (originating). The request creates a new call and establishes a connection with the called
device (terminating).

Table 131: MAKE_PREDICTIVE_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 58. MHDR 8

InvokeID An ID for this request message that will be UINT 4


returned in the corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the devices UINT 4


are located.

CallPlacementType A CallPlacementType value specifying how the USHORT 2


call is to be placed.

CallMannerType A CallMannerType value specifying additional USHORT 2


call processing options.

AlertRings The maximum amount of time that the call’s USHORT 2


destination will remain alerting, specified as an
approximate number of rings. A zero value
indicates that the peripheral default (typically 10
rings) should be used.

CallOption A CallOption value specifying additional USHORT 2


peripheral-specific call options.

FacilityType A FacilityType value indicating the type of USHORT 2


facility to be used.

AnsweringMachine An AnsweringMachine value specifying the USHORT 2


action to be taken if the call is answered by an
answering machine.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
196
Application Level Interfaces
MAKE_PREDICTIVE_CALL_REQ

Priority Set this field to TRUE if the call should receive BOOL 2
priority handling.

AllocationState An AllocationState value indicating the USHORT 2


destination connection state that should cause
the call to be connected to the originating device.

DestinationCountry A DestinationCountry value specifying the USHORT 2


country of the destination of the call.

AnswerDetectMode An AnswerDetectMode value specifying the USHORT 2


mode of operation of the answering machine
detection equipment.

AnswerDetectTime The time interval, in seconds, allotted for USHORT 2


answering machine detection. A zero value
indicates that the peripheral default should be
used.

AnswerDetect Control1 A peripheral-specific value used to control the ULONG 4


operation of answering machine detection
equipment. Set this field to zero when not used
or not applicable.

AnswerDetect Control2 A peripheral-specific value used to control the ULONG 4


operation of answering machine detection
equipment. Set this field to zero when not used
or not applicable.

NumNamed Variables The number of NamedVariable floating fields USHORT 2


present in the floating part of the message.

NumNamedArrays The number of NamedArray floating fields USHORT 2


present in the floating part of the message.

Floating Part

Field Name Value Data Type Max. Size

OriginatingDevice ID The ACD device (CCT, VDN, etc.) that will STRING 64
originate the call.

DialedNumber The number to be dialed to establish the new STRING 40


call.

UserToUserInfo (optional) The ISDN user-to-user information. UNSPEC 131

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
197
Application Level Interfaces
MAKE_PREDICTIVE_CALL_REQ

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrapup data. STRING 40

NamedVariable (optional) Call-related variable data that has a variable NAMEDVAR 251
name defined in the Unified CCE. There may be
an arbitrary number of Named Variable and
NamedArray fields in the message, subject to a
combined total limit of 2000 bytes.

NamedArray (optional) Call-related variable data that has an array NAMED 252
variable name defined in the Unified CCE. There ARRAY
may be an arbitrary number of Named Variable
and NamedArray fields in the message, subject
to a combined total limit of 2000 bytes.

FacilityCode (optional) A trunk access code, split extension, or other STRING 40


data needed to access the chosen facility.

AuthorizationCode (optional) An authorization code needed to access the STRING 40


resources required to initiate the call.

AccountCode (optional) A cost-accounting or client number used by the STRING 40


peripheral for charge-back purposes.

OriginatingLineID (optional) The originating line ID to be used for the call STRING 40
(not supported by all ACDs and trunk types).

CCT (optional) Call control table, required for Aspect PIM STRING 4
unless Call Placement Type is
CPT_OUTBOUND.

The MAKE_PREDICTIVE_CALL_CONF message confirms receipt of the request.

Table 132: MAKE_PREDICTIVE_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 59. MHDR 8

InvokeID Set to the same value as the InvokeID from the UINT 4
corresponding request message.

NewConnectionCallID The Call ID value assigned to the call by the UINT 4


peripheral or Unified CCE.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
198
Application Level Interfaces
RECONNECT_CALL_REQ

NewConnectionDeviceIDType Indicates the type of the device identifier supplied in USHORT 2


the NewConnectionDeviceID floating field.

LineHandle This field identifies the teleset line used, if known. USHORT 2
Otherwise this field is set to 0xffff.

LineType Indicates the type of the teleset line given in the USHORT 2
LineHandle field.

Floating Part

Field Name Value Data Type Max.


Size

NewConnectionDeviceID The device identifier of the device associated with STRING 64


the connection.

Related Topics
AllocationState Values, on page 285
AnswerDetectMode Values, on page 290

RECONNECT_CALL_REQ
Use this message to request the combined action of clearing an active call and then retrieving an existing held
call.

Table 133: RECONNECT_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType MHDR 8


= 60.

InvokeID An ID for this request message, returned UINT 4


in the corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the UINT 4


calls are located.

ActiveConnectionCallID The Call ID value assigned to the currently UINT 4


active call by the peripheral or Unified
CCE.

HeldConnectionCallID The Call ID value assigned to the held call UINT 4


by the peripheral or Unified CCE.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
199
Application Level Interfaces
RETRIEVE_CALL_REQ

ActiveConnectionDevice IDType The type of device ID in the USHORT 2


ActiveConnection DeviceID floating field.

HeldConnectionDevice IDType The type of device ID in the USHORT 2


HeldConnectionDeviceID.

Floating Part

Field Name Value Data Type Max.


Size

ActiveConnection DeviceID The device ID of the device associated STRING 64


with the currently active connection.

HeldConnectionDevice ID The device ID of the device associated STRING 64


with the held connection.

AgentInstrument (optional) The agent’s ACD instrument number. STRING 64

The CTI Server sends the RECONNECT_CALL_CONF message to confirm receipt of the request:

Table 134: RECONNECT_CALL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. Message Type = 61. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

RETRIEVE_CALL_REQ
Use this message to retrieve an existing held connection.

Table 135: RETRIEVE_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 62. MHDR 8

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
200
Application Level Interfaces
TRANSFER_CALL_REQ

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the call is UINT 4


located.

HeldConnection CallID The Call ID value assigned to the held call by the UINT 4
peripheral or Unified CCE.

HeldConnection The type of device ID in the USHORT 2


DeviceIDType HeldConnectionDeviceID floating field.

Floating Part

Field Name Value Data Type Max. Size

HeldConnection DeviceID The device ID of the device associated with the STRING 64
held connection.

AgentInstrument The agent’s ACD instrument number. STRING 64


(optional)

The CTI Server sends the RETRIEVE_CALL_CONF message to confirm receipt of the request.

Table 136: RETRIEVE_CALL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 63. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

TRANSFER_CALL_REQ
Use this message to transfer a held call to an active call. The two calls must have connections to a single
common device. Upon transfer, both of the connections with the common device become NULL and their
connection identifiers are released.
You can also use this message to transfer an active call to another number (single step or blind transfer).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
201
Application Level Interfaces
TRANSFER_CALL_REQ

Table 137: TRANSFER_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = MHDR 8


64.

InvokeID An ID for this request message, returned in UINT 4


the corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the UINT 4


calls are located.

ActiveConnection CallID The Call ID value assigned to the currently UINT 4


active call by the peripheral or Unified CCE.

HeldConnectionCallID The Call ID value assigned to the held call UINT 4


by the peripheral or Unified CCE. If there
is no held call (single step transfer), this
field must be set to 0xffffffff.

ActiveConnection DeviceIDType The type of device ID in the USHORT 2


ActiveConnectionDeviceID floating field.

HeldConnectionDevice IDType The type of device ID in the USHORT 2


HeldConnectionDeviceID floating field. If
there is no held call (single step transfer),
this field must be set to CONNECTION_
ID_NONE and no Held Connection
DeviceID floating field is needed.

CallPlacementType A CallPlacementType value specifying how USHORT 2


the call is to be placed.

CallMannerType A CallMannerType value specifying USHORT 2


additional call processing options.

AlertRings The maximum amount of time that the call’s USHORT 2


destination will remain alerting, specified
as an approximate number of rings. A zero
value indicates to use the peripheral default
(typically 10 rings).

CallOption A CallOption value specifying additional USHORT 2


peripheral-specific call options.

FacilityType A FacilityType value indicating the type of USHORT 2


facility to be used.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
202
Application Level Interfaces
TRANSFER_CALL_REQ

AnsweringMachine An AnsweringMachine value specifying the USHORT 2


action to be taken if the call is answered by
an answering machine.

Priority Set this field to TRUE if the call should BOOL 2


receive priority handling.

PostRoute When TRUE and a DialedNumber is BOOL 2


provided instead of a held call (single step
transfer), the Unified CCE post-routing
capabilities determine the new call
destination.

NumNamed Variables The number of NamedVariable floating USHORT 2


fields present in the floating part of the
message.

NumNamedArrays The number of NamedArray floating fields USHORT 2


present in the floating part of the message.

Floating Part

Field Name Value Data Type Max. Size

ActiveConnection DeviceID The device ID of the device associated with STRING 64


the currently active connection.

HeldConnectionDevice ID The device ID of the device associated with STRING 64


(optional) the held connection. Either a Held
ConnectionDeviceID or DialedNumber is
required.

AgentInstrument (optional) The agent’s ACD instrument number. STRING 64

DialedNumber (optional) The number to be dialed to effect a single STRING 40


step transfer of the active call. Either a
HeldConnectionDeviceID or DialedNumber
is required.

UserToUserInfo (optional) The ISDN user-to-user information. UNSPEC 131

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrapup data. STRING 40

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
203
Application Level Interfaces
TRANSFER_CALL_REQ

NamedVariable (optional) Call-related variable data that has a variable NAMED VAR 251
name defined in the Unified CCE. There
may be an arbitrary number of Named
Variable and NamedArray fields in the
message, subject to a combined total limit
of 2000 bytes.

NamedArray (optional) Call-related variable data that has an array NAMED 252
variable name defined in the Unified CCE. ARRAY
There may be an arbitrary number of Named
Variable and NamedArray fields in the
message, subject to a combined total limit
of 2000 bytes.

FacilityCode (optional) A trunk access code, split extension, or other STRING 40


data needed to access the chosen facility.

AuthorizationCode (optional) An authorization code needed to access the STRING 40


resources required to initiate the call.

AccountCode (optional) A cost-accounting or client number that the STRING 40


peripheral uses for charge-back purposes.

The CTI Server sends the TRANSFER_CALL_CONF message to confirm receipt of the request.

Table 138: TRANSFER_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = MHDR 8


65.

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

NewConnectionCallID The Call ID value assigned to the resulting UINT 4


transferred call by the peripheral or Unified
CCE.

NewConnection DeviceIDType The type of device ID in the USHORT 2


NewConnectionDeviceID floating field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
204
Application Level Interfaces
TRANSFER_CALL_REQ

NumParties The number of active connections associated USHORT 2


with this conference call, up to a maximum
of 16 (Special Values, on page 251). This
value also indicates the number of
ConnectedPartyCall ID,
ConnectedPartyDevice IDType, and
ConnectedParty DeviceID floating fields in
the floating part of the message.

LineHandle This field identifies the teleset line used, if USHORT 2


known. Otherwise this field is set to 0xffff.

LineType The type of the teleset line in the LineHandle USHORT 2


field.

Floating Part

Field Name Value Data Type Max. Size

NewConnection DeviceID The device ID of the device associated with STRING 64


the connection.

ConnectedPartyCallID The Call ID value assigned to one of the UINT 4


(optional) conference call parties. There may be more
than one ConnectedParty CallID field in the
message (see NumParties).

ConnectedPartyDeviceIDType The type of device ID in the following USHORT 2


(optional) ConnectedParty DeviceID floating field.
There may be more than one Connected
PartyDeviceID Type field in the message (see
NumParties). This field always immediately
follows the corresponding Connected
PartyCallID field.

ConnectedPartyDeviceID The device identifier of one of the conference STRING 64


(optional) call parties. There may be more than one
ConnectedPartyDeviceID field in the message
(see NumParties). This field always
immediately follows the corresponding
Connected PartyDeviceIDType field.

Related Topics
AnsweringMachine Values, on page 290
CallMannerType Values, on page 288
CallOption Values, on page 288
CallPlacementType Values, on page 287
ConnectionDeviceIDType Values, on page 277

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
205
Application Level Interfaces
QUERY_DEVICE_INFO_REQ

FacilityType Values, on page 289


LineType Values, on page 278
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

QUERY_DEVICE_INFO_REQ
Use this message to retrieve general information about a specified device.

Table 139: QUERY_DEVICE_INFO_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 78. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The PeripheralID of the ACD where the device is UINT 4


located.

Reserved Reserved for internal use, set this field to zero. USHORT 2

Floating Part

Field Name Value Data Type Max. Size

AgentInstrument The device instrument number. STRING 64

QUERY_DEVICE_INFO_CONF Message Format


The CTI Server sends the QUERY_DEVICE_INFO_CONF message as the query response.

Table 140: QUERY_DEVICE_INFO_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 79. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding UINT 4
request message.

PeripheralType The type of the peripheral. USHORT 2

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
206
Application Level Interfaces
QUERY_DEVICE_INFO_REQ

TypeOfDevice A TypeOfDevice value specifying the type of the device. USHORT 2

ClassOfDevice A ClassOfDevice value specifying the class(es) of the USHORT 2


device.

NumLines The number of LineHandle and LineType fields in the USHORT 2


floating part of the message, up to a maximum of 10.

Reserved Reserved for internal use. USHORT 2

MaxActiveCalls The maximum number of concurrent calls that can be USHORT 2


active at the device. Set to 0xFFFF if unknown or
unavailable.

MaxHeldCalls The maximum number of concurrent calls that can be USHORT 2


held at the device. Set to 0xFFFF if unknown or
unavailable.

MaxDevicesIn Conference The maximum number of devices that may participate USHORT 2
in conference calls at the device. Set to 0xFFFF if
unknown or unavailable.

MakeCallSetup A bitwise combination of Agent State Masks in which a UINT 4


MAKE_CALL_REQ may be initiated.

TransferConference Setup A bitwise combination of the Transfer Conference Setup UINT 4


Masks that represent all of the valid ways that the device
may be set up for a transfer or conference.

CallEventsSupported A bitwise combination of the Unsolicited Call Event UINT 4


Message Masks that may be generated by calls at the
device.

CallControlSupported A bitwise combination of the Call Control Masks that UINT 4


represent all of the valid call control requests supported
by the device.

OtherFeaturesSupported A bitwise combination of the Other Feature Masks that UINT 4


represent the other features supported by the device.

Floating Part

Field Name Value Data Type Max.


Size

LineHandle This field identifies the “handle” that is used by the USHORT 2
Unified CCE for this teleset line. There may be more
than one LineHandle field in the message (see
NumLines).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
207
Application Level Interfaces
QUERY_DEVICE_INFO_REQ

LineType The type of the teleset line in the preceding Line Handle USHORT 2
field. There may be more than one LineHandle field in
the message (see NumLines). This field always
immediately follows the corresponding LineHandle field.

Transfer Conference Setup Masks

Table 141: Transfer Conference Setup Masks

MaskName Description Value

CONF_SETUP_CONSULT_SPECIFIC ACD call and consultation call that was initiated with a 0x00000001
specific transfer or conference CallType.

CONF_SETUP_CONSULT_ANY ACD call and consultation call that was initiated with 0x00000002
any CallType.

CONF_SETUP_CONN_ HELD Any connected call and any held call. 0x00000004

CONF_SETUP_ANY_ Any two call appearances. 0x00000008


TWO_CALLS

CONF_SETUP_SINGLE_ A single ACD call (blind conference). 0x00000010


ACD_CALL

TRANS_SETUP_SINGLE_ACD_CALL A single ACD call (blind transfer). 0x00000020

CONF_SETUP_ANY_ Any single connected call (blind conference). 0x00000040


SINGLE_CALL

TRANS_SETUP_ANY_ Any single connected call (blind transfer). 0x00000080


SINGLE_CALL

Call Control Masks


This table lists the Call Control Masks.

Table 142: Call Control Masks

Mask Name Client Control Requests Value


CONTROL_QUERY_ AGENT_STATE QUERY_AGENT_STATE 0x00000001

CONTROL_SET_AGENT_STATE SET_AGENT_STATE 0x00000002

CONTROL_ ALTERNATE_CALL ALTERNATE_CALL 0x00000004

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
208
Application Level Interfaces
QUERY_DEVICE_INFO_REQ

Mask Name Client Control Requests Value


CONTROL_ANSWER_ CALL ANSWER_CALL 0x00000008

CONTROL_CLEAR_ CALL CLEAR_CALL 0x00000010

CONTROL_CLEAR_ CONNECTION CLEAR_CONNECTION 0x00000020

CONTROL_ CONFERENCE_CALL CONFERENCE_CALL 0x00000040

CONTROL_ CONSULTATION_CALL CONSULTATION_CALL 0x00000080

CONTROL_DEFLECT_ CALL DEFLECT_CALL 0x00000100

CONTROL_HOLD_CALL HOLD_CALL 0x00000200

CONTROL_MAKE_CALL MAKE_CALL 0x00000400

CONTROL_MAKE_ PREDICTIVE_CALL MAKE_PREDICTIVE_CALL 0x00000800

CONTROL_ RECONNECT_CALL RECONNECT_CALL 0x00001000

CONTROL_RETRIEVE_ CALL RETRIEVE_CALL 0x00002000

CONTROL_TRANSFER_ CALL TRANSFER_CALL 0x00004000

CONTROL_QUERY_ DEVICE_INFO QUERY_DEVICE_INFO 0x00008000

CONTROL_SNAPSHOT_CALL SNAPSHOT_CALL 0x00010000

CONTROL_SNAPSHOT_DEVICE SNAPSHOT_DEVICE 0x00020000

CONTROL_SEND_ DTMF_SIGNAL SEND_DTMF_SIGNAL 0x00040000

Other Feature Masks


This table lists the Other Feature Masks.

Table 143: Other Feature Masks

Mask Name Description Value


FEATURE_POST_ROUTE Unified CCE Post Routing feature available. 0x00000001

FEATURE_UNIQUE_ Consultation call CallIDs are unique. 0x00000002


CONSULT_CALLID

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
209
Application Level Interfaces
SNAPSHOT_CALL_REQ

Related Topics
AgentState Values, on page 265
ClassOfDevice Values, on page 287
LineType Values, on page 278
PeripheralType Values, on page 267
TypeOfDevice Values, on page 286

SNAPSHOT_CALL_REQ
Use this message to retrieve information about a specified call, including a list of the associated devices and
the connection state for each device.

Table 144: SNAPSHOT_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 82. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The Unified CCE PeripheralID of the ACD UINT 4


where the call is located.

ConnectionCallID The Call ID value assigned to the call by the UINT 4


peripheral or Unified CCE.

ConnectionDevice IDType The type of device ID in the USHORT 2


ConnectionDeviceID floating field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the STRING 64


connection.

The CTI Server sends the SNAPSHOT_CALL_CONF message to provide the requested data.

Table 145: SNAPSHOT_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
210
Application Level Interfaces
SNAPSHOT_CALL_REQ

MessageHeader Standard message header. MessageType = 83. MHDR 8

InvokeID Set to the value of the InvokeID from the UINT 4


corresponding request message.

CallType The general classification of the call type. USHORT 2

NumCTIClients The current number of CTI clients associated USHORT 2


with this call. This value also indicates the
number of CTI client signatures and timestamps
in the floating part of the message.

NumCallDevices The number of active devices associated with USHORT 2


this call, up to a maximum of 16. This value also
indicates the number of CallConnectionCall ID,
CallConnectionDeviceID Type,
CallConnectionDevice ID, CallDeviceType, Call
DeviceID, and CallDevice ConnectionState
floating fields in the floating part of the message.

NumNamed Variables The number of NamedVariable floating fields USHORT 2


present in the floating part of the message.

NumNamedArrays The number of NamedArray floating fields USHORT 2


present in the floating part of the message.

CalledParty Disposition Indicates the disposition of the called party. USHORT 2

Floating Part

Field Name Value Data Type Max.


Size

ANI (optional) The calling line ID of the caller. STRING 40

UserToUserInfo (optional) The ISDN user-to-user information element. UNSPEC 131

DNIS (optional) The DNIS provided with the call. STRING 32

DialedNumber (optional) The number dialed. STRING 40

CallerEnteredDigits The digits entered by the caller in response to STRING 40


(optional) VRU prompting.

RouterCallKeyDay Together with the RouterCall KeyCallID field UINT 4


forms the unique 64-bit key for locating this
call’s records in the Unified CCE. Only provided
for Post-routed and Translation-routed calls.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
211
Application Level Interfaces
SNAPSHOT_CALL_REQ

RouterCallKey CallID The call key created by Unified CCE. Unified UINT 4
CCE resets this counter at midnight.

CallVariable1 (optional) Call-related variable data. STRING 41

… … … …

CallVariable10 (optional) Call-related variable data. STRING 41

CallWrapupData (optional) Call-related wrapup data. STRING 40

NamedVariable (optional) Call-related variable data that has a variable NAMED VAR 251
name defined in the Unified CCE. There may
be an arbitrary number of Named Variable and
NamedArray fields in the message, subject to a
combined total limit of 2000 bytes.

NamedArray (optional) Call-related variable data that has an array NAMED 252
variable name defined in the Unified CCE. There ARRAY
may be an arbitrary number of Named Variable
and NamedArray fields in the message, subject
to a combined total limit of 2000 bytes.

CTIClientSignature The Client Signature of a CTI client previously STRING 64


associated with this call. There may be more
than one CTIClient Signature field in the
message (see NumCTIClients).

CTIClient Timestamp The date and time that the preceding CTIClient TIME 4
signature was first associated with the call. There
may be more than one CTIClientTimestamp field
in the message (see NumCTI Clients). This field
always immediately follows the
CTIClientSignature field to which it refers.

CallConnection CallID The Call ID value assigned to one of the call UINT 4
(optional) device connections. There may be more than one
CallConnection CallID field in the message (see
NumCallDevices).

CallConnection The type of device ID in the following USHORT 2


DeviceIDType (optional) CallConnection DeviceID floating field. There
may be more than one CallConnection
DeviceIDType field in the message (see
NumCallDevices). This field always immediately
follows the corresponding CallConnection
CallID field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
212
Application Level Interfaces
SNAPSHOT_CALL_REQ

CallConnection DeviceID The device identifier of one of the call device STRING 64
(optional) connections. There may be more than one
CallConnection DeviceID field in the message
(see Num CallDevices). This field always
immediately follows the corresponding
CallConnection DeviceIDType field.

CallDeviceType (optional) The type of device ID in the following USHORT 2


CallDeviceID floating field. There may be more
than one CallDeviceIDType field in the message
(see NumCall Devices). This field always
immediately follows the corresponding
CallConnection DeviceID field.

CallDeviceID (optional) The device ID of the subject device. There may STRING 64
be more than one CallDeviceID field in the
message (see NumCall Devices). This field
always immediately follows the corresponding
CallDevice IDType field.

CallDevice Connection State The local connection state of one of the call USHORT 2
(optional) device connections. There may be more than one
Call DeviceConnection State field in the message
(see NumCall Devices). This field always
immediately follows the corresponding
CallDeviceID field.

CallReferenceID (optional) For Unified CCE systems where the Unified CM UNSPEC 32
provides it, this will be a unique call identifier.

COCConnectionCallID If specified, indicates that this call is a call on UINT 4


(optional) behalf of a consult call.

COCCallConnection If specified, indicates the type of connection USHORT 2


DeviceIDType (optional) identifier specified in the ConnectionDeviceID
floating field for the original call.

COCCallConnection If specified, indicates the device portion of the STRING 64


DeviceID (optional) connection identifier of the original call.

Related Topics
CallType Values, on page 275
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
LocalConnectionState Values, on page 268
NAMEDVAR Data Type, on page 27
NAMEDARRAY Data Type, on page 27

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
213
Application Level Interfaces
SNAPSHOT_DEVICE_REQ

Special Values, on page 251

SNAPSHOT_DEVICE_REQ
Use this message to retrieve information on a specified device, including a list of the calls associated with the
device and the current state of each call. The CTI Client must be granted both Client Control and All Events
services to look at all devices.

Note If the SERVICE_ACD_LINE_ONLY service is requested, the SNAPSHOT_DEVICE_REQ includes the


calls in the confirmation that are on the primary (ACD) line but not the calls on a secondary line.

Table 146: SNAPSHOT_DEVICE_REQ Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 84. MHDR 8

InvokeID An ID for this request message, returned in the UINT 4


corresponding confirm message.

PeripheralID The Unified CCE PeripheralID of the ACD where UINT 4


the device is located.

SnapshotDeviceType For non-agent devices this indicates the type of the USHORT 2
device specified in the DeviceIDType Values table
supplied in the following AgentInstrument floating
field.

Floating Part

Field Name Value Data Type Max.


Size

AgentInstrument The device instrument number STRING 64

The CTI Server sends the SNAPSHOT_DEVICE_CONF message to provide the requested data.

Table 147: SNAPSHOT_DEVICE_CONF Message Format

Fixed Part

Field Name Value Data Type Byte Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
214
Application Level Interfaces
SNAPSHOT_DEVICE_REQ

MessageHeader Standard message header. MessageType = MHDR 8


85.

InvokeID The value of the InvokeID from the UINT 4


corresponding request message.

NumCalls The number of active calls associated with USHORT 2


this device, up to a maximum of 16. This
value also indicates the number of
CallConnection CallID,
CallConnectionDevice IDType,
CallConnection DeviceID, and CallState
floating fields in the floating part of the
message.

Floating Part

Field Name Value Data Type Max. Size

CallConnectionCallID The CallID value assigned to one of the calls. UINT 4


(optional) There may be more than one Call
ConnectionCallID field in the message (see
NumCalls).

CallConnectionDevice IDType The type of device ID in the following USHORT 2


(optional) CallConnectionDeviceID floating field. There
may be more than one CallConnection
DeviceID Type field in the message (see
NumCalls). This field always immediately
follows the corresponding Call
ConnectionCallID field.

CallConnection DeviceID The device identifier of one of the call STRING 64


(optional) connections. There may be more than one
Call ConnectionDeviceID field in the message
(see NumCalls). This field always
immediately follows the corresponding
CallConnectionDeviceIDType field.

CallState (optional) The active state of the call. There may be USHORT 2
more than one CallState field in the message
(see NumCalls). This field always
immediately follows the corresponding Call
ConnectionDeviceID field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
215
Application Level Interfaces
SEND_DTMF_SIGNAL_REQ

SilentMonitorStatus (optional) The silent monitor status for the call: USHORT 2
0: normal call (not silent monitor call)
1: monitor initiator of silent monitor call. This
call was the result of a supervisor silently
monitoring an agent.
2: monitor target of silent monitor call. This
call was the result of an agent being silently
monitored.
There may be more than one
SilentMonitorStatus field in the message (see
NumCalls). This field always immediately
follows the corresponding CallState field.

Related Topics
ConnectionDeviceIDType Values, on page 277
DeviceIDType Values, on page 274
LocalConnectionState Values, on page 268
Special Values, on page 251

SEND_DTMF_SIGNAL_REQ
Use this message to request that the ACD transmits a sequence of DTMF tones on behalf of a call party.

Table 148: SEND_DTMF_SIGNAL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 91. MHDR 8

InvokeID An ID for this request message, returned in the corresponding UINT 4


confirm message.

PeripheralID The Unified CCE PeripheralID of the ACD where the device UINT 4
is located.

ConnectionCallID The Call ID value assigned to the call by the peripheral or UINT 4
Unified CCE.

ConnectionDevice The type of device ID in the Connection DeviceID floating USHORT 2


IDType field.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
216
Application Level Interfaces
SUPERVISOR_ASSIST_REQ

ToneDuration Specifies the duration in milliseconds of DTMF digit tones. USHORT 2


Use 0 to take the default. May be ignored if the peripheral
is unable to alter the DTMF tone timing.

PauseDuration Specifies the duration in milliseconds of DTMF interdigit UINT 4


spacing. Use 0 to take the default. May be ignored if the
peripheral is unable to alter the DTMF tone timing.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice ID The device ID of the device associated with the connection. STRING 64

DTMFString The sequence of tones to be generated. STRING 32

AgentInstrument The agent’s ACD instrument number. STRING 64


(optional)

CTIOSCILClientID Unique ID for use by CTI OS to identify CIL Client. STRING 64

The CTI Server sends the SEND_DTMF_SIGNAL_CONF message to confirm receipt of the request.

Table 149: SEND_DTMF_SIGNAL_CONF Message Format

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 92. MHDR 8

InvokeID Set to the value of the InvokeID from the corresponding UINT 4
request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

SUPERVISOR_ASSIST_REQ
When an agent needs supervisor assistance, an agent may send a SUPERVISOR_ASSIST_REQ message to
the CTI server asking for assistance from a team supervisor. The message will be forwarded to the PIM, who
will first check the team’s primary supervisor. If the primary supervisor is not available, the PIM will initiate
a post-route request to the Unified CCE CallRouter using the team’s configured DialedNumber to find an
available supervisor in the supervisor group. Once an available supervisor is found, a call with calltype
SUPERVISOR_ASSIST is initiated, and a SUPERVISOR_ASSIST_CONF will be sent to the requesting
client. If no supervisor can be found a FAILURE_CONF response is returned to the requesting client.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
217
Application Level Interfaces
SUPERVISOR_ASSIST_REQ

The SUPERVISOR_ASSIST_REQ message allows a CTI Client to notify the client agent’s supervisor that
assistance with the indicated call is required.

Table 150: SUPERVISOR_ASSIST_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 118. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The Unified CCE PeripheralID of the ACD where the call is UINT 4
located.

ConnectionCallID The Call ID value of the call that the agent needs assistance UINT 4
with. May contain the special value 0xffffffff when there is
no related call.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType ConnectionDeviceID floating field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The identifier of the connection between the call and the agent’s STRING 64
ID device.

AgentExtension The agent’s ACD teleset extension. For clients with ALL STRING 16
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

AgentID The agent’s ACD login ID. For clients with ALL EVENTS or STRING 12
PERIPHERAL MONITOR service, at least one of
AgentExtension, AgentID, or AgentInstrument must be
provided.

AgentInstrument The agent’s ACD instrument number. For clients with ALL STRING 64
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
218
Application Level Interfaces
EMERGENCY_CALL_REQ

When a supervisor CTI client has been notified the CTI Server responds to the CTI Client with the
SUPERVISOR_ASSIST_CONF message.

Table 151: SUPERVISOR_ASSIST_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 119. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

ConnectionCallID The Call ID value assigned to the resulting SupervisorAssist UINT 4


call by the peripheral or Unified CCE.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType ConnectionDeviceID floating field.

LineHandle This field identifies the teleset line used, if known. Otherwise USHORT 2
this field is set to 0xffff.

LineType Indicates the type of the teleset line given in the LineHandle USHORT 2
field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The identifier of the device connection associated with the new STRING 64
ID call.

Related Topics
ConnectionDeviceIDType Values, on page 277
LineType Values, on page 278

EMERGENCY_CALL_REQ
When an agent needs to declare an emergency situation to their supervisor, an agent may send
EMERGENCY_CALL_REQ to the CTI server to notify an agent team supervisor. Like the Supervisor Assist
Request, the message will be forwarded to the PIM, who will first check the team’s primary supervisor. If the
primary supervisor is not available, the PIM will initiate a post-route request to the Unified CCE CallRouter
using the team’s configured DialedNumber to find an available supervisor in the supervisor group. Once an
available supervisor is found, a call with calltype EMERGENCY_ASSIST is initiated and an

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
219
Application Level Interfaces
EMERGENCY_CALL_REQ

EMERGENCY_CALL_CONF will be sent to the requesting client. If no supervisor can be found a


FAILURE_CONF response is returned to the requesting client. In addition, an EMERGENCY_CALL_EVENT
will be sent to all bridge applications, even if no supervisor was found. At same time, an
EMERGENCY_CALL_EVENT will be sent to recording servers. Emergency Call requests will always cause
an Unified CCE event to be reported whether or not a supervisor was found to satisfy the request.
The EMERGENCY_CALL_REQ message allows a CTI Client to notify the client agent’s supervisor that an
emergency call is in progress and generate a corresponding Unified CCE Alarm.

Table 152: EMERGENCY_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 121. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The Unified CCE PeripheralID of the ACD where the call is UINT 4
located.

ConnectionCallID The Call ID value of the call that the agent needs assistance UINT 4
with. May contain the special value 0xffffffff when there is
no related call.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType Connection DeviceID floating field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The identifier of the connection between the call and the agent’s STRING 64
ID device.

AgentExtension The agent’s ACD teleset extension. For clients with ALL STRING 16
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

AgentID The agent’s ACD login ID. For clients with ALL EVENTS or STRING 12
PERIPHERAL MONITOR service, at least one of
AgentExtension, AgentID, or AgentInstrument must be
provided.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
220
Application Level Interfaces
EMERGENCY_CALL_REQ

AgentInstrument The agent’s ACD instrument number. For clients with ALL STRING 64
EVENTS or PERIPHERAL MONITOR service, at least one
of AgentExtension, AgentID, or AgentInstrument must be
provided.

EMERGENCY_CALL_CONF Message Format


The CTI Server responds to the CTI Client with the EMERGENCY_CALL_CONF message.

Table 153: EMERGENCY_CALL_CONF Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 122. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

ConnectionCallID The Call ID value of the call that the agent needs assistance UINT 4
with. Contains the special value 0xffffffff if there is no related
call.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType Connection DeviceID floating field.

LineHandle This field identifies the teleset line used, if known. Otherwise USHORT 2
this field is set to 0xffff.

LineType Indicates the type of the teleset line given in the LineHandle USHORT 2
field.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The identifier of the connection between the call and the agent’s STRING 64
ID device.

EMERGENCY_CALL_EVENT Message Format


The EMERGENCY_CALL_EVENT message notifies bridge clients that an agent is handling the indicated
call as an emergency call.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
221
Application Level Interfaces
EMERGENCY_CALL_REQ

Table 154: EMERGENCY_CALL_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 123. MHDR 8

PeripheralID The Unified CCE PeripheralID of the ACD where the call is UINT 4
located.

ConnectionCallID The Call ID value assigned to the call by the peripheral or UINT 4
Unified CCE.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType ConnectionDeviceID floating field.

SessionID The CTI client SessionID of the CTI client making the UINT 4
notification.

Floating Part

Field Name Value Data Type Max.


Size

ConnectionDevice The identifier of the connection between the call and the agent’s STRING 64
ID device.

ClientID The ClientID of the client making the notification. STRING 64

ClientAddress The IP address of the client making the notification. STRING 64

AgentExtension The agent’s ACD teleset extension. STRING 16

AgentID The agent’s ACD login ID. STRING 12

AgentInstrument The agent’s ACD instrument number. STRING 64

Related Topics
ConnectionDeviceIDType Values, on page 277
LineType Values, on page 278

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
222
Application Level Interfaces
BAD_CALL_REQ

BAD_CALL_REQ
The agent or supervisor can click on a Bad Call Line button on their desktop to initiate this feature. A record
would capture the information of the trunk, gateways, and other devices used in the connection. This information
is intended to aid troubleshooting by service personnel.
When a line condition is in poor quality, an agent could send the BAD_CALL_REQ message to mark the bad
line.

Table 155: BAD_CALL_REQ Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 139. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

PeripheralID The Unified CCE PeripheralID of the ACD where the call is UINT 4
located.

ConnectionDevice Indicates the type of the connection identifier supplied in the USHORT 2
IDType Connection DeviceID floating field.

ConnectionCallID The Call ID value of the call that the agent needs to mark to UINT 4
bad line call.

Floating Part

Field Name Value Data Type Max.


Size

Connection The identifier of the connection between the call and the agent’s STRING 64
DeviceID device.

AgentID The AgentID. STRING 12

When the request has been processed, the CTI Server responds to the CTI Client with the BAD_CALL_CONF
message.

Table 156: BAD_CALL_CONF Message Format

Field Name Value Data Type Byte


Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
223
Application Level Interfaces
AGENT_GREETING_CONTROL_REQ

MessageHeader Standard message header. MessageType = 140. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

Related Topics
ConnectionDeviceIDType Values, on page 277

AGENT_GREETING_CONTROL_REQ
The AGENT_GREETING_CONTROL_REQ allows the agent to stop the greeting while the greeting is
playing and allows the agent to enable or disable the playing of the greeting during a login sesssion.

Table 157: AGENT_GREETING_CONTROL_REQ Message Format

Fixed Part
Field Name Value Data Type Byte Size
MessageHeader Standard message header. MHDR 8
MessageType = 249

InvokeID An ID for this request message that will be returned UINT 4


in the corresponding confirm message.

PeripheralID The ICR PeripheralID of the ACD where the call UINT 4
is located.

AgentAction 0 = stop the greeting that is currently being played. USHORT 2


1 = disable Agent Greeting for this login session.
2 = enable Agent Greeting for this login session.
Notes:
AgentAction = 0 stops the playing of the Agent
Greeting for the current call.
Agent Action = disables Agent Greeting feature for
the rest of login session but does not stop the
greeting that currently playing for the current call.

Floating Part

Field Name Value Data Type Byte Size

AgentID (required) The agent’s ACD login ID. String 12

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
224
Application Level Interfaces
Server Service

The CTI Server responds to the CTI Client with the AGENT GREETING_CONTROL_CONF message.

Table 158: AGENT_GREETING_CONTROL_CONF Message Format

Fixed Part
Field Name Value Data Type Byte
Size
MessageHeader Standard message header. MHDR 8
MessageType = 250.

InvokeID Set to the same value as the InvokeID UINT 4


from the corresponding request
message.

Server Service
Server Service
A server application specifies the new service type CTI_SERVICE_SERVER to identify itself as server
application. The server application then registers each service that it wishes to provide by sending a new
message, REGISTER_SERVICE_REQ, to the CTI Server. When a CTI client application requests a service
that is provided by a server application, such as CallRecording, the CTIServer selects a registered server
application and forwards the client request to the server application. If no server is registered for the desired
service the client request is refused with an E_CTI_NO_SERVER_FOR_REQUEST error.
The server service optionally allows multiple server applications to supply the same service. The ServerMode
registration parameter determines how a server is selected to handle a given request. All server applications
that wish to provide the same service must use the same ServerMode:
• Exclusive. The first server application to register the service is the only one to serve requests. All other
requests to register a server application for that service are refused with an
E_CTI_NO_SERVER_FOR_REQUEST.
• Round-Robin. Multiple server applications may register the service. The server application that has
been waiting the longest for a request of this service type is chosen to service the request.
• Parallel. Multiple server applications may register the service. Every request is sent to all registered
servers concurrently. Every server response is forwarded back to the requesting client.

REGISTER_SERVICE_REQ
Initially, the only service that server applications may provide is call recording by registering the
“Cisco:CallRecording” service using a REGISTER_SERVICE_REQ message.

Table 159: REGISTER_SERVICE_REQ Message Format

Fixed Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
225
Application Level Interfaces
UNREGISTER_SERVICE_REQ

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 143. MHDR 8

InvokeID An ID for this request message that will be returned in the UINT 4
corresponding confirm message.

ServerMode The CTI Server method is for selecting among multiple server USHORT 2
applications that register to provide this service. All servers
must specify the same ServerMode, one of the following
values:
0: Exclusive;
1: Round-Robin;
2: Parallel.

Floating Part

Field Name Value Data Type Max. Size

ServiceName The name of the service that the application wishes to provide. STRING 64

The REGISTER_SERVICE_CONF message confirms successful completion of the request.

Table 160: REGISTER_SERVICE_CONF Message Format

Field Name Value Data Byte


Type Size

MessageHeader Standard message header. MessageType = 144. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

RegisteredServiceID The ID of registered service. UINT 4

UNREGISTER_SERVICE_REQ
Prior to closing its session with the CTI Server, or at any time that the server application wishes to discontinue
providing a registered service, it must send an UNREGISTER_SERVICE_REQ message.

Table 161: UNREGISTER_SERVICE_REQ Message Format

Fixed Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
226
Application Level Interfaces
Configuration Acquisition Messages

Field Name Value Data Byte


Type Size

MessageHeader Standard message header. MessageType = 145. MHDR 8

InvokeID An ID for this request message that is returned in the corresponding UINT 4
confirm message.

Registered The ID of registered service that the application wishes to UINT 4


ServiceID unregister.

The UNREGISTER_SERVICE_CONF message confirms successful completion of the request.

Table 162: UNREGISTER_SERVICE_CONF Message Format

Field Name Value Data Byte


Type Size

MessageHeader Standard message header. MessageType = 146. MHDR 8

InvokeID Set to the same value as the InvokeID from the corresponding UINT 4
request message.

Configuration Acquisition Messages


The CTI interface will support the client acquiring the configuration of the CTI Server. These messages will
provide information on the configuration of agents, skill groups, etc. Although the same messages are used
to transport the data, the messages can be categorized as two types: Initial configuration, and Update messages.

Configuration keys
The configuration key is an 8 byte unique identifier that will be maintained by the server and optionally saved
by the client. The purpose of each key is to allow the client to determine if any configuration changes have
occurred since they last received the configuration from the server. There are 4 individual keys allowing
granularity for each major configuration item. If the server does not support 4 individual keys then it should
send up a single key in all 4 individual keys so that all configuration operations will be done. The key(s)
should be changed on the server any time when there is a configuration change.

Initial configuration acquisition


During the initial configuration, the client may or may not request the configuration keys from the server with
the CONFIG_REQUEST_KEY_EVENT/CONFIG_KEY_EVENT messages. The client then must send a
CONFIG_REQUEST_EVENT even if no configuration is desired. If no configuration is desired (and specified
in the message) this message will serve to notify the server that the client is ready to receive update messages.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
227
Application Level Interfaces
Update messages

If a configuration is specified then immediately following the CONFIG_END_EVENT, server is free to send
up unsolicited configuration events.

Update messages
After the CONFIG_REQUEST_EVENT is received by the server, and if requested the configuration data is
sent up to the client, the server is free to send blocks of update configuration messages any time to the client.
Additionally, the server should honor the mask for the particular configuration event message types specified
in the OPEN_REQ message.

Message order
The configuration must be sent in a particular order. This order is as follows:
1 Service Information
2 Skill Group
3 Agent Information
4 Device Information
5 Call Type Information
6 Media Routing Domain Information

Please note that there are no Invocation ID for the request and response events. This is due to the fact that
only one request can be outstanding at one time.

CONFIG_REQUEST_KEY_EVENT
The CONFIG_REQUEST_KEY_EVENT may be sent by the client to request the current configuration keys
for different items.
CONFIG_REQUEST_KEY_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 230. MHDR 8

PeripheralID Peripheral ID of ACD for which configuration keys are UINT 4


required.

Floating Part

Field Name Value Data Type Max. Size

CustomerID Currently not used in UCCE. UINT 4

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
228
Application Level Interfaces
CONFIG_KEY_EVENT

CONFIG_KEY_EVENT
The CONFIG_KEY_EVENT message is sent by the CTI Server in response to
CONFIG_REQUEST_KEY_EVENT message. It will contain the configuration keys at the time of the request.
Note that if the CTI Server doesn’t support separate keys that it may respond with 4 identical keys and it
should send the message with no optional fields. Returning any key of all binary 0’s will indicate to the client
that particular configuration should be uploaded.

Table 163: CONFIG_KEY_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte


Size

MessageHeader Standard message header. MessageType = 231. MHDR 8

ConfigkeyStatus Status value of operation. See UINT 4


CONFIG_KEY_EVENT, on page 229.

Floating Part

Field Name Value Data Type Max.


Size

ServiceConfigKey The CTI Server configuration key for Services. UNSPEC (8) 8

SkillGroupConfigKey The CTI Server configuration key for Skill UNSPEC (8) 8
Groups.

AgentConfigKey The CTI Server configuration key for Agents. UNSPEC (8) 8

DeviceConfigKey The CTI Server configuration key for Device UNSPEC (8) 8
Information.

CallTypeConfigKey The CTI Server configuration key for Call Type UNSPEC (8) 8
Information.

CONFIG_KEY_EVENT Status values

Status Value Value Meaning

CONFIG_SUCCESS 0 Successful upload of configuration data.

CONFIG_SERVICE_PROVIDER 1 No data was sent due to a service


provider.
environment

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
229
Application Level Interfaces
CONFIG_REQUEST_EVENT

CONFIG_NO_KEY_SUPPORT 2 The server does not support


configuration keys.

CONFIG_UNKNOWN_CUSTOMER 3 The customer specified does not exist


on the server.

CONFIG_REQUEST_EVENT
The CONFIG_REQUEST_EVENT message may be sent by the client whenever it wants to check andreceive
a particular configuration from the CTI Server. The CTI Server should respond by sending a
CONFIG_BEGIN_EVENT, CONFIG_xxx records, then a CONFIG_END block containing all records for
that configuration item.

Table 164: CONFIG_REQUEST_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 232. MHDR 8

ConfigInformation Bit mask indicating what type of information is requested. UINT 4


• 1=Service Information
• 2=Skill Group Information
• 4=Agent Information
• 8=Device Information
• 16=Call Type Information
• 32=Media Routing Domain Information

If 0, this indicates that client is not requesting an initial


configuration upload. This will be used to signify the server
that it is now permitted to send configuration update messages
when the client does not want the initial update. What updates
are received depend upon the ConfigInfoMask.
If a configuration is requested and updates were requested in
the OPEN_REQ, updates will begin after the entire
configuration is uploaded and a CONFIG_END_EVENT is
received. Please note that the configuration requested here and
the ConfigInfoMask in the OPEN_REQ are allowed to be
different. (i.e. send me the entire initial configuration but just
send me agent updates)

PeripheralID Peripheral ID of ACD for which configuration keys are UINT 4


required.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
230
Application Level Interfaces
CONFIG_BEGIN_EVENT

Floating Part

Field Name Value Data Type Max. Size

CustomerID Currently not used in UCCE. UINT 4

CONFIG_BEGIN_EVENT
The CONFIG_BEGIN_EVENT signifies the beginning of configuration data (all of the same key) from the
CTI Server.

Table 165: CONFIG_BEGIN_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 233. MHDR 8

ConfigType 0 = Unused USHORT 2


1 = Solicited
2 = Unsolicited (update)

ConfigInformation Bit mask indicating what type of information is UINT 4


included.
1=Service Information
2=Skill Group Information
4=Agent Information
8=Device Information
16=Call Type Information
32=Media Routing Domain Information

Floating Part

Field Name Value Data Type Max. Size

ServiceConfigKey The CTI Server configuration key for Services. UNSPEC 8


(8)

SkillGroupConfigKey The CTI Server configuration key for Skill Groups. UNSPEC 8
(8)

AgentConfigKey The CTI Server configuration key for Agents. UNSPEC 8


(8)

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
231
Application Level Interfaces
CONFIG_SERVICE_EVENT

DeviceConfigKey The CTI Server configuration key for Device UNSPEC 8


(8)
Information.

CallTypeConfi The CTI Server configuration key for Call Type Information. UNSPEC 8
Key (8)

CONFIG_SERVICE_EVENT
The CONFIG_SERVICE_EVENT message will be sent by the CTI Server to provide information about a
Service. Please note that the Peripheral Number field is considered unique for all records. Two records sent
with matching Peripheral Numbers will be the considered the same record.

Table 166: CONFIG_SERVICE_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message MHDR 8


header. MessageType
= 235.

NumRecords The number of USHORT 2


records contained in
the floating part of
this message. (>=1)
(The entire floating
portion) (Maximum
of 10)

Floating Part

Field Name Value Data Type Max. Size

RecordType 0=Add USHORT 2


1=Change
2=Delete

FltPeripheralID Specifies the UINT 4


PeripheralID of this
record.

PeripheralNumber The Peripheral ID of UINT 4


the Service.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
232
Application Level Interfaces
CONFIG_SERVICE_EVENT

OldPeripheralNumber For a change request UINT 4


this field may be
present and should
reflect the Old
Peripheral Number of
the record to be
changed. This allows
the Peripheral
Number to be
changed on an
existing record.

MaxQueued The maximum UINT 4


number of calls
allowed to be queued
for this Service.

Extension Extension of the STRING 16


Service if it is dialable
on the CTI Server.

ServiceSkillTargetID SkillTargetID of the UINT 4


Service.

PeripheralName Name of the Service STRING 64


on the peripheral.

Description A free form STRING 128


description of the
Service.

ServiceLevelThreshold The Service Level UINT 4


threshold in seconds.

ServiceLevelType The type of Service UINT 4


Level.

ConfigParam Configuration STRING 255


Parameter.

FltMRDomainID Media Routing UINT 4


Domain ID associated
with the Service.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
233
Application Level Interfaces
CONFIG_SKILL_GROUP_EVENT

NumServiceMembers Number of elements USHORT 2


in the ServiceMember
and ServicePriority
arrays for each
CONFIG_SERVICE_CONFIG
record. This field has
a maximum value of
10.

ServiceMember Peripheral Number of UNIT[NumServiceMembers] 4*


a SkillGroup that is a NumServiceMembers
member of the
Service. It is an Array
with the size provided
in the
NumServiceMembers.

ServicePriority Priority of each USHORT[NumServiceMembers] 2*


service members. It is NumServiceMembers
an Array with the size
provided in the
NumServiceMembers.

CONFIG_SKILL_GROUP_EVENT
The CONFIG_SKILL_GROUP_EVENT message will be sent to indicate a Skill Group configuration update.
Please note that the Peripheral Number field is considered unique for all records. Two records sent with
matching Peripheral Numbers will be the considered the same record.

Table 167: CONFIG_SKILL_GROUP_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = MHDR 8


236.

NumRecords The number of records included in the USHORT 2


floating part of this message. (>=1 ) (The
entire floating portion) (Maximum of 10)

Floating Part

Field Name Value Data Type Max. Size

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
234
Application Level Interfaces
CONFIG_AGENT_EVENT

RecordType 0=Add USHORT 2


1=Change
2=Delete

FltPeripheralID Specifies the PeripheralID of this record. UINT 4

PeripheralNumber The Peripheral Number of the Skill Group. UINT 4

OldPeripheralNumber For a change request this field may be UINT 4


present and should reflect the Old
Peripheral Number of the record to be
changed. This allows the Peripheral
Number to be changed on an existing
record.

FltSkillGroupPriority Priority of this Skill Group. USHORT 2 * NumSkills


(Optional) (0) for UCCE

SkillGroupSkillTargetID SkillTargetID of the skill. UINT 4

AutoWork TRUE if the agent goes into work mode BOOL 2


after handling a call from this Skill Group.
FALSE if not present.

Extension Extension of the Skill Group if it is dialable STRING 16


on the CTI Server.

PeripheralName Name of the Skill Group on the peripheral. STRING 64

Description A free form description of the Skill Group. STRING 128

FltMRDomainID Media Routing Domain ID associated with UINT 4


the Skill Group.

ConfigParam Configuration Parameter. STRING 255

CONFIG_AGENT_EVENT
The CONFIG_AGENT_EVENT message is sent by the CTI Server to provide information about Agent.
Please note that the LoginID field is considered unique for all records. Two records sent with matching
LoginID’s are considered as the same record.

Table 168: CONFIG_AGENT_EVENT Message Format

Fixed Part

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
235
Application Level Interfaces
CONFIG_AGENT_EVENT

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType MHDR 8


= 237.

NumRecords The number of records contained in the USHORT 2


floating part of this message. (>=1) (The
entire floating portion) (Maximum of
10)

Floating Part

Field Name Value Data Type Max. Size

RecordType 0=Add USHORT 2


1=Change
2=Delete

FltPeripheralID Specifies the PeripheralID of this UINT 4


record.

AgentType 1=Agent USHORT 2


2=Supervisor

LoginID The LoginID/Agent Peripheral Number STRING 64


of the agent.

OldLoginID For a change request, this field may be STRING 64


present and should reflect the Old
Peripheral Number or Login ID of the
record to be changed.
This allows the Peripheral Number to
be changed from an existing record.

LoginName The Login Name of the agent. (Can be STRING 255


different from the Agent Peripheral
Number)
For clients using a protocol version
earlier than version 20, LoginName is
truncated to 32 Bytes.

LastName The Last name of the agent. STRING 32

FirstName The First name of the agent. STRING 32

Extension The Extension of the agent. STRING 16

Description A free form description of the agent. STRING 128

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
236
Application Level Interfaces
CONFIG_AGENT_EVENT

AgentSkillTargetID The ICM SkillTargetID of this agent. UINT 4

NumSkills Number of elements in the USHORT 2


FltSkillGroupNumber and
FltSkillGroupPriority arrays for each
CONFIG_AGENT_EVENT record.
This field has a maximum value of 100.

SSOEnabled The agent's UCCE SSO configuration: USHORT 2


• 0 = SSO disabled
• 1 = SSO enabled

NumMRDs Number of elements in the USHORT 2


FltAgentMRDID and
FltAgentMRDState arrays for each
CONFIG_AGENT_EVENT record.
This field has a maximum value of 40.

FltSkillGroupNumber All the SkillGroups Numbers that Agent UINT[NumSkills] 4*


belongs. It is an Array with the size NumSkills
provided in the NumSkills.

FltSkillGroupPriority All the SkillGroup priorities of the USHORT[NumSkills] 2*


Agent. It is an Array with the size NumSkills
provided in the NumSkills. For UCCE,
FltSkillGroupPriority is always 0.

FltAgentMRDID All the Media Routing Domains that UINT[NumMRDs] 4*


Agent currently logged in. It is an Array NumMRDs
with size provided in the NumMRDs.

FltAgentMRDState The overall Agent state of each Media USHORT[NumMRDs] 2*


Routing Domain that Agent logged in. NumMRDs
It is an Array with size provided in the
NumMRDs.

Note The CONFIG_AGENT_EVENT sends MRD information only for baseline configurations. Configuration
updates will not have MRD information.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
237
Application Level Interfaces
CONFIG_DEVICE_EVENT

CONFIG_DEVICE_EVENT
The CONFIG_DEVICE_EVENT message will be sent by the CTI Server to indicate an update to some device
configuration. Devices are associated with all entities like Services, Skill Groups, Agent Phones, Route Points
and CTI ports etc. For these devices, CONFIG_DEVICE_EVENT message will be sent.

Table 169: CONFIG_DEVICE_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 238. MHDR 8

NumRecords The number of records contained in the floating part of this USHORT 2
message. (>=1) (The entire floating portion) (Maximum of
10)

Floating Part

Field Name Value Data Type Max. Size

RecordType 0=Add USHORT 2


1=Change
2=Delete

FltPeripheralID Specifies the PeripheralID of this record. UINT 4

PeripheralNumber The Peripheral Number (or ID) of this Device. UINT 4

DeviceType Specifies the Device Type USHORT 2


0=Unknown
1=Service
2=Skill Group
3=Agent ID
4=Agent Device Extension
5=Route Point
6=CTI Port
7=Call Control Group

MaxQueued The maximum number of calls allowed to be queued to this UINT 4


Device.

FltServiceID The Service this entry is associated with. (if any) UINT 4

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
238
Application Level Interfaces
CONFIG_CALL_TYPE_EVENT

DialedNumber The number dialed. STRING 40

DNIS DNIS provided with the call. STRING 32

Extension The extension of this Device. (if any) STRING 16

Description A free form description of the Device. STRING 128

CONFIG_CALL_TYPE_EVENT
The CONFIG_CALL_TYPE_EVENT message will be sent by the CTI Server to provide information about
a call type. Please note that the CallTypeID field is considered unique for all records. Two records sent with
matching CallTypeIDs will be the considered the same record.

Table 170: CONFIG_CALL_TYPE_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 245. MHDR 8

NumRecords The number of records contained in the floating USHORT 2


part of this message. (>=1) (The entire floating
portion) (Maximum of 10)

Floating Part

Field Name Value Data Type Max. Size

RecordType 0=Add USHORT 2


1=Change
2=Delete

FltCallTypeID The unique Call Type Identifier. UINT 4

CustomerDefinitionID 0 (not used for UCCE) UINT 4

EnterpriseName The name for the Call Type. STRING 32

Description A free form description of the Call Type. STRING 128

ServiceLevelThreshold The Service Level threshold in seconds. UINT 4

ServiceLevelType The type of Service Level. UINT 4

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
239
Application Level Interfaces
CONFIG_MRD_EVENT

CONFIG_MRD_EVENT
The CONFIG_MRD_EVENT will be sent by the CTI Server to provide infomration about a Media Routing
Domain. Please note that the MRDomainID field is considered unique for all records. Two records sent with
matching MRDomainIDs will be the considered the same record.

Table 171: CONFIG_MRD_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 245. MHDR 8

NumRecords The number of records contained in the floating part of this USHORT 2
message. (>=1) (The entire floating portion) (Maximum of
10)

Floating Part

Field Name Value Data Type Max. Size

RecordType 0=Add USHORT 2


1=Change
2=Delete

FltMRDomainID The unique Media Routng DomainIdentifier. UINT 4

FltEnterpriseName The name for the MediaRouting Domain. STRING 32

FltDescription A free form description of the Media Routing Domain. STRING 128

FltMaxTaskDuration The maxiumum duration for a task, in seconds. UINT 4

FltInterruptible Indicates whether tasks assigned from another MRD can BOOL 2
interrupt an agent.

CONFIG_END_EVENT
The CONFIG_END_EVENT message will be sent by the CTI Server to indicate the end of a successful
configuration upload or an error condition. It most likely will follow configuration records preceded by a
CONFIG_BEGIN_EVENT message to respond to a CONFIG_REQUEST_EVENT message indicating either
an error or there is no configuration for the items requested.
Please note that status CONFIGEND_PARTIAL is used during the initial configuration upload if the server
needs to break up the configuration into multiple CONFIG_BEGIN_EVENT/CONFIG_END_EVENT

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
240
Application Level Interfaces
CONFIG_END_EVENT

messages. In this case all but the last should be CONFIGEND_PARTIAL status. The reason for this is to let
the client know when the entire configuration has been received.

Table 172: CONFIG_END_EVENT Message Format

Fixed Part

Field Name Value Data Type Byte Size

MessageHeader Standard message header. MessageType = 234. MHDR 8

ConfigEndStatus Indicates the status of the configuration block. UINT 4


See .

Floating Part

Field Name Value Data Type Max. Size

Text Optional Text describing errors or info. STRING 255

Table 173: CONFIG_END_EVENT Status values

Status Value Value Meaning

CONFIGEND_SUCCESS 0 Successful upload of configuration data.

CONFIGEND_NO_SERVICE_PROVIDER 1 No data was sent due to a service provider


environment.

CONFIGEND_UNKNOWN_CUSTOMER 2 An unknown customer was specified in the


request.

CONFIGEND_INVALID 3 An invalid configuration was sent.

CONFIGEND_EMPTY 4 No configuration exists on the CTI Server.

CONFIGEND_PARTIAL 5 Partial configuration was sent.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
241
Application Level Interfaces
CONFIG_END_EVENT

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
242
CHAPTER 6
Constants and Status Codes
• In this chapter, page 244
• Failure Indication Message Status Codes, page 244
• SystemEventID Values, page 250
• Special Values, page 251
• Tag Values, page 252
• AgentState Values, page 265
• PGStatusCode Values, page 266
• PeripheralType Values, page 267
• LocalConnectionState Values, page 268
• EventCause Values, page 269
• DeviceIDType Values, page 274
• CallType Values, page 275
• ConnectionDeviceIDType Values, page 277
• LineType Values, page 278
• ControlFailureCode Values, page 278
• AllocationState Values, page 285
• ForwardType Values, page 285
• TypeOfDevice Values, page 286
• ClassOfDevice Values, page 287
• CallPlacementType Values, page 287
• CallMannerType Values, page 288
• CallOption Values, page 288
• ConsultType Values, page 289
• FacilityType Values, page 289

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
243
Constants and Status Codes
In this chapter

• AnsweringMachine Values, page 290


• AnswerDetectMode Values, page 290
• AgentWorkMode Values, page 291
• DestinationCountry Values, page 291
• CTI Service Masks, page 291
• Disposition Code Values, page 293
• Agent Service Request Masks, page 296
• Silent Monitor Status Values, page 296
• Agent Internal States Message Values, page 296
• TaskState Values, page 297

In this chapter
This section lists the possible values for various status codes and fields that can appear in CTI Server messages.
These values are defined in the CTILink.h file, located in the \icm\include directory.

Failure Indication Message Status Codes


This table shows the status codes that may be included in the FAILURE_CONF and FAILURE_EVENT
messages.
Status Codes

Status Code Description Value


E_CTI_NO_ERROR No error occurred. 0

E_CTI_INVALID_ VERSION The CTI Server does not support the protocol 1
version number requested by the CTI client.

E_CTI_INVALID_ MESSAGE_ TYPE A message with an invalid message type field 2


was received.

E_CTI_INVALID_ FIELD_TAG A message with an invalid floating field tag 3


was received.

E_CTI_SESSION_ NOT_OPEN No session is currently open on the connection. 4

E_CTI_SESSION_ ALREADY_ OPEN A session is already open on the connection. 5

E_CTI_REQUIRED_ DATA_ MISSING The request did not include one or more 6
floating items that are required.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
244
Constants and Status Codes
Failure Indication Message Status Codes

Status Code Description Value


E_CTI_INVALID_ PERIPHERAL_ID A message with an invalid PeripheralID value 7
was received.

E_CTI_INVALID_ AGENT_ DATA The provided agent data item(s) are invalid. 8

E_CTI_AGENT_NOT_ LOGGED_ON The indicated agent is not currently logged on. 9

E_CTI_DEVICE_IN_ USE The indicated agent teleset is already associated 10


with a different CTI client.

E_CTI_NEW_ SESSION_ OPENED This session is being terminated due to a new 11


session open request from the client.

E_CTI_FUNCTION_ NOT_ AVAILABLE A request message was received for a function 12


or service that was not granted to the client.

E_CTI_INVALID_ CALLID A request message was received with an invalid 13


CallID value.

E_CTI_PROTECTED_ VARIABLE The CTI client may not update the requested 14
variable.

E_CTI_CTI_SERVER_ OFFLINE The CTI Server is not able to function 15


normally. The CTI client should close the
session upon receipt of this error.

E_CTI_TIMEOUT The CTI Server failed to respond to a request 16


message within the time-out period, or no
messages have been received from the CTI
client within the IdleTimeout period.

E_CTI_UNSPECIFIED_FAILURE An unspecified error occurred. 17

E_CTI_INVALID_ TIMEOUT The IdleTimeout field contains a value that is 18


less than 20 seconds (4 times the minimum
heartbeat interval of 5 seconds).

E_CTI_INVALID_ SERVICE_MASK The ServicesRequested field has unused bits 19


set. All unused bit positions must be zero.

E_CTI_INVALID_ CALL_MSG_MASK The CallMsgMask field has unused bits set. 20


All unused bit positions must be zero.

E_CTI_INVALID_ AGENT_ STATE_ MASK The AgentStateMask field has unused bits set. 21
All unused bit positions must be zero.

E_CTI_INVALID_ RESERVED_ FIELD A Reserved field has a non-zero value. 22

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
245
Constants and Status Codes
Failure Indication Message Status Codes

Status Code Description Value


E_CTI_INVALID_ FIELD_ LENGTH A floating field exceeds the allowable length 23
for that field type.

E_CTI_INVALID_ DIGITS A STRING field contains characters that are 24


not digits (“0” through “9”).

E_CTI_BAD_ MESSAGE_ FORMAT The message is improperly constructed. This 25


may be caused by omitted or incorrectly sized
fixed message fields.

E_CTI_INVALID_ TAG_FOR_MSG_ TYPE A floating field tag is present that specifies a 26


field that does not belong in this message type.

E_CTI_INVALID_ DEVICE_ID_ TYPE A DeviceIDType field contains a value that is 27


not in DeviceIDType Values, on page 274.

E_CTI_INVALID_ LCL_CONN_ STATE A LocalConnectionState field contains a value 28


that is not in LocalConnectionState Values,
on page 268.

E_CTI_INVALID_ EVENT_ CAUSE An EventCause field contains a value that is 29


not in EventCause Values, on page 269.

E_CTI_INVALID_ NUM_ PARTIES The NumParties field contains a value that 30


exceeds the maximum (16).

E_CTI_INVALID_ SYS_ EVENT_ID The SystemEventID field contains a value that 31


is not in SystemEventID Values, on page 250.

E_CTI_ INCONSISTENT_ AGENT_DATA The provided agent extension, agent id, and/or 32
agent instrument values are inconsistent with
each other.

E_CTI_INVALID_ CONNECTION_ID_ TYPE A ConnectionDeviceIDType field contains a 33


value that is not in ConnectionDeviceIDType
Values, on page 277.

E_CTI_INVALID_ CALL_TYPE The CallType field contains a value that is not 34


in CallType Values, on page 275.

E_CTI_NOT_CALL_ PARTY A CallDataUpdate or Release Call request 35


specified a call that the client is not a party to.

E_CTI_INVALID_ PASSWORD The ClientID and Client Password provided in 36


an OPEN_REQ message is incorrect.

E_CTI_CLIENT_ DISCONNECTED The client TCP/IP connection was disconnected 37


without a CLOSE_REQ.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
246
Constants and Status Codes
Failure Indication Message Status Codes

Status Code Description Value


E_CTI_INVALID_ OBJECT_ STATE An invalid object state value was provided. 38

E_CTI_INVALID_ NUM_ SKILL_GROUPS An invalid NumSkillGroups value was 39


provided.

E_CTI_INVALID_ NUM_LINES An invalid NumLines value was provided. 40

E_CTI_INVALID_ LINE_TYPE An invalid LineType value was provided. 41

E_CTI_INVALID_ ALLOCATION_STATE An invalid AllocationState value was provided. 42

E_CTI_INVALID_ ANSWERING_ MACHINE An invalid AnsweringMachine value was 43


provided.

E_CTI_INVALID_ CALL_MANNER_ TYPE An invalid CallMannerType value was 44


provided.

E_CTI_INVALID_ CALL_PLACEMENT_ TYPE An invalid CallPlacementType value was 45


provided.

E_CTI_INVALID_ CONSULT_ TYPE An invalid ConsultType value was provided. 46

E_CTI_INVALID_ FACILITY_ TYPE An invalid FacilityType value was provided. 47

E_CTI_INVALID_ MSG_TYPE_ FOR_ The provided MessageType is invalid for the 48


VERSION opened protocol version.

E_CTI_INVALID_ TAG_FOR_ VERSION A floating field tag value is invalid for the 49
opened protocol version.

E_CTI_INVALID_ AGENT_WORK_ MODE An invalid AgentWorkMode value was 50


provided.

E_CTI_INVALID_ CALL_OPTION An invalid call option value was provided. 51

E_CTI_INVALID_ DESTINATION_ COUNTRY An invalid destination country value was 52


provided.

E_CTI_INVALID_ ANSWER_DETECT_ MODE An invalid answer detect mode value was 53


provided.

E_CTI_MUTUALLY_ EXCLUS_DEVICEID_ A peripheral monitor request may not specify 54


TYPES both a call and a device.

E_CTI_INVALID_ MONITORID An invalid monitorID value was provided. 55

E_CTI_SESSION_ MONITOR_ A requested session monitor was already 56


ALREADY_EXISTS created.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
247
Constants and Status Codes
Failure Indication Message Status Codes

Status Code Description Value


E_CTI_SESSION_ MONITOR_IS_ CLIENTS A client may not monitor its own session. 57

E_CTI_INVALID_ CALL_CONTROL_ MASK An invalid call control mask value was 58


provided.

E_CTI_INVALID_ FEATURE_MASK An invalid feature mask value was provided. 59

E_CTI_INVALID_ TRANSFER_ An invalid transfer conference setup mask 60


CONFERENCE_ SETUP_MASK value was provided.

E_CTI_INVALID_ ARRAY_INDEX An invalid named array index value was 61


provided.

E_CTI_INVALID_ CHARACTER An invalid character value was provided. 62

E_CTI_CLIENT_NOT_FOUND There is no open session with a matching 63


ClientID.

E_CTI_SUPERVISOR_NOT_FOUND The agent’s supervisor is unknown or does not 64


have an open CTI session.

E_CTI_TEAM_NOT_ FOUND The agent is not a member of an agent team. 65

E_CTI_NO_CALL_ ACTIVE The specified agent does not have an active 66


call.

E_CTI_NAMED_ VARIABLE_NOT_ The specified named variable is not configured 67


CONFIGURED in the Unified CCE.

E_CTI_NAMED_ ARRAY_NOT_ The specified named array is not configured in 68


CONFIGURED the Unified CCE.

E_CTI_INVALID_ CALL_VARIABLE_ MASK The specified call variable mask in not valid. 69

E_CTI_ELEMENT_ NOT_FOUND An internal error occurred manipulating a 70


named variable or named array element.

E_CTI_INVALID_ DISTRIBUTION_TYPE The specified distribution type is invalid. 71

E_CTI_INVALID_ SKILL_GROUP The specified skill group is invalid. 72

E_CTI_TOO_MUCH_ DATA The total combined size of named variables 73


and named arrays may not exceed the limit of
2000 bytes.

E_CTI_VALUE_TOO_LONG The value of the specified named variable or 74


named array element exceeds the maximum
permissible length.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
248
Constants and Status Codes
Failure Indication Message Status Codes

Status Code Description Value


E_CTI_SCALAR_ FUNCTION_ON_ ARRAY A NamedArray was specified with a 75
NamedVariable tag.

E_CTI_ARRAY_ FUNCTION_ON_ SCALAR A NamedVariable was specified with a 76


NamedArray tag.

E_CTI_INVALID_ NUM_NAMED_ The value in the NumNamedVariables field is 77


VARIABLES different than the number of NamedVariable
floating fields in the message.

E_CTI_INVALID_ NUM_NAMED_ ARRAYS The value in the NumNamedArrays field is 78


different than the number of NamedArray
floating fields in the message.

E_CTI_INVALID_RTP_DIRECTION The RTP direction value is invalid. 79

E_CTI_INVALID_RTP_TYPE The RTP type value is invalid. 80

E_CTI_CALLED_ PARTY_DISPOSITION The called party disposition is invalid. 81

E_CTI_INVALID_ SUPERVISORY_ ACTION The supervisory action is invalid. 82

E_CTI_AGENT_ TEAM_MONITOR_ The agent team monitor already exists. 83


ALREADY_EXISTS

E_CTI_INVALID_ SERVICE The ServiceNumber or ServiceID value is 84


invalid.

E_CTI_SERVICE_ CONFLICT The ServiceNumber and ServiceID values 85


given represent different services.

E_CTI_SKILL_ GROUP_CONFLICT The SkillGroupNumber/SkillGroupPriority and 86


SkillGroupID values given represent different
skill groups.

E_CTI_INVALID_ DEVICE The specified device is invalid. 87

E_CTI_INVALID_MR_DOMAIN Media Routing Domain is invalid. 88

E_CTI_MONITOR_ ALREADY_EXISTS Monitor already exists. 89

E_CTI_MONITOR_ TERMINATED Monitor has terminated. 90

E_CTI_INVALID_ TASK_MSG_MASK The task msg mask is invalid. 91

E_CTI_SERVER_NOT_MASTER The server is a standby server. 92

E_CTI_INVALID_CSD The CSD Specified is invalid (Unified CCX 93


Only).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
249
Constants and Status Codes
SystemEventID Values

Status Code Description Value


E_CTI_JTAPI_CCM_ PROBLEM Indicates a JTAPI or Unified CM problem. 94

E_INVALID_CONFIG_ MSG_MASK Indicates a bad config mask in OPEN_REQ. 95

E_CTI_AUTO_ CONFIG_RESET Indicates a configuration change (Unified CCX 96


only).

E_CTI_INVALID_ MONITOR_STATUS Indicates an invalid monitor. 97

E_CTI_INVALID_ REQUEST_TYPE Indicates an invalid request ID type. 98

SystemEventID Values
This table shows the SystemEventID values that may be included in the SYSTEM_EVENT messages.

Table 174: SystemEventID Values

SystemEventID Description Value


SYS_CENTRAL_ CONTROLLER_ONLINE The PG has resumed communication with the 1
Unified CCE Central Controller.

SYS_CENTRAL_ CONTROLLER_OFFLINE The PG is unable to communicate with the 2


Unified CCE Central Controller.

SYS_PERIPHERAL_ ONLINE A peripheral monitored by the PG has gone 3


online. SystemEventArg1 contains the
PeripheralID of the peripheral.

SYS_PERIPHERAL_ OFFLINE A peripheral monitored by the PG has gone 4


offline. SystemEventArg1 contains the
PeripheralID of the peripheral.

SYS_TEXT_FYI Broadcast of informational “text” floating field. 5

SYS_PERIPHERAL_ GATEWAY_OFFLINE The CTI Server is unable to communicate with 6


the Unified CCE Peripheral Gateway.

SYS_CTI_SERVER_ OFFLINE The local software component is unable to 7


communicate with the CTI Server.

SYS_CTI_SERVER_ ONLINE The local software component has resumed 8


communication with the CTI Server.

SYS_HALF_HOUR_ CHANGE The Unified CCE Central Controller time has 9


changed to a new half hour.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
250
Constants and Status Codes
Special Values

SystemEventID Description Value


SYS_INSTRUMENT_ OUT_OF_SERVICE An Enterprise Agent device target has been 10
removed from service. SystemEventArg1
contains the PeripheralID of the peripheral, and
SystemEventText contains the AgentInstrument
that was removed from service.

SYS_INSTRUMENT_ BACK_IN_SERVICE An Enterprise Agent device target has been 11


returned to service. SystemEventArg1 contains
the PeripheralID of the peripheral, and
SystemEventText contains the AgentInstrument
that was returned to service.

Special Values
This table shows the values used to define sizes and limits, indicate special IDs, and unspecified data elements.

Table 175: Special Values

Constant Description Value


MAX_NUM_CTI_ CLIENTS The maximum number of CTI clients that can be in 16
a message list.

MAX_NUM_ PARTIES The maximum number of conference call parties that 16


can be in a message list.

MAX_NUM_ DEVICES The maximum number of call devices that can be in 16


a message list.

MAX_NUM_ CALLS The maximum number of calls that can be in a 16


message list.

MAX_NUM_ SKILL_GROUPS The maximum number of skill group fields that can 20
be in a message list.

MAX_NUM_LINES The maximum number of teleset line fields that can 10


be in a message list.

NULL_ CALL_ID No call ID is supplied. 0xFFFFFFFF

NULL_ PERIPHERAL_ID No peripheral ID is supplied. 0xFFFFFFFF

NULL_SERVICE No service is supplied. 0xFFFFFFFF

NULL_SKILL_ GROUP No skill group is supplied. 0xFFFFFFFF

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
251
Constants and Status Codes
Tag Values

Constant Description Value


NULL_CALLTYPE Indicates that no CallType is supplied. 0xFFFF

Tag Values
This table shows the values used in the tag subfield of floating fields.

Table 176: Tag Values

Floating Field Tag Using Messages Value


CLIENT_ID_TAG OPEN_REQ 1

CLIENT_PASSWORD_ TAG OPEN_REQ 2

CLIENT_SIGNATURE_ TAG OPEN_REQ, AGENT_STATE_EVENT 3

AGENT_EXTENSION_ TAG OPEN_REQ, OPEN_CONF, 4


AGENT_STATE_EVENT

AGENT_ID_TAG OPEN_REQ, OPEN_CONF, 5


AGENT_STATE_EVENT,
SET_AGENT_STATE_EVENT

AGENT_ INSTRUMENT_ TAG OPEN_REQ, OPEN_CONF, 6


AGENT_STATE_EVENT,
QUERY_AGENT_STATE_REQ,
SET_AGENT_STATE_REQ,
MAKE_CALL_REQ

TEXT_TAG SYSTEM_EVENT, 7
CLIENT_EVENT_REPORT_REQ

ANI_TAG BEGIN_CALL_EVENT, CALL_ 8


DATA_UPDATE_EVENT, CALL_
TRANSLATION_ROUTE_EVENT,
SNAPSHOT_CALL_ CONF

UUI_TAG BEGIN_CALL_EVENT, 9
CALL_DATA_UPDATE_EVENT,
CALL_TRANSLATION_ROUTE_ EVENT,
CONSULTATION_ CALL_REQ,
MAKE_CALL_REQ,
TRANSFER_CALL_REQ,
SNAPSHOT_CALL_CONF

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
252
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


DNIS_TAG BEGIN_CALL_EVENT, CALL_ 10
DATA_UPDATE_EVENT, CALL_
TRANSLATION_ROUTE_ EVENT,
SNAPSHOT_CALL_ CONF

DIALED_NUMBER_ TAG BEGIN_CALL_EVENT, 11


CALL_DATA_UPDATE_EVENT,
CALL_TRANSLATION_ROUTE_ EVENT,
CONSULTATION_ CALL_ REQ,
MAKE_CALL_REQ,
TRANSFER_CALL_REQ,
SNAPSHOT_CALL_CONF

CED_TAG BEGIN_CALL_EVENT, CALL_ 12


DATA_UPDATE_EVENT, CALL_
TRANSLATION_ROUTE_ EVENT,
SNAPSHOT_CALL_ CONF

CALL_VAR_1_TAG through BEGIN_CALL_EVENT, 13-22


CALL_VAR_10_TAG CALL_DATA_UPDATE_EVENT,
CALL_TRANSLATION_ROUTE_ EVENT,
CONSULTATION_ CALL_REQ,
MAKE_CALL_REQ,
TRANSFER_CALL_REQ,
SNAPSHOT_CALL_CONF,
SNAPSHOT_TASK_RESP

CTI_CLIENT_ SIGNATURE_TAG BEGIN_CALL_EVENT, 23


CALL_DATA_UPDATE_EVENT,
SNAPSHOT_CALL_CONF

CTI_CLIENT_ TIMESTAMP_TAG BEGIN_CALL_EVENT, 24


CALL_DATA_UPDATE_EVENT,
SNAPSHOT_CALL_CONF

CONNECTION_ DEVID_ TAG Any CALL EVENT message, most CLIENT 25


CONTROL messages.

ALERTING_DEVID_ TAG CALL_DELIVERED_EVENT 26

CALLING_DEVID_TAG CALL_DELIVERED_EVENT, 27
CALL_ESTABLISHED_EVENT,
CALL_ORIGINATED_EVENT,
CALL_SERVICE_INITIATED_EVENT,
CALL_QUEUED_EVENT,
SET_DEVICE_ATTRIBUTES_REQ

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
253
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


CALLED_DEVID_TAG CALL_DELIVERED_EVENT, 28
CALL_ESTABLISHED_EVENT,
CALL_ORIGINATED_EVENT,
CALL_QUEUED_EVENT,

LAST_REDIRECT_ DEVID_TAG CALL_DELIVERED_EVENT, 29


CALL_ESTABLISHED_EVENT,
CALL_QUEUED_EVENT

ANSWERING_DEVID_ TAG CALL_ESTABLISHED_EVENT 30

HOLDING_DEVID_ TAG CALL_HELD_EVENT 31

RETRIEVING_DEVID_ TAG CALL_RETRIEVED_EVENT 32

RELEASING_DEVID_ TAG CALL_CONNECTION_ CLEARED_EVENT 33

FAILING_DEVID_TAG CALL_FAILED_EVENT 34

PRIMARY_DEVID_ TAG CALL_CONFERENCED_EVENT, 35


CALL_TRANSFERRED_EVENT

SECONDARY_DEVID_ TAG CALL_CONFERENCED_EVENT, 36


CALL_TRANSFERRED_EVENT

CONTROLLER_ DEVID_ TAG CALL_CONFERENCED_EVENT 37

ADDED_PARTY_ DEVID_TAG CALL_CONFERENCED_EVENT 38

PARTY_CALLID_TAG CALL_CONFERENCED_EVENT, 39
CALL_TRANSFERRED_EVENT,
CONFERENCE_CALL_CONF,
TRANSFER_CALL_CONF

PARTY_DEVID_TYPE_ TAG CALL_CONFERENCED_EVENT, 40


CALL_TRANSFERRED_EVENT,
CONFERENCE_CALL_CONF,
TRANSFER_CALL_CONF

PARTY_DEVID_TAG CALL_CONFERENCED_EVENT, 41
CALL_TRANSFERRED_EVENT,
CONFERENCE_CALL_CONF,
TRANSFER_CALL_CONF

TRANSFERRING_ DEVID_TAG CALL_TRANSFERRED_EVENT 42

TRANSFERRED_ DEVID_TAG CALL_TRANSFERRED_EVENT 43

DIVERTING_DEVID_ TAG CALL_DIVERTED_EVENT 44

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
254
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


QUEUE_DEVID_TAG CALL_QUEUED_EVENT 45

CALL_WRAPUP_ DATA_ TAG BEGIN_CALL_EVENT, 46


CALL_DATA_UPDATE_EVENT,
SET_CALL_DATA_REQ,
CONSULTATION_CALL_REQ,
MAKE_CALL_REQ,
TRANSFER_CALL_REQ,
SNAPSHOT_CALL_CONF

NEW_CONNECTION_ DEVID_TAG CALL_DATA_UPDATE_EVENT, 47


CONFERENCE_CALL_CONF,
CONSULTATION_CALL_CONF,
MAKE_CALL_CONF,
TRANSFER_CALL_CONF

TRUNK_USED_ DEVID_ TAG CALL_REACHED_NETWORK_ EVENT 48

AGENT_PASSWORD_ TAG SET_AGENT_STATE_REQ 49

ACTIVE_CONN_ DEVID_ TAG ALTERNATE_CALL_REQ, 50


CONFERENCE_CALL_REQ,
CONSULTATION_CALL_REQ,
RECONNECT_CALL_REQ,
TRANSFER_CALL_REQ

FACILITY_CODE_TAG CONSULTATION_CALL_REQ, 51
MAKE_CALL_REQ,
TRANSFER_CALL_REQ

OTHER_CONN_ DEVID_ TAG ALTERNATE_CALL_REQ 52

HELD_CONN_DEVID_ TAG CONFERENCE_CALL_REQ, 53


RECONNECT_CALL_REQ,
RETRIEVE_CALL_REQ,
TRANSFER_CALL_REQ

(reserved) 54-55

CALL_CONN_ CALLID_ TAG SNAPSHOT_CALL_CONF, 56


SNAPSHOT_DEVICE_CONF

CALL_CONN_DEVID_ TYPE_TAG SNAPSHOT_CALL_CONF, 57


SNAPSHOT_DEVICE_CONF

CALL_CONN_DEVID_ TAG SNAPSHOT_CALL_CONF, 58


SNAPSHOT_DEVICE_CONF

CALL_DEVID_TYPE_ TAG SNAPSHOT_CALL_CONF 59

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
255
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


CALL_DEVID_TAG SNAPSHOT_CALL_CONF 60

CALL_DEV_CONN_ STATE_TAG SNAPSHOT_CALL_CONF 61

SKILL_GROUP_ NUMBER_TAG CALL_QUEUED_EVENT, 62


CALL_DEQUEUED_EVENT,
QUERY_AGENT_STATE_CONF

SKILL_GROUP_ID_ TAG CALL_QUEUED_EVENT, 63


CALL_DEQUEUED_EVENT,
QUERY_AGENT_STATE_CONF

SKILL_GROUP_ PRIORITY_TAG CALL_QUEUED_EVENT, 64


CALL_DEQUEUED_EVENT,
QUERY_AGENT_STATE_CONF

SKILL_GROUP_ STATE_ TAG QUERY_AGENT_STATE_CONF 65

OBJECT_NAME_TAG CLIENT_EVENT_REPORT 66

DTMF_STRING_TAG SEND_DTMF_SIGNAL_REQ 67

POSITION_ID_TAG SET_AGENT_STATE_REQ 68

SUPERVISOR_ID_TAG SET_AGENT_STATE_REQ 69

LINE_HANDLE_TAG QUERY_DEVICE_INFO_CONF 70

LINE_TYPE_TAG QUERY_DEVICE_INFO_CONF 71

ROUTER_CALL_KEY_ DAY_TAG BEGIN_CALL_EVENT, CALL_ 72


DATA_UPDATE_EVENT, CALL_
TRANSLATION_ROUTE_EVENT,
SNAPSHOT_CALL_ CONF

ROUTER_CALL_KEY_ CALLID_TAG BEGIN_CALL_EVENT, CALL_ 73


DATA_UPDATE_EVENT, CALL_
TRANSLATION_ROUTE_EVENT,
SNAPSHOT_CALL_ CONF

ROUTER_CALL_KEY_SEQUENCE_NUM_TAG AGENT_LEGACY_PRE_CALL_EVENT, 110


BEGIN_CALL_EVENT,
CALL_DATA_UPDATE_EVENT,
CALL_TRANSLATION_ROUTE_EVENT,
AGENT_PRE_CALL_EVENT,
AGENT_PRE_CALL_ABORT_EVENT

(reserved) 74

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
256
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


CALL_STATE_TAG SNAPSHOT_DEVICE_CONF 75

MONITORED_DEVID_TAG MONITOR_START_REQ 76

AUTHORIZATION_ CODE_TAG CONFERENCE_CALL_REQ, 77


CONSULTATION_CALL_REQ,
MAKE_CALL_REQ,
MAKE_PREDICTIVE_CALL_REQ,
TRANSFER_CALL_REQ

ACCOUNT_CODE_TAG CONFERENCE_CALL_REQ, 78
CONSULTATION_CALL_REQ,
MAKE_CALL_REQ,
MAKE_PREDICTIVE_CALL_REQ,
TRANSFER_CALL_REQ

ORIGINATING_DEVID_TAG MAKE_PREDICTIVE_CALL_REQ 79

ORIGINATING_LINE _ID_TAG MAKE_PREDICTIVE_CALL_REQ 80

CLIENT_ADDRESS_ TAG CLIENT_SESSION_OPENED_EVENT, 81


CLIENT_SESSION_CLOSED_EVENT

NAMED_VARIABLE_ TAG BEGIN_CALL_EVENT, 82


CALL_DATA_UPDATE_EVENT,
AGENT_PRE_CALL_EVENT,
CALL_TRANSLATION_ROUTE_ EVENT,
SET_CALL_DATA_REQ,
CONFERENCE_CALL_REQ,
CONSULTATION_CALL_REQ,
MAKE_CALL_REQ,
MAKE_PREDICTIVE_CALL_REQ,
TRANSFER_CALL_REQ,
SNAPSHOT_CALL_CONF,
REGISTER_VARIABLES_REQ,
SNAPSHOT_TASK_RESP

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
257
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


NAMED_ARRAY_TAG BEGIN_CALL_EVENT, 83
CALL_DATA_UPDATE_EVENT,
AGENT_PRE_CALL_EVENT,
CALL_TRANSLATION_ROUTE_ EVENT,
SET_CALL_DATA_REQ,
CONFERENCE_CALL_REQ,
CONSULTATION_CALL_REQ,
MAKE_CALL_REQ,
MAKE_PREDICTIVE_CALL_REQ,
TRANSFER_CALL_REQ,
SNAPSHOT_CALL_CONF,
REGISTER_VARIABLES_REQ,
SNAPSHOT_TASK_RESP

CALL_CONTROL_ TABLE_TAG MAKE_CALL_REQ, 84


MAKE_PREDICTIVE_CALL_REQ,

SUPERVISOR_ INSTRUMENT_TAG SUPERVISE_CALL_REQ 85

ATC_AGENT_ID_TAG AGENT_TEAM_CONFIG_EVENT 86

AGENT_FLAGS_TAG AGENT_TEAM_CONFIG_EVENT 87

ATC_AGENT_STATE_ TAG AGENT_TEAM_CONFIG_EVENT 88

ATC_STATE_ DURATION_TAG AGENT_TEAM_CONFIG_EVENT 89

AGENT_ CONNECTION_DEVID_ TAG SUPERVISE_CALL_REQ 90

SUPERVISOR_ CONNECTION_ SUPERVISE_CALL_REQ, 91


DEVID_TAG

LIST_TEAM_ID_TAG LIST_AGENT_TEAM_CONF 92

DEFAULT_DEVICE_ AGENT_DESK_SETTINGS_CONF 93
PORT_ADDRESS_TAG

SERVICE_NAME_TAG REGISTER_SERVICE_REQ 94

CUSTOMER_PHONE_ NUMBER_TAG SET_CALL_DATA_REQ, 95


CALL_DATA_UPDATE_EVENT

CUSTOMER_ ACCOUNT_NUMBER_TAG SET_CALL_DATA_REQ, 96


CALL_DATA_UPDATE_EVENT

APP_PATH_ID_TAG OPEN_REQ 97

SCRIPT_SELECTOR_TAG SNAPSHOT_TASK_RESP 99

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
258
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


APPLICATION_STRING1_TAG SNAPSHOT_TASK_RESP 100

APPLICATION_STRING2_TAG SNAPSHOT_TASK_RESP 101

ROUTER_CALL_KEY_SEQUENCE_NUM_TAG AGENT_LEGACY_PRE_CALL_EVENT, 110


BEGIN_CALL_EVENT,
CALL_DATA_UPDATE_EVENT,
CALL_TRANSLATION_ROUTE_EVENT,
AGENT_PRE_CALL_EVENT,
AGENT_PRE_CALL_ABORT_EVENT

TRUNK_NUMBER_ TAG CALL_DELIVERED_EVENT, 121


CALL_ESTABLISHED_EVENT,
CALL_REACHED_NETWORK_ EVENT

TRUNK_GROUP_ NUMBER_TAG CALL_DELIVERED_EVENT, 122


CALL_ESTABLISHED_EVENT,
CALL_REACHED_NETWORK_EVENT

EXT_AGENT_STATE_ TAG AGENT_STATE_EVENT 123

DEQUEUE_TYPE_TAG CALL_DEQUEUED_EVENT 124

SENDING_ADDRESS_ TAG RTP_STARTED_EVENT, 125


RTP_STOPPED_EVENT

SENDING_PORT_TAG RTP_STARTED_EVENT 126


RTP_STOPPED_EVENT

Unused 127-128

MAX_QUEUED_TAG CONFIG_SERVICE_EVENT, 129


CONFIG_DEVICE_EVENT

QUEUE_ID_TAG QUEUE_UPDATED_EVENT 130

CUSTOMER_ID_TAG CONFIG_REQUEST_EVENT 131

SERVICE_SKILL_ TARGET_ID_TAG CONFIG_SERVICE_EVENT 132

PERIPHERAL_NAME_ TAG CONFIG_SERVICE_EVENT, 133


CONFIG_SKILL_GROUP_EVENT,
CONFIG_AGENT_EVENT,
CONFIG_DIALED_NUMBER_ EVENT

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
259
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


DESCRIPTION_TAG CONFIG_SERVICE_EVENT, 134
CONFIG_SKILL_GROUP_EVENT,
CONFIG_AGENT_EVENT,
CONFIG_DIALED_NUMBER_EVENT
CONFIG_MRD_EVENT

SERVICE_MEMBER_ ID_TAG CONFIG_SKILL_GROUP_EVENT 135

SERVICE_MEMBER_ PRIORITY_TAG CONFIG_SKILL_GROUP_EVENT 136

FIRST_NAME_TAG CONFIG_AGENT_EVENT 137

LAST_NAME_TAG CONFIG_AGENT_EVENT 138

SKILL_GROUP_TAG CONFIG_AGENT_EVENT 139

AGENT_SKILL_ TARGET_ID_TAG CONFIG_AGENT_EVENT 141

SERVICE_TAG CONFIG_DIALED_NUMBER_ EVENT 142

Reserved 143-149

DURATION_TAG AGENT_STATE_EVENT 150

Reserved 151-172

EXTENSION_TAG CONFIG_SKILL_GROUP_EVENT, 173


CONFIG_SERVICE_EVENT,
CONFIG_AGENT_EVENT,CONFIG_DEVICE_EVENT

SERVICE_LEVEL_ THRESHOLD_TAG CONFIG_SERVICE_EVENT 174

SERVICE_LEVEL_ TYPE_TAG CONFIG_SERVICE_EVENT 175

CONFIG_PARAM_TAG CONFIG_SKILL_GROUP_EVENT, 176


CONFIG_SERVICE_EVENT

SERVICE_CONFIG_ KEY_TAG CONFIG_KEY_EVENT, 177


CONFIG_BEGIN_EVENT

SKILL_GROUP_ CONFIG_KEY_TAG CONFIG_KEY_EVENT, 178


CONFIG_BEGIN_EVENT

AGENT_CONFIG_ KEY_TAG CONFIG_KEY_EVENT, 179


CONFIG_BEGIN_EVENT

DEVICE_CONFIG_ KEY_TAG CONFIG_KEY_EVENT, 180


CONFIG_BEGIN_EVENT

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
260
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


Unused 181-182

RECORD_TYPE_TAG CONFIG_AGENT_EVENT, 183


CONFIG_DEVICE_EVENT,
CONFIG_SERVICE_EVENT,
CONFIG_SKILL_GROUP_EVENT

PERIPHERAL_ NUMBER_TAG CONFIG_AGENT_EVENT, 184


CONFIG_DEVICE_EVENT,
CONFIG_SERVICE_EVENT,
CONFIG_SKILL_GROUP_EVENT

AGENT_SKILL_ TARGET_ID_TAG CONFIG_AGENT_EVENT 185

NUM_SERVICE_ MEMBERS_TAG CONFIG_SERVICE_EVENT 186

SERVICE_MEMBER_ TAG CONFIG_SERVICE_EVENT 187

SERVICE_PRIORITY_ TAG CONFIG_SERVICE_EVENT 188

AGENT_TYPE_TAG CONFIG_AGENT_EVENT 189

LOGIN_ID_TAG CONFIG_AGENT_EVENT 190

NUM_SKILLS_TAG CONFIG_AGENT_EVENT 191

SKILL_GROUP_SKILL_TARGET_ID_TAG CONFIG_SKILL_GROUP_EVENT 192

SERVICE_ID_TAG CONFIG_DEVICE_EVENT 193

AGENT_ID_LONG_ TAG OPEN_REQ, OPEN_REQ, 194


OPEN_REQ_CONF,
AGENT_STATE_EVENT,
RTP_STARTED_EVENT,
RTP_STOPPED_EVENT,
SUPERVISE_CALL_REQ,
EMERGENCY_CALL_EVENT,
USER_MESSAGE_REQ,
SET_AGENT_STATE_REQ,
SET_AGENT_STATE_CONF,
QUERY_AGENT_STATE_REQ,
QUERY_AGENT_STATE_CONF,
AGENT_UPDATED_EVENT

DEVICE_TYPE_TAG CONFIG_DEVICE_EVENT 195

Unused 196-197

ENABLE_TAG ROUTE_REGISTER_EVENT 198

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
261
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


DEVICEID_TAG ROUTE_REQUEST_EVENT 199

TIMEOUT_TAG ROUTE_REQUEST_EVENT 200

CURRENT_ROUTE_ TAG ROUTE_REQUEST_EVENT 201

SECONDARY_ CONNECTION_CALL_ ID CALL_DELIVERED_EVENT 202

PRIORITY_QUEUE_ NUMBER_TAG CALL_QUEUED_EVENT 203

TEAM_NAME_TAG TEAM_CONFIG_EVENT 204

MEMBER_TYPE_TAG TEAM_CONFIG_EVENT 205

EVENT_DEVICE_ID_ TAG SYSTEM_EVENT 206

LOGIN_NAME_TAG (V11) CONFIG_AGENT_EVENT 207

PERIPHERAL_ID_TAG (V11) CONFIG_AGENT_EVENT, 208


CONFIG_SERVICE_EVENT,
CONFIG_SKILL_GROUP_EVENT,
CONFIG_DEVICE_EVENT

CALL_TYPE_KEY_ CONFIG_TAG (V11) CONFIG_KEY_EVENT 209

CALL_TYPE_ID_TAG (V11) AGENT_PRE_CALL_EVENT, 210


CONFIG_CALL_TYPE_EVENT,
SET_APP_DATA

CUSTOMER_ DEFINITION_ID_TAG (V11) CONFIG_CALL_TYPE_EVENT 211

ENTERPRISE_NAME_ TAG (V11) CONFIG_CALL_TYPE_EVENT 212


CONFIG_MRD_EVENT

CUR_PERIPHERAL_ NUMBER_TAG CONFIG_SKILL_GROUP_EVENT, 213


CONFIG_CALL_TYPE_EVENT

CUR_LOGIN_ID CONFIG_AGENT_EVENT 214

ANI_II_TAG BEGIN_CALL_EVENT, 215


CALL_TRANSLATION_ROUTE_ EVENT,
CALL_DATA_UPDATE,
CALL_DELIVERED_EVENT,
AGENT_PRE_CALL_EVENT,
SET_CALL_DATA_REQ,
SNAPSHOT_CALL_REQ,
ROUTE_REQUEST_EVENT

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
262
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


MR_DOMAIN_ID_TAG CONFIG_SKILL_GROUP_EVENT, 216
CONFIG_SERVICE_EVENT
CONFIG_MRD_EVENT

CTIOS_CIL_CLIENT_ ID_TAG SET_CALL_DATA_REQ, 217


ALTERNATE_CALL_REQ,
ANSWER_CALL_REQ,
CLEAR_CALL_REQ,
CLEAR_CONNECTION_REQ,
DEFLECT_CALL_REQ, HOLD_CALL_REQ,
RECONNECT_CALL_REQ,
RETRIEVE_CALL_REQ,
SEND_DTMF_SIGNAL_REQ,
CHANGE_MONITOR_MASK_REQ,
USER_MESSAGE_REQ,
SESSION_MONITOR_START_REQ,
SESSION_MONITOR_STOP_REQ,
MONITOR_AGENT_TEAM_START_REQ,
MONITOR_AGENT_TEAM_ STOP_REQ,
FAILURE_CONF,
CONTROL_FAILURE_CONF

SILENT_MONITOR_ STATUS_TAG SNAPSHOT_DEVICE_CONF 218

REQUESTING_ DEVICE_ID_TAG CALL_CLEAR_CONNECTION_REQ 219

REQUESTING_ DEVICE_ID_ TYPE_TAG CALL_CLEAR_CONNECTION_REQ 220

PRE_CALL_INVOKE_ ID_TAG AGENT_PRE_CALL_EVENT, 221


SET_APP_DATA

ENTERPRISE_ QUEUE_TIME 222

CALL_REFERENCE_ ID_TAG BEGIN_CALL_EVENT, 223


CALL_DATA_UPDATE_EVENT,
CALL_TERMINATION_EVNT,
SNAPSHOT_CALL_CONF

MULTI_LINE_AGENT_ CONTROL_TAG OPEN_CONF 224

NETWORK_ CONTROLLED_TAG ROUTE_SELECT_EVENT 225

Used 226-227

NUM_PERIPHERALS_ TAG OPEN_CONF 228

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
263
Constants and Status Codes
Tag Values

Floating Field Tag Using Messages Value


COC_CONNECTION_ CALL_ID_TAG CALL_SERVICE_INITIATED_ EVENT, 229
ROUTE_REQUEST_EVENT, SNAPSHOT
_CALL_CONF

COC_CONNECTION_ DEVICE_ID_TYPE_ CALL_SERVICE_INITIATED_ EVENT, 230


TAG ROUTE_REQUEST_EVENT, SNAPSHOT
_CALL_CONF

COC_CONNECTION_ DEVICE_ID_TAG CALL_SERVICE_INITIATED_ EVENT, 231


ROUTE_REQUEST_EVENT, SNAPSHOT
_CALL_CONF

CALL_ORIGINATED_ FROM_TAG SET_CALL_DATA_REQ 232

SET_APPDATA_CALLID_TAG 233

CLIENT_SHARE_KEY_TAG 234

AGENT_TEAM_NAME_TAG AGENT_TEAM_CONFIG_EVENT 243

DIRECTION_TAG AGENT_STATE_EVENT 244

OPTIONS_TAG ROUTE_REQUEST_EVENT (internal use 245


only for ACMI PIM)

FLT_MRD_ID_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 246


(Internal Cisco Use Only)

MEDIA_CLASS_ID_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 247


and
CONFIG_MEDIA_CLASS_EVENT (Internal
Cisco Use Only)

TASK_LIFE_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 248


and
CONFIG_MEDIA_CLASS_EVENT (Internal
Cisco Use Only)

TASK_START_TIMEOUT_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 249


and
CONFIG_MEDIA_CLASS_EVENT (Internal
Cisco Use Only)

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
264
Constants and Status Codes
AgentState Values

Floating Field Tag Using Messages Value


MAX_TASK_DURATION_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 250
and
CONFIG_MEDIA_CLASS_EVENT (Internal
Cisco Use Only)
CONFIG_MRD_EVENT

INTERRUPTIBLE_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 251


(Internal Cisco Use Only)
CONFIG_MRD_EVENT

MAX_CALLS_IN_QUEUE_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 252


(Internal Cisco Use Only)

MAX_CALLS_IN_QUEUE_PER_CALL_TYPE_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 253


(Internal Cisco Use Only)

MAX_TIME_IN_QUEUE_TAG CONFIG_MEDIA_ROUTING_DOMAIN_EVENT 254


(Internal Cisco Use Only)

INTERNAL_AGENT_STATE_TAG QUERY_AGENT_STATE_CONF (internal 255


use only for CCX)

Unused 256

SSO_ENABLED_TAG CONFIG_AGENT_EVENT, 257


SET_AGENT_STATE_REQ

FLT_TASK_ID_TAG AGENT_TASKS_RESP 258

FLT_ICM_DISP_TAG MEDIA_LOGOUT_IND 259

FLT_APP_DISP_TAG MEDIA_LOGOUT_IND 260

AgentState Values
This table shows the agent state values that may appear in the QUERY_AGENT_STATE_CONF messages.

Table 177: AgentState Values

State Name Description Value


AGENT_STATE_ LOGIN The agent has logged on to the ACD. It does not 0
necessarily indicate that the agent is ready to
accept calls.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
265
Constants and Status Codes
PGStatusCode Values

State Name Description Value


AGENT_STATE_ LOGOUT The agent has logged out of the ACD and cannot 1
accept any additional calls.

AGENT_STATE_ NOT_ READY The agent is unavailable for any call work. 2

AGENT_STATE_ AVAILABLE The agent is ready to accept a call. 3

AGENT_STATE_ TALKING The agent is currently talking on a call (inbound, 4


outbound, or inside).

AGENT_STATE_ WORK_NOT_READY The agent is performing after call work, but will 5
not be ready to receive a call when completed.

AGENT_STATE_ WORK_ READY The agent is performing after call work, and will 6
be ready to receive a call when completed.

AGENT_STATE_ BUSY_ OTHER The agent is busy performing a task associated 7


with another active SkillGroup.

AGENT_STATE_ RESERVED The agent is reserved for a call that will arrive at 8
the ACD shortly.

AGENT_STATE_ UNKNOWN The agent state is currently unknown. 9

AGENT_STATE_ HOLD The agent currently has all calls on hold. 10

AGENT_STATE_ ACTIVE The agent state is currently active. 11

AGENT_STATE_ PAUSED The agent state is currently paused. 12

AGENT_STATE_ INTERRUPTED The agent state is currently interrupted. 13

AGENT_STATE_NOT_ACTIVE The agent state is currently not active. 14

PGStatusCode Values
This table shows the PGStatusCode values that may be included in the SYSTEM_EVENT message.

Table 178: PGStatusCode Values

PGStatus Description Mask Value


PGS_OPC_DOWN Communication lost between the CTI Server and the 0x00000001
PG’s Open Peripheral Controller (OPC) process. No call
or agent state event messages can be sent due to this
condition.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
266
Constants and Status Codes
PeripheralType Values

PGStatus Description Mask Value


PGS_CC_DOWN Communication lost between the PG and the Unified 0x00000002
CCE Central Controller. Primarily affects translation
routing and post-routing, other call and agent event
messages can still be sent.

PGS_PERIPHERAL_OFFLINE One or more of the peripherals monitored by the PG are 0x00000004


offline.

PGS_CTI_SERVER_OFFLINE Loss of communication between the CTI Server and the 0x00000008
CTI Client. This status code is not reported by a software
layer between the CTI Server and the client application.

PGS_LIMITED_FUNCTION This status code may be reported by a software layer 0x00000010


between the CTI Server and the client application when
PGS_CTI_SERVER_ OFFLINE is true to indicate that
limited local call control is possible.

PeripheralType Values
This table shows the PeripheralType values that may be included in the Client Events service messages.

Table 179: PeripheralType Values

Peripheral Type Description Value


PT_NONE Not Applicable 0xffff

PT_ASPECT Aspect Call Center ACD 1

PT_MERIDIAN Northern Telecom Meridian ACD 2

PT_G2 Lucent G2 3

PT_DEFINITY_ECS_ NON_EAS Lucent DEFINITY ECS (without Expert Agent Selection) 4

PT_DEFINITY_ECS_ EAS Lucent DEFINITY ECS (with Expert Agent Selection) 5

PT_GALAXY Obsolete 6

PT_SPECTRUM Obsolete 7

PT_VRU VRU (event type interface) 8

PT_VRU_POLLED VRU (polled type interface) 9

PT_DMS100 Obsolete 10

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
267
Constants and Status Codes
LocalConnectionState Values

Peripheral Type Description Value


PT_SIEMENS_9006 Siemens Hicom ACD (9006) 11

PT_SIEMENS_9005 Siemens 9751 CBX Release 9005 (Rolm 9005) 12

PT_ALCATEL Alcatel 4400 ACD 13

PT_NEC_NEAX_2x00 Obsolete 14

PT_ ACP_1000 Ericsson ACP1000 15

PT_ SYMPOSIUM Avaya Aura 16

PT_ENTERPRISE_ AGENT Unified CCE Manager 17

PT_MD110 Ericsson MD-110 18

PT_MEDIA_ROUTING Media Routing 19

PT_GENERIC Generic 20

PT_ACMI_CRS A Gateway PG over Unified CCX 21

PT_ACMI_IPCC A Gateway PG over Unified CCE or Unified CCX 22

PT_SIMPLIFIED_IPCC A system using the System PG 23

PT_ARS A system using the ARS PG 24

PT_ACMI_ERS A system using the ERS PG 25

PT_ACMI_EXPERT_ADVISOR Obsolete 26

{reserved} 27

LocalConnectionState Values
This table shows the LocalConnectionState values.

Table 180: LocalConnectionState values

LocalConnectionState Description Value


LCS_NONE Not applicable 0xffff

LCS_NULL No relationship between call and device. 0

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
268
Constants and Status Codes
EventCause Values

LocalConnectionState Description Value


LCS_INITIATE Device requesting service (“dialing”). 1

LCS_ALERTING Device is alerting (“ringing”). 2

LCS_CONNECT Device is actively participating in the call. 3

LCS_HOLD Device is inactively participating in the call. 4

LCS_QUEUED Device is stalled attempting to connect to a call, or a call is 5


stalled attempting to connect to a device.

LCS_FAIL A device-to-call or call-to-device connection attempt has been 6


aborted.

EventCause Values
These tables show the EventCause values.

Table 181: EventCause Values

EventCause Value
CEC_NONE 0xffff

CEC_ACTIVE_MONITOR 1

CEC_ALTERNATE 2

CEC_BUSY 3

CEC_CALL_BACK 4

CEC_CALL_CANCELLED 5

CEC_CALL_FORWARD_ALWAYS 6

CEC_CALL_FORWARD_BUSY 7

CEC_CALL_FORWARD_NO_ANSWER 8

CEC_CALL_FORWARD 9

CEC_CALL_NOT_ANSWERED 10

CEC_CALL_PICKUP 11

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
269
Constants and Status Codes
EventCause Values

EventCause Value
CEC_CAMP_ON 12

CEC_DEST_NOT_OBTAINABLE 13

CEC_DO_NOT_DISTURB 14

CEC_INCOMPATIBLE_DESTINATION 15

CEC_INVALID_ACCOUNT_CODE 16

CEC_KEY_CONFERENCE 17

CEC_LOCKOUT 18

CEC_MAINTENANCE 19

CEC_NETWORK_CONGESTION 20

CEC_NETWORK_NOT_OBTAINABLE 21

CEC_NEW_CALL 22

CEC_NO_AVAILABLE_AGENTS 23

CEC_OVERRIDE 24

CEC_PARK 25

CEC_OVERFLOW 26

CEC_RECALL 27

CEC_REDIRECTED 28

CEC_REORDER_TONE 29

CEC_RESOURCES_NOT_AVAILABLE 30

CEC_SILENT_MONITOR 31

CEC_TRANSFER 32

CEC_TRUNKS_BUSY 33

CEC_VOICE_UNIT_INITIATOR 34

CEC_TIME_OUT 35

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
270
Constants and Status Codes
EventCause Values

EventCause Value
CEC_NEW_CALL_INTERFLOW 36

CEC_SIMULATION_INIT_REQUEST 37

CEC_SIMULATION_RESET_REQUEST 38

CEC_CTI_LINK_DOWN 39

CEC_PERIPHERAL_RESET_REQUEST 40

CEC_MD110_CONFERENCE_TRANSFER 41

CEC_REMAINS_IN_Q 42

CEC_SUPERVISOR_ASSIST 43

CEC_EMERGENCY_CALL 44

CEC_SUPERVISOR_CLEAR 45

CEC_SUPERVISOR_MONITOR 46

CEC_SUPERVISOR_WHISPER 47

CEC_SUPERVISOR_BARGE_IN 48

CEC_SUPERVISOR_INTERCEPT 49

CEC_CALL_PARTY_UPDATE_IND 50

CEC_CONSULT 51

CEC_NIC_CALL_CLEAR 52

Extended Call Cleared Event Causes

EventCause Value
CECX_ABAND_NETWORK 1001

CECX_ABAND_LOCAL_QUEUE 1002

CECX_ABAND_RING 1003

CECX_ABAND_DELAY 1004

CECX_ABAND_INTERFLOW 1005

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
271
Constants and Status Codes
EventCause Values

EventCause Value
CECX_ABAND_AGENT_TERMINAL 1006

CECX_SHORT 1007

CECX_BUSY 1008

CECX_FORCED_BUSY 1009

CECX_DROP_NO_ANSWER 1010

CECX_DROP_BUSY 1011

CECX_DROP_REORDER 1012

CECX_DROP_HANDLED_PRIMARY_ROUTE 1013

CECX_DROP_HANDLED_OTHER 1014

CECX_REDIRECTED 1015

CECX_CUT_THROUGH 1016

CECX_INTRAFLOW 1017

CECX_INTERFLOW 1018

CECX_RING_NO_ANSWER 1019

CECX_INTERCEPT_REORDER 1020

CECX_INTERCEPT_DENIAL 1021

CECX_TIME_OUT 1022

CECX_VOICE_ENERGY 1023

CECX_NONCLASSIFIED_ENERGY_DETECT 1024

CECX_NO_CUT_THROUGH 1025

CECX_UABORT 1026

CECX_FAILED_SOFTWARE 1027

CECX_BLIND_TRANSFER 1028

CECX_ANNOUNCED_TRANSFER 1029

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
272
Constants and Status Codes
EventCause Values

EventCause Value
CECX_CONFERENCED 1030

CECX_DUPLICATE_TRANSFER 1031

CECX_UNMONITORED_DEVICE 1032

CECX_ANSWERING_MACHINE 1033

CECX_NETWORK_BLIND_TRANSFER 1034

CECX_TASK_ABANDONED_IN_ROUTER 1035

CECX_TASK_ABANDONED_BEFORE_OFFERED 1036

CECX_TASK_ABANDONED_WHILE_OFFERED 1037

CECX_NORMAL_END_TASK 1038

CECX_CANT_OBTAIN_TASK_ID 1039

CECX_AGENT_LOGGED_OUT_DURING_TASK 1040

CECX_MAX_TASK_LIFETIME_EXCEEDED 1041

CECX_APPLICATION_PATH_WENT_DOWN 1042

CECX_ICM_ROUTING_COMPLETE 1043

CECX_ICM_ROUTING_DISABLED 1044

CECX_APPL_INVALID_MRD_ID 1045

CECX_APPL_INVALID_DIALOGUE_ID 1056

CECX_APPL_DUPLICATE_DIALOGUE_ID 1047

CECX_APPL_INVALID_INVOKE_ID 1048

CECX_APPL_INVALID_SCRIPT_SELECTOR 1049

CECX_APPL_TERMINATE_DIALOGUE 1050

CECX_TASK_ENDED_DURING_APP_INIT 1051

CECX_CALLED_PARTY_DISCONNECTED 1052

CECX_PARTIAL_CALL 1053

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
273
Constants and Status Codes
DeviceIDType Values

EventCause Value
CECX_DROP_NETWORK_CONSULT 1054

CECX_NETWORK_CONSULT_TRANSFER 1055

CECX_NETWORK_CONFERENCE 1056

CECX_ABAND_NETWORK_CONSULT 1057

DeviceIDType Values
This table shows the DeviceIDType values.

Table 182: DeviceIDType Values

Device ID Type Description Value

DEVID_NONE No device ID is provided. 0xffff

DEVID_DEVICE_IDENTIFIER The provided device ID identifies a 0


peripheral teleset (extension).

DEVID_TRUNK_IDENTIFIER The provided device ID identifies a 70


peripheral Trunk.

DEVID_TRUNK_GROUP_ IDENTIFIER The provided device ID identifies a 71


peripheral Trunk Group.

DEVID_IP_PHONE_MAC_ IDENTIFIER The provided device ID identifiers the 72


MAC address of an IP phone (Unified CCX
ONLY).

DEVID_CTI_PORT The provided device ID identifiers a CTI 73


PORT (Unified CCX ONLY).

DEVID_ROUTE_POINT The provided device ID identifies a 74


ROUTE POINT.

DEVID_EXTERNAL The provided device ID is an ANI number 75


or some other external identifier.

DEVID_AGENT_DEVICE The provided device ID is the ID of an 76


AGENT Device (phone).

DEVID_QUEUE The provided device ID is the ID of a 77


QUEUE.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
274
Constants and Status Codes
CallType Values

DEVID_NON_ACD_DEVICE_ The provided device ID identifies a 78


IDENTIFIER peripheral telset (extension) that is
classified as being a non-ACD extension.

DEVID_SHARED_DEVICE_ The provided device ID identifies a 79


IDENTIFIER peripheral telset (extension) that is
classified as being a shared line (0 or more
telsets share this extension).

CallType Values
This table shows the CallType values.

Table 183: CallType Values

CallType Description Value


CALLTYPE_ACD_IN Inbound ACD call. 1

CALLTYPE _PREROUTE_ ACD_IN Translation routed inbound ACD call. 2

CALLTYPE _PREROUTE_ Translation routed call to a specific 3


DIRECT_AGENT agent.

CALLTYPE _TRANSFER_IN Transferred inbound call. 4

CALLTYPE _OVERFLOW_IN Overflowed inbound call. 5

CALLTYPE _OTHER_IN Inbound call. 6

CALLTYPE _AUTO_OUT Automatic out call. 7

CALLTYPE _AGENT_OUT Agent out call. 8

CALLTYPE _OUT Outbound call. 9

CALLTYPE _AGENT_INSIDE Agent inside call. 10

CALLTYPE _OFFERED Blind transferred call. 11

CALLTYPE _CONSULT Consult call. 12

CALLTYPE _CONSULT_ OFFERRED Announced transferred call. 13

CALLTYPE _CONSULT_ CONFERENCE Conferenced consult call. 14

CALLTYPE _CONFERENCE Conference call. 15

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
275
Constants and Status Codes
CallType Values

CallType Description Value


CALLTYPE_UNMONITORED Inside or outbound call for which no 16
call events will be received.

CALLTYPE_PREVIEW Automatic out call in which the agent 17


is given the option to proceed to dial a
contact.

CALLTYPE_RESERVATION Call made to reserve an agent for some 18


other function.

CALLTYPE_ASSIST Call to supervisor for assistance. 19

CALLTYPE_EMERGENCY Emergency call. 20

CALLTYPE_SUPERVISOR_ MONITOR Supervisor silently monitoring call. 21

CALLTYPE_SUPERVISOR_ WHISPER Supervisor monitoring call, agent can 22


hear supervisor.

CALLTYPE_SUPERVISOR_ BARGEIN Supervisor conferenced into call. 23

CALLTYPE_SUPERVISOR_ INTERCEPT Supervisor replaces agent on call. 24

CALLTYPE_TASK_ROUTED_BY_ICM Task routed by Unified CCE 25

CALLTYPE_TASK_ROUTED_BY_APPLICATION Task routed by application 26

CALLTYPE_NON_ACD Agent call that is a non-ACD routed 27


call.

RESERVATION_PREVIEW Call type for Outbound Option 27


Reservation calls for Preview mode.

RESERVATION_PREVIEW_DIRECT Call type for Outbound Option 28


Reservation calls for Direct Preview
mode.

RESERVATION_PREDICTIVE Call type for Outbound Option 29


Reservation calls for Predictive mode
and Progressive mode.

RESERVATION_CALLBACK Call type for Outbound Option 30


Reservation calls for Callback calls.

RESERVATION_PERSONAL_CALLBACK Call type for Outbound Option 31


Reservation calls for Personal Callback
calls.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
276
Constants and Status Codes
ConnectionDeviceIDType Values

CallType Description Value


CUSTOMER_PREVIEW Call type for Outbound Option 32
Customer calls for Preview mode.

CUSTOMER_PREVIEW_DIRECT Call type for Outbound Option 33


Customer calls for Direct Preview

CUSTOMER_PREDICTIVE Call type for Outbound Option 34


Customer calls for Predictive mode and
Progreassive modefor agentbased
campaigns.

CUSTOMER_CALLBACK Call type for Outbound Option 35


Customer calls for callback calls.

CUSTOMER_PERSONAL Call type for Outbound Option 36


Customer calls for personal callback
calls.

CUSTOMER_IVR Call type for Outbound Option 37


Customer calls for Transfer to IVR
campaigns.

CALLTYPE_NON_ACD Agent call that is a non-ACD call. 38

CALLTYPE_PLAY_AGENT_GREETING An agent greeting route request. 39

CALLTYPE_RECORD_AGENT_GREETING Record agent greeting call initiated by 40


AGENT_GREETING_CONTROL_REQ.

CALLTYPE_VOICE_CALL_BACK Voice callback using the Agent 41


Request API.

ConnectionDeviceIDType Values
This table shows the possible ConnectionDeviceIDType values.

Table 184: ConnectionDeviceIDType Values

ConnectionDevice IDType Description Value

CONNECTION_ID_ NONE No ConnectionDeviceID is provided. 0xffff

CONNECTION_ID_ STATIC The ConnectionDeviceID value is stable over time 0


(between calls).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
277
Constants and Status Codes
LineType Values

CONNECTION_ID_ DYNAMIC The ConnectionDeviceID value is dynamic and may 1


change between calls.

LineType Values
This table shows the possible LineType values.

Table 185: LineType Values

LineType Description Value

LINETYPE_INBOUND_ ACD Line used for inbound ACD calls. 0

LINETYPE_OUTBOUND_ACD Line used for outbound ACD calls. 1

LINETYPE_INSIDE Line used for inside calls. 2

LINETYPE_UNKNOWN Line used for any purpose. 3

LINETYPE_SUPERVISOR Line used for supervisor calls. 4

LINETYPE_MESSAGE Line used for voice messages. 5

LINETYPE_HELP Line used for assistance. 6

LINETYPE_OUTBOUND Line used for outbound non-ACD calls. 7

LINETYPE_DID Line used for direct inward dialed calls. 8

LINETYPE_SILENT_ MONITOR Line used for silent monitor. 9

LINETYPE_NON_ACD_IN Line used for inbound non-ACD calls. 10

LINETYPE_NON_ACD_OUT Line used for outbound non-ACD calls. 11

ControlFailureCode Values
This table shows the possible ControlFailureCode values.

Table 186: ControlFailureCode Values

FailureCode Description Value


CF_GENERIC_UNSPECIFIED An error has occurred that is not one of the following 0
error types.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
278
Constants and Status Codes
ControlFailureCode Values

FailureCode Description Value


CF_GENERIC_OPERATION An operation error occurred (no specific details 1
available).

CF_REQUEST_ INCOMPATIBLE_WITH_ The request is not compatible with the object. 2


OBJECT

CF_VALUE_OUT_OF_ RANGE The parameter has a value that is not in the range 3
defined for the server.

CF_OBJECT_NOT_KNOWN The parameter has a value that is not known to the 4


server.

CF_INVALID_CALLING_ DEVICE The calling device is invalid. 5

CF_INVALID_CALLED_ DEVICE The called device is invalid 6

CF_INVALID_FORWARDING_ The forwarding destination device is invalid. 7


DESTINATION

CF_PRIVILEGE_VIOLATION_ The specified device is not authorized for the service. 8


ON_SPECIFIED_DEVICE

CF_PRIVILEGE_VIOLATION_ The called device is not authorized for the service. 9


ON_CALLED_DEVICE

CF_PRIVILEGE_VIOLATION_ The calling device is not authorized for the service. 10


ON_CALLING_DEVICE

CF_INVALID_CSTA_CALL_ The call identifier is invalid. 11


IDENTIFIER

CF_INVALID_CSTA_DEVICE_ The device identifier is invalid. 12


IDENTIFIER

CF_INVALID_CSTA_ The connection identifier is invalid. 13


CONNECTION_IDENTIFIER

CF_INVALID_DESTINATION The request specified a destination that is invalid. 14

CF_INVALID_FEATURE The request specified a feature that is invalid. 15

CF_INVALID_ALLOCATION_ STATE The request specified an allocation state that is 16


invalid.

CF_INVALID_CROSS_REF_ID The request specified a cross- reference ID that is not 17


in use at this time.

CF_INVALID_OBJECT_TYPE The request specified an invalid object type. 18

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
279
Constants and Status Codes
ControlFailureCode Values

FailureCode Description Value


CF_SECURITY_VIOLATION Security error (no specific details available). 19

CF_GENERIC_STATE_ The request is not compatible with the condition of 21


INCOMPATIBILITY a related device.

CF_INVALID_OBJECT_STATE The object is in the incorrect state for the request. 22

CF_INVALID_CONNECTION_ The active connection ID in the request is invalid. 23


ID_FOR_ACTIVE_CALL

CF_NO_ACTIVE_CALL There is no active call for the request. 24

CF_NO_HELD_CALL There is no held call for the request. 25

CF_NO_CALL_TO_CLEAR There is no call associated with the given connection 26


ID.

CF_NO_CONNECTION_TO_ CLEAR There is no call connection for the given connection 27


ID.

CF_NO_CALL_TO_ANSWER There is no alerting call to be answered. 28

CF_NO_CALL_TO_ COMPLETE There is no active call to be completed. 29

CF_GENERIC_SYSTEM_ The request failed due to lack of system resources 31


RESOURCE_AVAILABILITY (no specific details available).

CF_SERVICE_BUSY The service is temporarily unavailable. 32

CF_RESOURCE_BUSY An internal resource is busy. 33

CF_RESOURCE_OUT_OF_ SERVICE The service requires a resource that is out of service. 34

CF_NETWORK_BUSY The server sub-domain is busy. 35

CF_NETWORK_OUT_OF_ SERVICE The server sub-domain is out of service. 36

CF_ OVERALL_MONITOR_ The request would exceed the server’s overall 37


LIMIT_EXCEEDED resource limits.

CF_CONFERENCE_MEMBER_ The request would exceed the server’s limit on the 38


LIMIT_EXCEEDED number of conference members.

CF_ GENERIC_SUBSCRIBED_ The request failed due to lack of purchased or 41


RESOURCE_AVAILABILITY contracted resources (no specific details available).

CF_ OBJECT_MONITOR_ The request would exceed the server’s specific 42


LIMIT_EXCEEDED resource limits.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
280
Constants and Status Codes
ControlFailureCode Values

FailureCode Description Value


CF_ EXTERNAL_TRUNK_ The request would exceed the limit of external trunks. 43
LIMIT_EXCEEDED

CF_ OUTSTANDING_ The request would exceed the limit of outstanding 44


REQUEST_LIMIT_EXCEEDED requests.

CF_GENERIC_ PERFORMANCE_ The request failed as a performance management 51


MANAGEMENT mechanism (no specific details available).

CF_PERFORMANCE_LIMIT_ The request failed because a performance 52


EXCEEDED management limit was exceeded.

CF_ SEQUENCE_NUMBER_ VIOLATED The server has detected an error in the sequence 61
number of the operation.

CF_ TIME_STAMP_ VIOLATED The server has detected an error in the time stamp of 62
the operation.

CF_ PAC_VIOLATED The server has detected an error in the PAC of the 63
operation.

CF_ SEAL_VIOLATED The server has detected an error in the Seal of the 64
operation.

CF_ GENERIC_UNSPECIFIED_ The request has been rejected (no specific details 70
REJECTION available).

CF_ GENERIC_OPERATION_ The requested operation has been rejected (no specific 71
REJECTION details available).

CF_ DUPLICATE_ The request duplicated another request for the same 72
INVOCATION_REJECTION service.

CF_ UNRECOGNIZED_ The request specified an unrecognized operation. 73


OPERATION_REJECTION

CF_MISTYPED_ARGUMENT_ The request contained a parameter of the wrong type 74


REJECTION for the requested operation.

CF_ RESOURCE_LIMITATION_ The request would have exceeded a resource 75


REJECTION limitation.

CF_ ACS_HANDLE_ The request specified an ACS handle that is no longer 76


TERMINATION_REJECTION in use.

CF_ SERVICE_ The request failed because the required service has 77
TERMINATION_REJECTION been terminated.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
281
Constants and Status Codes
ControlFailureCode Values

FailureCode Description Value


CF_ REQUEST_TIMEOUT_ REJECTION The request failed because a timeout limit was 78
exceeded.

CF_REQUESTS_ON_DEVICE_ The request would have exceeded the limits of the 79


EXCEEDED_REJECTION device.

Extended Control Failure Codes

FailureCode Description Value


CF_INVALID_AGENT_ID_ The request specified an invalid AgentID. 256
SPECIFIED

CF_INVALID_PASSWORD_ The request specified an invalid agent password. 257


SPECIFIED

CF_INVALID_AGENT_ID_ The request specified an invalid AgentID and/or invalid 258


OR_PASSWORD_SPECIFIED agent password.

CF_SPECIFIED_AGENT_ The request failed because the specified agent is already 259
ALREADY_SIGNED_ON logged in.

CF_INVALID_LOGON_ The request specified an invalid logon device. 260


DEVICE_SPECIFIED

CF_INVALID_ANSWERING_ The request specified an invalid answering device. 261


DEVICE_SPECIFIED

CF_INVALID_SKILL_ The request specified an invalid agent skill group. 262


GROUP_SPECIFIED

CF_INVALID_CLASS_OF_ The request specified an invalid class of service. 263


SERVICE_SPECIFIED

CF_INVALID_TEAM_ SPECIFIED The request specified an invalid team. 264

CF_INVALID_AGENT_ WORKMODE The request specified an invalid agent work mode. 265

CF_INVALID_AGENT_ The request specified an invalid agent reason code. 266


REASON_CODE

CF_ADJUNCT_SWITCH_ A communication error occurred on the datalink between 267


COMM_ERROR the Unified CCE and the ACD.

CF_AGENT_NOT_PARTY_ The specified agent is not a party on the indicated call. 268
ON_CALL

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
282
Constants and Status Codes
ControlFailureCode Values

FailureCode Description Value


CF_INTERNAL_ An internal error occurred in the ACD while processing 269
PROCESSING_ERROR the request.

CF_TAKE_CALL_CONTROL_ The ACD refused an Unified CCE request to take control 270
REJECTION of a call.

CF_TAKE_DOMAIN_ The ACD refused an Unified CCE request to take control 271
CONTROL_REJECTION of a domain.

CF_REQUESTED_SERVICE_ The Unified CCE is not registered on the ACD for the 272
NOT_REGISTERED requested service.

CF_INVALID_CONSULT_ TYPE The consult type is invalid. 273

CF_ANSMAP_OR_ The Ansmap or Asparam field are not valid. 274


ADPARAM_FIELD_NOT_VALID

CF_INVALID_CALL_ The call control table is invalid. 275


CONTROL_TABLE_ SPECIFIED

CF_INVALID_DIGITS_ 276
RNATIMEOUT_AMSDELAY_
OR_COUNTRY

CF_ANSWER_DETECT_ 277
PORT_UNAVAILABLE

CF_VIRTUAL_AGENT_ 278
UNAVAILABLE

CF_TAKEBACK_N_XFER_ 279
ROUTE_END

CF_WRAPUP_DATA_ REQUIRED 280

CF_REASON_CODE_ REQUIRED 281

CF_INVALID_TRUNK_ID_ 282
SPECIFIED

CF_SPECIFIED_EXTENSION_ 283
ALREADY_IN_USE

CF_ARBITRARY_CONF_OR_ 284
XFER_NOT_SUPPORTED

CF_NETWORK_TRANSFER_OR_ 285
CONSULT

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
283
Constants and Status Codes
ControlFailureCode Values

FailureCode Description Value


CF_NETWORK_TRANSFER_OR_ 286
CONSULT_FAILED

CF_DEVICE_RESTRICTED 287

CF_LINE_RESTRICTED 288

CF_AGENT_ACCOUNT_ 289
LOCKED_OUT

CF_DROP_ANY_PARTY_NOT_ 290
ENABLED_CTI

CF_MAXIMUM_LINE_LIMIT_ 291
EXCEEDED

CF_SHARED_LINES_NOT_ 292
SUPPORTED

CF_EXTENSION_NOT_UNIQUE 293

CF_UNKNOWN_ INTERFACE_ The Interface Controller ID is unknown. 1001


CTRLR_ID

CF_INVALID_INTERFACE_ The Interface Controller type is invalid. 1002


CTRLR_TYPE

CF_SOFTWARE_REV_NO_ The current software revision is not supported. 1003


SUPPORTED

CF_UNKNOWN_PID The PeripheralID is unknown. 1004

CF_INVALID_TABLE_ SPECIFIED An invalid table was specified. 1005

CF_PD_SERVICE_INACTIVE The peripheral data service is not active. 1006

CF_UNKNOWN_ROUTING_ The RoutingClientID is unknown. 1007


CLIENT_ID

CF_RC_SERVICE_ INACTIVATE The routing client service is not active. 1008

CF_INVALID_DIALED_ NUMBER The dialed number is invalid. 1009

CF_INVALID_PARAMETER A parameter in the request is invalid. 1010

CF_UNKNOWN_ROUTING_ An unspecified error occurred during routing. 1011


PROBLEM

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
284
Constants and Status Codes
AllocationState Values

FailureCode Description Value


CF_UNSUPPORTED_PD_ The requested peripheral data service protocol version is 1012
MESSAGE_REVISION not supported.

CF_UNSUPPORTED_RC_ The requested routing client service protocol version is 1013


MESSAGE_REVISION not supported.

CF_UNSUPPORTED_IC_ The requested interface controller service protocol version 1014


MESSAGE_REVISION is not supported.

CF_RC_SERVICE_ The peripheral interface is not active. 1015


INACTIVATE_PIM

CF_AGENT_GREETING_CONTROL_OPERATION_FAILURE This error occurs if 1016


AGENT_GREETING_CONTROL_REQ request fails.
Notes: All detailed errors are defined as Peripheral Error
Codes.

AllocationState Values
This table shows the AllocationState values.

Table 187: AllocationState Values

AllocationState Description Value

ALLOC_CALL_ DELIVERED Connect call to originating device when call is delivered 0


(alerting).

ALLOC_CALL_ Connect call to originating device when call is established 1


ESTABLISHED (answered).

ForwardType Values
This table shows the ForwardType values.

Table 188: FowardType Values

ForwardType Description Value

FWT_IMMEDIATE Forward all calls. 0

FWT_BUSY Forward only when busy. 1

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
285
Constants and Status Codes
TypeOfDevice Values

FWT_NO_ANS Forward after no answer. 2

FWT_BUSY_INT Forward on busy for internal 3


calls.

FWT_BUSY_EXT Forward on busy for external 4


calls.

FWT_NO_ANS_INT Forward after no answer for 5


internal calls.

FWT_NO_ANS_EXT Forward after no answer for 6


external calls.

TypeOfDevice Values
This table shows the TypeOfDevice values.

Table 189: TypeOfDevice Values

TypeOfDevice Description Value


DEVT_STATION A traditional telephone device, consisting of one or more 0
buttons and one or more lines.

DEVT_LINE A communications interface to one or more stations. 1

DEVT_BUTTON An instance of a call manipulation point at an individual 2


station.

DEVT_ACD A mechanism that distributes calls. 3

DEVT_TRUNK A device used to access other switching domains. 4

DEVT_OPERATOR A device that interacts with a call party to assist in call 5


setup or provide other telecommunications service.

DEVT_STATION_ GROUP Two or more stations used interchangeably or addressed 16


identically.

DEVT_LINE_GROUP A set of communications interfaces to one or more 17


stations.

DEVT_BUTTON_ GROUP Two or more instances of a call manipulation point at an 18


individual station.

DEVT_ACD_GROUP A call distributor device as well as the devices to which 19


it distributes calls.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
286
Constants and Status Codes
ClassOfDevice Values

TypeOfDevice Description Value


DEVT_TRUNK_ GROUP A set of trunks providing connectivity to the same place. 20
Individual trunks within the group may be used
interchangeably.

DEVT_OPERATOR_ GROUP Two or more operator devices used interchangeably or 21


addressed identically.

DEVT_CTI_PORT_ SCCP A CTI port on a Unified CM device. 22

DEVT_CTI_PORT_SIP A CTI port on a SIP device. 23

DEVT_OTHER A device that does not fall into any of the preceding 255
categories.

ClassOfDevice Values
This table shows the ClassOfDevice values.

Table 190: ClassOfDevice Values

ClassOfDevice Description Value

DEVC_OTHER A class of device not covered by the following image, data, or voice 10x
classes.

DEVC_IMAGE A device that is used to make digital data calls involving imaging 20x
or high speed circuit switched data in general.

DEVC_DATA A device that is used to make digital data calls (both circuit switched 40x
and packet switched).

DEVC_VOICE A device that is used to make audio calls. 80x

CallPlacementType Values
This table shows the CallPlacementType values.

Table 191: CallPlacementType Values

CallPlacementType Description Value


CPT_UNSPECIFIED Use default call placement. 0

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
287
Constants and Status Codes
CallMannerType Values

CallPlacementType Description Value


CPT_LINE_CALL An inside line call. 1

CPT_OUTBOUND An outbound call. 2

CPT_OUTBOUND_NO_ ACCESS_CODE An outbound call that will not require an access code. 3

CPT_DIRECT_POSITION A call placed directly to a specific position. 4

CPT_DIRECT_AGENT A call placed directly to a specific agent. 5

CPT_SUPERVISOR_ASSIST A call placed to a supervisor for call handling 6


assistance.

CallMannerType Values
This table shows the CallMannerType values.

Table 192: CallMannerType Values

CallMannerType Description Value

CMT_UNSPECIFIED Use default call manner. 0

CMT_POLITE Attempt the call only if the originating device is idle. 1

CMT_BELLIGERENT The call should always be attempted, disconnecting any 2


currently active call.

CMT_SEMI_POLITE Attempt the call only if the originating device is idle or is 3


receiving dial tone.

CMT_RESERVED Reserved 4

CallOption Values
This table shows the CallOption values.

Table 193: CallOption Values

CallOption Description Value

COPT_UNSPECIFIED No call options specified, use defaults. 0

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
288
Constants and Status Codes
ConsultType Values

COPT_CALLING_ AGENT_ONLINE Attempt the call only if the calling agent is “online” 1
(available to interact with the destination party).

COPT_CALLING_ AGENT_RESERVED Obsolete with DMS-100. 2

COPT_CALLING_ AGENT_NOT_ Obsolete with DMS-100. 3


RESERVED

COPT_CALLING_ AGENT_BUZZ_BASE Obsolete with DMS-100. 4

COPT_CALLING_ AGENT_BEEP_HSET Obsolete with DMS-100. 5

COPT_SERVICE_ CIRCUIT_ON Causes a call classifier to be applied to the call 6


(ACM ECS).

ConsultType Values
This table shows the ConsultType values.

Table 194: ConsultType Values

ConsultType Description Value

CT_UNSPECIFIED Default (consult call). 0

CT_TRANSFER Consult call prior to transfer. 1

CT_CONFERENCE Consult call prior to conference. 2

FacilityType Values
This table shows the FacilityType values.

Table 195: FacilityType Values

FacilityType Description Value

FT_UNSPECIFIED Use default facility type. 0

FT_TRUNK_GROUP Facility is a trunk group. 1

FT_SKILL_GROUP Facility is a skill group or split. 2

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
289
Constants and Status Codes
AnsweringMachine Values

AnsweringMachine Values
This table shows the AnsweringMachine values.

Table 196: AnsweringMachine Values

AnsweringMachine Description Value


AM_UNSPECIFIED Use default behavior. 0

AM_CONNECT Connect call to agent when call is answered by an 1


answering machine.

AM_DISCONNECT Disconnect call when call is answered by an answering 2


machine.

AM_NONE Do not use answering machine detection. 3

AM_NONE_NO_ MODEM Do not use answering machine detection, but disconnect 4


call if answered by a modem.

AM_CONNECT_NO_MODEM Connect call when call is answered by an answering 5


machine, disconnect call if answered by a modem.

AnswerDetectMode Values
This table shows the AnswerDetectMode values.

Table 197: AnswerDetectMode Values

AnswerDetectMode Description Value


ADM_UNSPECIFIED Use default behavior. 0

ADM_VOICE_ THRESHOLD Report call answered by an answering machine when 1


initial voice duration exceeds time threshold.

ADM_VOICE_END Report call answered by an answering machine when 2


initial voice segment ends.

ADM_VOICE_END_ DELAY Report call answered by an answering machine after a 3


fixed delay following the end of the initial voice segment.

ADM_VOICE_AND_ BEEP Report call answered by an answering machine after a 4


beep tone following the end of the initial voice segment
(excluding beep tone without any preceding voice).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
290
Constants and Status Codes
AgentWorkMode Values

AnswerDetectMode Description Value


ADM_BEEP Report call answered by an answering machine after a 5
beep tone following the end of the initial voice segment
(including beep tone without any preceding voice).

AgentWorkMode Values
This table shows the AgentWorkMode values.

Table 198: AgentWorkMode Values

AgentWorkMode Description Value

AWM_UNSPECIFIED Use default behavior. 0

AWM_AUTO_IN Agent automatically becomes available after 1


handling a call.

AWM_MANUAL_IN Agent must explicitly indicate availability after 2


handling a call.

RA_CALL_BY_CALL Remote agent Call by Call mode. 3

RA_NAILED_ CONNECTION Remote agent NailedUp mode. 4

DestinationCountry Values
This table shows the DestinationCountry values.

Table 199: DestinationCountry Values

DestinationCountry Description Value

DEST_UNSPECIFIED Unspecified or unknown, use default behavior. 0

DEST_US_AND_ CANADA Call destination is in the United States or Canada. 1

CTI Service Masks


This table shows the CTIService masks.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
291
Constants and Status Codes
CTI Service Masks

Table 200: CTI Service Masks

MaskName Description Value


CTI_SERVICE_ DEBUG Causes all messages exchanged during the 0x80000000
current session to be captured to a file for
later analysis.

CTI_SERVICE_ CLIENT_ EVENTS Client receives call and agent state change 0x00000001
events associated with a specific ACD
phone.

CTI_SERVICE_CALL_ DATA_UPDATE Client may modify call context data. 0x00000002

CTI_SERVICE_ CLIENT_CONTROL Client may control calls and agent states 0x00000004
associated with a specific ACD phone.

CTI_SERVICE_ CONNECTION_ MONITOR Establishment and termination of this 0x00000008


session cause corresponding Unified CCE
Alarm events to be generated.

CTI_SERVICE_ALL_ EVENTS Client receives all call and agent state 0x00000010
change events (associated with any ACD
phone).

CTI_SERVICE_ PERIPHERAL_ MONITOR Client may dynamically add and remove 0x00000020
devices and/or calls that it wishes to receive
call and agent state events for.

CTI_SERVICE_ CLIENT_MONITOR Client receives notification when all other 0x00000040


CTI client sessions are opened and closed,
and may monitor the activity of other CTI
client sessions.

CTI_SERVICE_ SUPERVISOR Client may request supervisor services. 0x00000080

CTI_SERVICE_ SERVER Client identify itself as server application. 0x00000100

CTI_SERVICE_ AGENT_REPORTING Client may reporting/routing ARM(Agent 0x00000400


Reporting And Management) messages.

CTI_SERVICE_ALL_ TASK_EVENTS Client receives all task events. 0x00000800

CTI_SERVICE_ TASK_MONITOR Client receives monitored task events. 0x00001000

CTI_AGENT_STATE_CONTROL_ONLY Client can change agent state only. Call 0x00002000


control is not allowed. If a client requests
for CTI_SERVICE_ CLIENT_CONTROL,
the server may grant this flag to indicate
that only agent state change is allowed.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
292
Constants and Status Codes
Disposition Code Values

MaskName Description Value


Unused 0x00004000

CTI_DEVICE_STATE_CONTROL The client/server wishes to register and get 0x00008000


resource state change requests.

CTI_SERVICE_ UPDATE_EVENTS Requests that this client receive update 0x00080000


notification events. (No data)

CTI_SERVICE_ IGNORE_ DUPLICATE_ Request to suppress duplicate agent state 0x00100000


AGENT_EVENTS events.

CTI_SERVICE_ IGNORE_CONF Do not send confirmations for third party 0x00200000


requests.

CTI_SERVICE_ACD_ LINE_ONLY Request that events for non-ACD lines not 0x00400000
be sent. (Unified CCE only)

Disposition Code Values


This table shows the Disposition Code values.

Table 201: Disposition Code Values

Disposition Code Meaning

1 Abandoned in Network

2 Abandoned in Local Queue

3 Abandoned Ring

4 Abandoned Delay

5 Abandoned Interflow

6 Abandoned Agent Terminal

7 Short

8 Busy

9 Forced Busy

10 Disconnect/drop no answer

11 Disconnect/drop busy

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
293
Constants and Status Codes
Disposition Code Values

12 Disconnect/drop reorder

13 Disconnect/drop handled primary route

14 Disconnect/drop handled other

15 Redirected

16 Cut Through

17 Intraflow

18 Interflow

19 Ring No Answer

20 Intercept reorder

21 Intercept denial

22 Time Out

23 Voice Energy

24 Non-classified Energy Detected

25 No Cut Through

26 U-Abort

27 Failed Software

28 Blind Transfer

29 Announced Transfer

30 Conferenced

31 Duplicate Transfer

32 Unmonitored Device

33 Answering Machine

34 Network Blind Transfer

35 Task Abandoned in Router

36 Task Abandoned Before Offered

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
294
Constants and Status Codes
Disposition Code Values

37 Task Abandoned While Offered

38 Normal End Task

39 Can't Obtain Task ID

40 Agent Logged Out During Task

41 Maximum Task Lifetime Exceeded

42 Application Path Went Down

43 Unified CCE Routing Complete

44 Unified CCE Routing Disabled

45 Application Invalid MRD ID

46 Application Invalid Dialogue ID

47 Application Duplicate Dialogue ID

48 Application Invalid Invoke ID

49 Application Invalid Script Selector

50 Application Terminate Dialogue

51 Task Ended During Application Init

52 Called Party Disconnected

53 Partial Call

54 Drop Network Consult

55 Network Consult Transfer

57 Abandon Network Consult

58 Router Requery Before Answer

59 Router Requery After Answer

60 Network Error

61 Network Error Before Answer

62 Network Error After Answer

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
295
Constants and Status Codes
Agent Service Request Masks

63 Task Transfer

64 Application Disconnected

65 Task Transferred on Agent Logout

Agent Service Request Masks


This table shows the Agent Service Request masks.

Table 202: Agent Service Request Masks

DestinationCountry Description Value

OUTBOUND_SUPPORT The agent login can support outbound feature. 0x1

Silent Monitor Status Values


This table shows the Silent Monitor Status Values.

Table 203: Silent Monitor Status Values

DestinationCountry Description Value

SILENT_MONITOR_ NONE Normal call (non-silent monitor call). 0

SILENT_MONITOR_ INITIATOR Initiator of silent monitor call. 1

SILENT_MONITOR_ TARGET Monitor target of silent monitor call. 2

Agent Internal States Message Values


This table shows the Agent’s Internal States and their Message Values.

Table 204: Agent’s Internal States and their Status Values

State Name Description Value

AGENT_STATE_LOGIN The agent has logged on to the ACD. It does not 0


necessarily indicate that the agent is ready to accept calls.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
296
Constants and Status Codes
TaskState Values

AGENT_STATE_LOGOUT The agent has logged out of the ACD and cannot accept 1
any additional calls.

AGENT_STATE_NOT_READY The agent is unavailable for any call work. 2

AGENT_STATE_AVAILABLE The agent is ready to accept a call. 3

AGENT_STATE_TALKING The agent is currently talking on a call (inbound, 4


outbound, or inside).

AGENT_STATE_WORK_NOT_READY The agent is performing after call work, but will not be 5
ready to receive a call when completed.

AGENT_STATE_WORK_READY The agent is performing after call work, but will be ready 6
to receive a call when completed.

AGENT_STATE_BUSY_OTHER The agent is busy performing a task associated with 7


another active SkillGroup.

AGENT_STATE_ACTIVE The agent state is currently active. 11

TaskState Values
This table shows the TaskState values that may appear in SNAPSHOT_TASK_RESP messages.

Table 205: TaskState Values

State Name Description Value


TASK_STATE_PRE_CALL Pre Call Message has been sent to 0
client.

TASK_STATE_ACTIVE Task is actively being worked on; 1


Start Task has been received for
this task.

TASK_STATE_WRAPUP Wrap up task has been received for 2


this task.

TASK_STATE_PAUSED Task is paused; Pause Task has 3


been received for this task.

TASK_STATE_OFFERED Offer Task has been received for 4


this task.

ASK_STATE_INTERRUPTED Task is interrupted; Agent Interrupt 5


Accepted Ind is received.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
297
Constants and Status Codes
TaskState Values

State Name Description Value


TASK_STATE_NOT_READY Not used. 6

TASK_STATE_LOGGED_OUT Task is terminated. 7

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
298
CHAPTER 7
Changes and Additions
• Protocol Version 21, page 299
• Protocol Version 20, page 300
• Protocol Version 19, page 301
• Protocol Version 18, page 301
• Protocol Version 17, page 301
• Protocol Version 16, page 302
• Protocol Version 15, page 302
• Protocol Version 14, page 302
• Protocol Versions 10-13, page 304
• Protocol Version 9, page 306
• Protocol Version 8, page 306
• Protocol Version 7, page 308
• Protocol Version 6, page 308
• Protocol Version 5, page 310

Protocol Version 21
Following is a list of changes made in Protocol Version 21:
• Added NumMRDs, FLTAgentMRDID, and FltAgentMRDState under CONFIG_AGENT_EVENT.
• Added a new Message with the type 259. This Message is reserved for internal use only.
• Changed the behavior of the PeripheralType field in the OPEN_CONF message.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
299
Changes and Additions
Protocol Version 20

Protocol Version 20
Following is a list of additional changes made in Protocol Version 20 (Unified CCE Release11.5(1)):

Important In the CTI Server Protocol Version 20 the floating field tag and length size changed from 1 byte to 2 byte
USHORT.

• Added the fixed AgentSkillTargetID and floating AgentID fields to the AGENT_PRE_CALL_EVENT
message.
• Added the CONFIG_MRD_EVENT message.
◦Added bit mask value 32=Media Routing Domain Information to the CONFIG_REQUEST_EVENT
message ConfigInformation field. Added a cross-reference to this field from the OPEN_REQ
message ConfigMsgMask field.
◦Added bit mask value 32=Media Routing Domain Information to the CONFIG_BEGIN_EVENT
message ConfigInformation field.
◦Added the MR_DOMAIN_ID_TAG, DESCRIPTION_TAG, ENTERPRISE_NAME_TAG,
MAX_TASK_DURATION_TAG, AND INTERRUPTIBLE_TAG to the event
CONFIG_MRD_EVENT.

• Added that the AGENT_PRE_CALL_ABORT_ EVENT message is sent to the to ALL_EVENTS client.
• Added the following values to the Tag Values table:
◦SSO_ENABLED_TAG for the CONFIG_AGENT_EVENT and SET_AGENT_STATE_REQ
◦FLT_TASK_ID_TAG for the AGENT_TASKS_RESP message
◦FLT_ICM_DISP_TAG and FLT_APP_DISP_TAG for the MEDIA_LOGOUT_IND message

• For the CONFIG_AGENT_EVENT message, the length of the LoginName field is increased to 255
Bytes.
• Floating field subfields have changed:
◦The Tag subfield is a Data Type of USHORT and a Byte Size of 2.
◦The FieldLength subfield is a Data Type of USHORT and a Byte Size of 2.

• Added or modified these tags in the Tag Values table for the SNAPSHOT_TASKS_RESP message:
SCRIPT_SELECTOR_TAG , APPLICATION_STRING1_TAG, APPLICATION_STRING2_TAG,
CALL_VAR_1_TAG through CALL_VAR_10_TAG, NAMED_VARIABLE_ TAG,
NAMED_ARRAY_TAG.
• Added new TaskState Values that may appear in SNAPSHOT_TASK_RESP messages.
• Added the following values to the Disposition Codes table for nonvoice tasks:
◦63=Task Transferred
◦64=Application Disconnected

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
300
Changes and Additions
Protocol Version 19

◦65=Task Transferred on Agent Logout

Protocol Version 19
The following is a list of changes made for CTI Server in Protocol Version 19:
• Updated Message Types in Messaging Conventions chapter.
• Added Configuration Acquisition Messages section in Application Level Interfaces chapter.
• Added row containing INTERNAL_AGENT_STATE_TAG to Tag Values. Table Tag Values.
• Added values 27 to 37 for outbound call types to CallType Values CallType Values, on page 275.
• Added row containing InternalAgentState to QUERY_AGENT_STATE CONF Message Form to Table
Message Types.
• Added Agent’s Internal States and their Status Values to Table Agent Internal States Message Values.
• Removed the ClientAddressIPV6 and SendingAddressIPV6 elements and the
CLIENT_ADDRESS_IPV6_TAG (226) and SENDING_ADDRESS_IPV6_TAG(227) tags due to a
change in the handling of IPv6 addresses.
• Changed ClientAddress and SendingAddress elements’ size from 16 byte to 64 byte to support IPv6
addresses.
• Added the DepartmentID field to the following messages:
◦OPEN_CONF
◦AGENT_STATE_EVENT
◦AGENT_TEAM_CONFIG_EVENT
◦QUERY_AGENT_STATE_CONF

Protocol Version 18
The following is a list of changes made for CTI Server in Protocol Version 18 (Unified CCE version 10.0(1)
- internal use only):
• Added values 247 to 254 to Tag Values Table Tag Values.

Protocol Version 17
The following is a list of changes made for CTI Server in Protocol Version 17 (Unified CCE version 9.0(1)
- internal use only):
Added row containing OPTIONS_TAG to Tag Values Table Tag Values.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
301
Changes and Additions
Protocol Version 16

Protocol Version 16
The following is a list of changes made for CTI Server in Protocol Version 16 (Unified CCE verion 9.0(1)).
• Added Agent TeamName to AGENT_TEAM_CONFIG_EVENT Table Supervisor Service
Added AGENT_TEAM_NAME_TAG(243) to Table Tag Values
Added Direction to AGENT_STATE_EVENT Table Tag Values
Added DIRECTION_TAG(244) to Table Tag Values

Protocol Version 15
The following is a list of additions and changes made to the CTI Server in Protocol Version 15 (Unified CCE
Version 8.5(x)).
• Added three message types to Table Tag Values.
Added CALL_AGENT_GREETING_MASK to Table Unsolicited Call Event Message Masks.
Added CALL_AGENT_GREETING_EVENT in Table Unsolicited Call Event Message Masks.
Added AGENT_GREETING_CONTROL_REQ in Table Message Types.
Added AGENT_GREETING_CONTROL_CONF in Table Message Types.
Added CF_AGENT_GREETING_CONTROL_OPERATION_FAILURE Extended Control Failure
Code to Table ControlFailureCode Values.

Protocol Version 14
The following is a list of additions and changes made to the CTI Server in Protocol Version 14 (Unified CCE
Version 8.0(x)).
• Changed the VersionNumber field in OPEN_REQ to 14 from 13.
Added new floating field tags to Table Tag Values:
◦REQUESTING_DEVICE_ID_TAG (219)
REQUESTING_DEVICE_ID_TYPE_TAG (220)
PRE_CALL_INVOKE_ID_TAG (221)
ENTERPRISE_QUEUE_TIME (222)
CALL_REFERENCE_ID_TAG (223)
MULTI_LINE_AGENT_CONTROL_TAG (224)
NETWORK_CONTROLLED_TAG (225)
CLIENT_ADDRESS_IPV6_TAG (226)
SENDING_ADDRESS_IPV6_TAG(227)
NUM_PERIPHERALS_TAG(228)

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
302
Changes and Additions
Protocol Version 14

COC_CONNECTION_CALL_ID_TAG(229)
COC_CALL_CONNECTION_DEVICE_ID_TYPE_TAG(230)
COC_CALL_CONNECTION_DEVICE_ID_TYPE_TAG(231)
CALL_ORIGINATED_FROM_TAG(232)
SET_APPDATA_CALLID_TAG(233)
CLIENT_SHARE_KEY_TAG(234)

• Added SkillGroupNumber field to MAKE_CALL_REQ.


• Added RouterCallKeyDay, RouterCallKeyCallID, and RouterCallKeySequenceNumber fields to
SET_CALL_DATA.
• Added floating CallTypeID field and floating PreCallInvokeID field to AGENT_PRE_CALL_EVENT
and SET_APP_DATA.
• Added CallReferenceIDfield (for solution call trace) to BEGIN_CALL_EVENT,
CALL_DATA_UPDATE_EVENT, and SNAPSHOT_CALL_CONF.
• Added optional parms RequestingDeviceID and RequestingDeviceIDType to
CLEAR_CONNECTION_REQ.
• Added DEVID_NON_ACD_DEVICE_IDENTIFIER and DEVID_SHARED_DEVICE_IDENTIFIER
to Table DeviceIDType Values.
• Added non ACD line types LINETYPE_NON_ACD_IN and LINETYPE_NON_ACD_OUT to Table
LineType Values.
• Added calltype CALLTYPE_NON_ACD (27) to Table CallType Values.
• Added the NumPeripherals, FltPeripheralID, and MultilineAgentControl fields to OPEN_CONF.
• Added the following status codes to Table PGStatusCode Values, on page 266:
◦E_CTI_INVALID_CONFIG_MSG_MASK
◦E_CTI_AUTO_CONFIG_RESET
◦E_CTI_INVALID_MONITOR_STATUS
◦E_CTI_INVALID_REQUEST_ID_TYPE

• Added the following ControlFailureCode values to Table ControlFailureCode Values:


◦CF_INVALID_TRUNK_ID_SPECIFIED
◦CF_SPECIFIED_EXTENSION_ALREADY_IN_USE
◦CF_ARBITRARY_CONF_OR_XFER_NOT_SUPPORTED
◦CF_NETWORK_TRANSFER_OR_CONSULT
◦CF_NETWORK_TRANSFER_OR_CONSULT_FAILED
◦CF_DEVICE_RESTRICTED
◦CF_LINE_RESTRICTED
◦CF_AGENT_ACCOUNT_LOCKED_OUT

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
303
Changes and Additions
Protocol Versions 10-13

◦CF_ARBITRARY_CONF_OR_XFER_NOT_SUPPORTED
◦CF_MAXIMUM_LINE_LIMIT_EXCEEDED
◦CF_SHARED_LINES_NOT_SUPPORTED
◦CF_EXTENSION_NOT_UNIQUE

• Added CTI_SERVICE_ACD_LINE_ONLY and CTI_SERVICE_IGNORE_CONF to Table CTI Service


Masks, on page 291.
• Added the ClientAddressIPV6 field to the following events:
◦RTP_STARTED_EVENT
RTP_STOPPED_EVENT
CLIENT_SESSION_OPENED_EVENT
CLIENT_SESSION_CLOSED_EVENT
EMERGENCY_CALL_EVENT
START_RECORDING_REQ
START_RECORDING_CONF
STOP_RECORDING_REQ
STOP_RECORDING_CONF

• Added the SendingAddressIPV6 field to RTP_STARTED_EVENT and RTP_STOPPED_EVENT.


• Added the COCConnectionCallID, COCCallConnectionDeviceIDType, and COCCallConnectionDeviceID
fields to CALL_SERVICE_INITIATED_EVENT and SNAPSHOT_CALL_CONF.
• Added device types DEVT_CTI_PORT_SCCP, and DEVT_CTI_PORT_SIP to Table TypeOfDevice
Values, on page 286.

Protocol Versions 10-13


The following is a list of additions and changes made to the CTI Server in Protocol Versions 10-13 (ICM
Version 7.0(x).
• Added New Types to Existing Tables, New fields to existing Messages, New fields added to existing
messages
• Added following fields to AGENT_STATE_EVENT: Duration (optional), NextAgentState,
FltSkillGroupNumber, FltSkillGroupID, FltSkillGroupPriority, FltSkillGroupState
• Changed Version Number in OPEN_REQ to 13 from 6.
• Added DeviceIDType to SNAPSHOT_CALL_REQ to allow for Queues and Agent extensions with the
same number.
• Added ForcedFlag and AgentServiceReq to SET_AGENT_STATE_REQ
• Added CTI_AGENT_STATE_CONTROL_ONLY, CTI_DEVICE_STATE_CONTROL, CTI_ROUTING,
CTI_SERVICE_MINIMIZE_EVENTS, CTI_SERVICE_CONFIG_EVENTS,

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
304
Changes and Additions
Protocol Versions 10-13

CTI_SERVICE_UPDATE_EVENTS, and CTI_SERVICE_IGNORE_DUPLICATE_AGENT_EVENTS


in the CTI Service Masks table.
• Corrected CALL_QUEUED_EVENT scenarios to reflect a QueueDeviceIDType of DEVID_NONE
and remove the QueueDeviceID floating field.
• Added DEVID_QUEUE to the device ID type table.
• Removed CallsInQueue from the QUERY_AGENT_STATISTICS_CONF message.
• In CALL_DELIVERED_EVENT, changed AlertingDevice to required.
• Removed Duplicate tag SKILL_GROUP_PRIORITY_TAG.
• Added DEVICE_TYPE_TAG to the tag value table.
• Removed OldestCallInQueue from the QUERY_AGENT_STATISTICS_CONF message.
• Added AgentAvailabilityStatus to QUERY_AGENT_STATE_CONF and AGENT_STATE_EVENT.
• Added AgentsICMAvailable, and AgentsApplicationAvailable to
QUERY_SKILL_GROUP_STATISTICS_CONF.
• Added ICMAvailableTimeSession, RoutableTimeSession, ICMAvailableTimeToday, and
RoutableTimeToday to QUERY_AGENT_STATISTICS_CONF.
• Added AGENT_UDPATED_EVENT and QUEUE_UPDATED_EVENT to the message type table.
The individual messages were covered but they were missing from the table.
• Corrected EMERGENCY_CALL_CONF table.
• Changed PauseDuration in SEND_DTMF_SIGNAL_REQ from USHORT to UINT. The type was
mistakenly changed and there is special code to cover the backward compatibility.
• Added EventDeviceType and EventDeviceID in SYSTEM_EVENT to allow specifying a non-numeric
device on the in and out of service events.
• Corrected CustomerPhoneNumber, and CustomerAccountNumber to be optional in
CALL_DATA_UPDATE_EVENT and SET_CALL_DATA_REQ
• Added NumFltSkillGroups field and floating fields for FltSkillGroupNumber, FltSkillGroupID,
FltSkilllGroupState, and FltSkillGroupPriority to allow specifying more than 1 skill group in the event
to AGENT_STATE_EVENT
• Added RA_CALL_BY_CALL and RA_NAILED_CONNECTION in AgentWorkMode table.
• Updated following messages with new fields:
◦AGENT_STATE_EVENT: NextAgentState, Duration
◦CALL_DEQUEUED_EVENT: DeQueueType
◦OPEN_REQ: EventMsgMask
◦RTP_STARTED_EVENT: SendingAddress, SendingPort
◦RTP_STOPPED_EVENT: SendingAddress, SendingPort
◦SET_AGENT_STATE_REQ: ForcedFlag

• Updated tables with various new values.


• Updated tables with various new values.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
305
Changes and Additions
Protocol Version 9

Protocol Version 9
The following is a list of additions and changes made to the CTI Server in Protocol Version 9 (ICM Version
5.0).
• Added Server Service. See the section “Server Service” in Chapter 5, “Application Level Interfaces.”
• Added the CampaignID and QueryRuleID fields to the SET_CALL_DATA_REQ and
CALL_DATA_UPDATE_EVENT messages.
• During an OPEN_REQ of an ALL_EVENTS client session, additional SYSTEM_EVENTs are now
sent to the ALL_EVENTS client to indicate the status of each peripheral associated with the PG.
• Added AgentAvailabilityStatus and ICMAgentID fields to QUERY_AGENT_STATE_CONF and
AGENT_STATE_EVENT.
• Added field AgentsICMAvailable and AgentsApplicationAvailable to
QUERY_SKILL_GROUP_STATISTICS_CONF.
• Added fields ICMAvailableTimeSession, RoutableTimeSession, ICMAvailableTimeToday, and
RoutableTimeToday to QUERY_AGENT_STATISTICS_CONF.
• Added ICMAgentID, AgentExtension, AgentID, and AgentInstrument fields to
QUERY_AGENT_STATE_REQ.
• Updates to several tables in Chapter 6, “Constants and Status Codes.”

Protocol Version 8
The following is a list of additions and changes made to the CTI Server in Protocol Version 8 (ICM Version
4.6).
• Moved the RTP_STARTED_EVENT and RTP_STOPPED_EVENT messages to the ClientEvents
Service.
• Added AgentInstrument optional field to the following messages:
◦ALTERNATE_CALL_REQ
◦CLEAR_CALL_REQ
◦CONFERENCE_CALL_REQ
◦DEFLECT_CALL_REQ
◦HOLD_CALL_REQ
◦RECONNECT_CALL_REQ
◦RETRIEVE_CALL_REQ
◦TRANSFER_CALL_REQ
◦SEND_DTMF_SIGNAL_REQ

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
306
Changes and Additions
Protocol Version 8

• Added CalledPartyDisposition field to the BEGIN_CALL_EVENT, CALL_DATA_UPDATE_EVENT,


and SNAPSHOT_CALL_CONF messages.
• Added CallType and CalledPartyDisposition fields to the SET_CALL_DATA_REQ message.
• Added BlendedAgent support.
• Add CALLTYPE_PREVIEW and CALLTYPE_RESERVATION call types (see table CallType Values,
on page 275).
• Add CallType and/or CalledPartyDisposition fields to the set_call_data_req, BEGIN_CALL_EVENT,
CALL_DATA_ UPDATE_EVENT, and snapshot_call_conf messages.
• Added CampaignID and QueryRuleID fields to the SET_CALL_DATA_REQ and
CALL_DATA_UPDATE_EVENT messages.
• Add real time and 5 minutes fields to the query_skill_group_statistics_conf message.
• Add new AutoOut, Preview, and Reservation call metrics to the query_AGENT_statistics_conf and
query_skill_group_statistics_conf messages.
• Added SessionID field to the AGENT_STATE_EVENT message.
• Add new BargeIn, Intercept, Monitor, Whisper, and Emergency call metrics to the
query_AGENT_statistics_conf and query_skill_group_statistics_conf messages.
• Added Supervisor services. See Supervisor Service in Chapter 5, “Application Level Interfaces.”
• Added the following new messages:
◦SET_DEVICE_ATTRIBUTES_REQ / CONF
◦SUPERVISOR_ASSIST_REQ/CONF
◦EMERGENCY_CALL_REQ/CONF
◦SUPERVISE_CALL_REQ/CONF
◦AGENT_TEAM_CONFIG_REQ/CONF/EVENT
◦SET_APP_DATA_REQ/CONF
◦AGENT_DESK_SETTINGS_REQ/CONF
◦LIST_AGENT_TEAM_REQ/CONF
◦MONITOR_AGENT_TEAM_START_REQ/CONF
◦MONITOR_AGENT_TEAM_STOP_REQ/CONF
◦BAD_CALL_REQ/CONF
◦SET_DEVICE_ATTRIBUTES_REQ/CONF
◦REGISTER_SERVICE_REQ/CONF
◦UNREGISTER_SERVICE_REQ/CONF
◦START_RECORDING_REQ/CONF
◦STOP_RECORDING_REQ/CONF

• Added the CustomerPhoneNumber, and CustomerAccountNumber fields. Developers may receive these
fields in the CALL_DATA_UPDATE_EVENT messages.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
307
Changes and Additions
Protocol Version 7

Protocol Version 7
The following is a list of additions and changes made to the CTI Server in Protocol Version 7 (ICM Version
4.5).
• Added the RTP_STARTED_EVENT and RTP_STOPPED_EVENT messages
• Added skill group parameters to the CALL_DELIVERED_EVENT message.
• Added LineHandle and LineType parameters to the CALL_REACHED_NETWORK_EVENT message.

Protocol Version 6
The following is a list of additions and changes made to the CTI Server in Protocol Version 6 (ICM Version
4.1).
• Added the NAMEDVAR and NAMEDARRAY data types.
• Added ICRCentralControllerTime and SystemCapabilities fields to the OPEN_CONF and
SYSTEM_EVENT messages.
• System Events Service renamed to Miscellaneous Services.
• NamedVariable and NamedArray optional fields added to the following messages:
◦BEGIN_CALL_EVENT
◦CALL_DATA_UPDATE_EVENT
◦CALL_TRANSLATION_ROUTE_EVENT
◦SET_CALL_DATA_REQ
◦CONFERENCE_CALL_REQ
◦CONSULTATION_CALL_REQ
◦MAKE_CALL_REQ
◦MAKE_PREDICTIVE_CALL_REQ
◦TRANSFER_CALL_REQ
◦SNAPSHOT_CALL_CONF

• EventReasonCode field added to the AGENT_STATE_EVENT message.


• AGENT_PRE_CALL_EVENT and AGENT_PRE_CALL_ABORT_EVENT messages added .
• New messages added to Miscellaneous Services:
◦USER_MESSAGE_REQ/CONF
◦USER_MESSAGE_EVENT
◦SUPERVISOR_ASSIST_REQ/CONF
◦EMERGENCY_CALL_REQ/CONF

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
308
Changes and Additions
Protocol Version 6

◦QUERY_AGENT_STATISTICS_REQ/CONF
◦QUERY_SKILL_GROUP_STATISTICS_REQ/CONF

• AgentExtension and AgentID fields added tothe QUERY_AGENT_STATE_REQ message.


• New values SYS_CTI_SERVER_OFFLINE, SYS_CTI_SERVER_ONLINE, and
SYS_HALF_HOUR_CHANGE added to SystemEventID Values table (Table SystemEventID Values,
on page 250).
• Maximum length of all instances of the AgentInstrument field increased from 12 to 64 bytes.
• SystemCapabilities field removed from the OPEN_CONF and SYSTEM_EVENT messages.
• NumNamedVariables and NumNamedArrays fixed fields added to all messages that contain the
NamedVariable and NamedArray floating fields.
• Supervisor Service removed.
• Queue information added to the QUERY_SKILL_GROUP_STATISTICS_CONF message.
• AgentInstrument field added to QUERY_AGENT_STATE_CONF message.
• Added the following fields to the QUERY_DEVICE_INFO_CONF message:
◦MaxActiveCalls
◦MaxHeldCalls
◦MaxDevicesInConference
◦MakeCallSetup
◦TransferConferenceSetup
◦CallEventsSupported
◦CallControlSupported
◦OtherFeaturesSupported

• New PGStatus code values PGS_CTI_SERVER_OFFLINE and PGS_LIMITED_FUNCTION added


to the PGStatusCode table (Table PGStatusCode Values, on page 266).
• Added HandledCallsAfterCallTimeSession and HandledCallsAfterCallTimeToday fields to the
QUERY_AGENT_STATISTICS_CONF message.
• Added HandledCallsAfterCallTimeToHalf and HandledCallsAfterCallTimeToday fields to the
QUERY_SKILL_GROUP_STATISTICS_CONF message.
• New Transfer/Conference Setup Mask values CONF_SETUP_SINGLE_ACD_CALL,
TRANS_SETUP_SINGLE_ACD_CALL, and TRANS_SETUP_ANY_SINGLE_CALL added to the
QUERY_DEVICE_INFO_CONF message.
• New SystemEventIDs SYS_INSTRUMENT_OUT_OF_SERVICE and
SYS_INSTRUMENT_BACK_IN_SERVICE added to the SystemEventID Values table (Table
SystemEventID Values, on page 250).
• Added REGISTER_VARIABLES_REQ and REGISTER_VARIABLES_CONF messages.
• Added MonitorID field to AGENT_PRECALL_EVENT and AGENT_PRECALL_ABORT_EVENT
messages.

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
309
Changes and Additions
Protocol Version 5

• PeripheralID field added to the USER_MESSAGE_REQ message.


• Updated StatusCodes table (Table Failure Indication Message Status Codes, on page 244).
• New LineTypes LINETYPE_OUTBOUND and LINETYPE_DID added to the LineTypes table (Table
6-14 LineType Values).
• Added ServiceNumber, ServiceID, SkillGroupNumber, SkillGroupID, and SkillGroupPriority fields to
AGENT_PRECALL_EVENT message.
• Added note for CALL_ESTABLISHED_EVENT for Spectrum ACDs.
• Added /CCT (Call Control Table) optional field to the MAKE_CALL_REQ and
MAKE_PREDICTIVE_CALL_REQ messages.

Protocol Version 5
The following is a list of additions and changes made to the CTI Server in Protocol Version 5 (ICM Version
4.0).
• Added Peripheral Monitor service and related messages.
• Added a new MonitorID field to all Call and Agent Event messages.
• Added Client Monitor service and related messages.
• Added CallingDeviceType and CallingDeviceID fields to the CALL_SERVICE_INITIATED_EVENT
message.
• Increased the maximum number of skill groups from 10 to 20.
• Added AlertRings, CallOption, AuthorizationCode, and AccountCode fields to the
CONSULTATION_CALL_REQ, MAKE_CALL_REQ, and TRANSFER_CALL_REQ messages.
• Readded MAKE_PREDICTIVE_CALL_REQ and MAKE_PREDICTIVE_CALL_CONF messages.
• Added new SYS_PERIPHERAL_GATEWAY_OFFLINE System Event ID to the SystemEventID
Values table (Table PeripheralType Values, on page 267).
• Added new AM_NONE, AM_NONE_NO_MODEM and AM_CONNECT_NO_MODEM
AnsweringMachine values to the AnsweringMachine Values table (Table AnsweringMachine Values,
on page 290).
• ANSWER_CALL_REQ message (Table SystemEventID Values, on page 250) revised for peripherals
that do not provide alerting call identification.
• Added fields for single step conference to the CONFERENCE_CALL_REQ message:
◦CallPlacementType
◦CallMannerType
◦AlertRings
◦CallOption
◦FacilityType
◦Priority

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
310
Changes and Additions
Protocol Version 5

◦PostRoute
◦DialedNumber
◦UserToUserInfo
◦CallVariable1 – CallVariable10
◦CallWrapupData
◦FacilityCode
◦AuthorizationCode
◦AccountCode

• Replaced the AgentInstrument field in the MAKE_PREDICTIVE_CALL_REQ message with the


OriginatingDevice field.
• Added the following new fields to the MAKE_PREDICTIVE_CALL_REQ message:
◦AnswerDetectMode
◦AnswerDetectTime
◦AnswerDetectControl1
◦AnswerDetectControl2
◦DestinationCountry
◦OriginatingLineID

• PeripheralOnline field added to the OPEN_CONF message.


• ClientPort field added to the CLIENT_SESSION_OPENED_EVENT and
CLIENT_SESSION_CLOSED_EVENT messages.
• Optional AgentInstrument field added to the CLEAR_CONNECTION_REQ message.
• AnsweringMachine field added to the CONFERENCE_CALL_REQ and TRANSFER_CALL_REQ
messages.
• Optional AgentInstrument field added to the CONSULTATION_CALL_REQ message.
• Added the symbolic constant NULL_CALL_ID to the Special Values table (Table Special Values Special
Values).
• New peripheral types PT_SIEMENS_9005 and PT_ALCATEL added to the PeripheralType Values
table (Table PeripheralType Values).

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise, Release
11.6(1)
311
Changes and Additions
Protocol Version 5

CTI Server Message Reference Guide (Protocol Version 21) for Cisco Unified Contact Center Enterprise,
Release 11.6(1)
312

You might also like