CALL_TRANSFERRED_EVENT

The transfer of a call to another destination causes a CALL_TRANSFERRED_EVENT message, defined in the following tables, to be sent to the client.

A CALL_TRANSFERRED_EVENT must always be sent AFTER any corresponding CALL_DELIVERED_EVENT for the secondary call.

CALL_TRANSFERRED_EVENT Fixed Part Message Body Format

Fixed part

Field name

Value

Data type

Byte size

reserved

This value is set to 0.

UINT

4

reserved

This value is set to 1.

UINT

4

reserved

This value is set to 21.

USHORT

2

PrimaryDeviceType

Indicates the connection type supplied in the PrimaryDeviceID floating field. See ConnectionDeviceType Values.

USHORT

2

PrimaryCallID

The Call ID value that Unified CCX assigned to the primary call.

UINT

4

reserved

This value is set to 0xffff.

USHORT

2

lineType (Version 14 and later)

The type of line that helps to identify a business call or a non-business call. This value is set to 3 for a business call and 10 for a non-business call.

USHORT

2

reserved

This value is set to 0xffffffff.

UINT

4

reserved

This value is set to 0xffffffff.

UINT

4

reserved

This value is set to 0.

USHORT

2

NumParties

The number of active connections associated with this conference call, up to a maximum of 16.

This value also indicates the number of the ConnectedPartyCallID, the ConnectedPartyDeviceType, and the ConnectedPartyDeviceID floating fields present in the floating part of the message.

USHORT

2

SecondaryDeviceType

Indicates the connection type supplied in the SecondaryDeviceID floating field. See ConnectionDeviceType Values.

USHORT

2

SecondaryCallID

The Call ID value that Unified CCX assigned to the secondary call.

UINT

4

TransferringDeviceType

Indicates the device ID type supplied in the TransferringDeviceID floating field. See DeviceType Values.

USHORT

2

TransferredDeviceType

Indicates the device ID type supplied in the TransferredDeviceID floating field. See DeviceType Values.

USHORT

2

LocalConnectionState

The local end state of the connection. For more information, see LocalConnectionState (LCS) Values.

USHORT

2

EventCause

Indicates a reason or explanation for the event occurrence. See Call EventCause (CEC) Values.

USHORT

2

CALL_TRANSFERRED_EVENT Floating Part Message Body Format

Floating part

Field name

Value

Data type

Maximum size

PrimaryDeviceID[35] (required)

The device ID of the primary call connection. In CTI Protocol Version 14, the general rules for the Primary.Actual Field Format will apply to this field.

STRING

64

SecondaryDeviceID[36] (required)

The device ID of the secondary call connection. In CTI Protocol Version 14, the general rules for the Primary.Actual Field Format will apply to this field.

STRING

64

TransferringDeviceID[42] (required)

The device ID of the device that transferred the call. In CTI Protocol Version 14, the general rules for the Primary.Actual Field Format will apply to this field.

STRING

64

TransferredDeviceID[43] (required)

The device ID of the device to which the call was transferred. In CTI Protocol Version 14, the general rules for the Primary.Actual Field Format will apply to this field.

STRING

64

ConnectedPartyCallID[39] (optional)

The Call ID value assigned to one of the call parties. There can be more than one ConnectedPartyCallID field in the message (see the preceding NumParties field description).

UINT

4

ConnectedPartyDeviceType[40] (optional)

Indicates the type of the device ID supplied in the following ConnectedPartyDeviceID floating field. There can be more than one ConnectedPartyDeviceType field in the message (see the preceding TypeParties field description). This field always immediately follows the corresponding ConnectedPartyCallID field.

USHORT

2

ConnectedPartyDeviceID[41] (optional)

The device ID of one of the call parties. There can be more than one ConnectedPartyDeviceID field in the message (see the preceding NumParties field description). This field always immediately follows the corresponding ConnectedPartyDeviceType field. In CTI Protocol Version 14, the general rules for the Primary.Actual Field Format will apply to this field.

STRING

64