Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 278
5-30
CTI Server Message Reference Guide (Protocol Version 9) Release 7.0(0)
Chapter 5      Application Level Interfaces
Client Events Service
AGENT_STATE_EVENT
The CTI Server may send an AGENT_STATE_EVENT message to the CTI client when an agent state 
change occurs (such as logging on or becoming available to handle incoming calls). The 
AGENT_STATE_EVENT message is defined in 
SkillGroupID
The ICM SkillGroupID of the 
agent SkillGroup the call is 
attributed to. May contain the 
special value NULL_ SKILL_ 
GROUP (
) when not 
applicable or not available.
UINT
4
SkillGroupPriority
The priority of the skill group, 
or 0 when skill group priority is 
not applicable or not available.
USHORT
2
CallingDeviceType
The type of the device identifier 
supplied in the CallingDevice 
ID 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
CallingDeviceID 
(optional)
The device ID of the calling 
device.
STRING
64
Maximum message size (including header):
184
Table 5-16
CALL_SERVICE_INITIATED_EVENT Message Format 
Table 5-17
AGENT_STATE_EVENT Message Format 
Fixed Part
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 caused this 
message to be sent to the client, or 
zero if there is no monitor 
associated with the event (All 
Events Service).
UINT
4