CALL_CONFERENCED_EVENT

The joining of calls into a conference call causes a CALL_CONFERENCED_EVENT message, defined in the following tables, to be sent to the client. Unified CCX MUST ensure that the CALL_CONFERENCED_EVENT is sent after any DELIVERED events for the secondary call, even in the case of a blind conference call.

CALL_CONFERENCED_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.

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 ConnectedPartyCallID, ConnectedPartyDeviceType, and ConnectedPartyDeviceID floating fields present in the floating part of the message.

USHORT

2

SecondaryDeviceType

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

USHORT

2

SecondaryCallID

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

UINT

4

ControllerDeviceType

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

USHORT

2

AddedPartyDeviceType

Indicates device ID type supplied in the AddedPartyDeviceID 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_CONFERENCED_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

ControllerDeviceID[37] (required)

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

STRING

64

AddedPartyDeviceID[38] (optional)

The device ID of the device added to the call. 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 conference call parties. There can be more than one ConnectedPartyCallID field in the message (see the preceding TypeParties field description).

UINT

4

ConnectedPartyDeviceType[40] (optional)

The device ID type supplied in the following ConnectedPartyDeviceID floating field. See ConnectionDeviceType Values.

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 conference call parties. See DeviceType Values.

There can be more than one ConnectedPartyDeviceID field in the message (see the preceding TypeParties 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