CONFERENCE_CALL_REQ

The CONFERENCE_CALL_REQ message, defined in the following tables, allows a client 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.

CONFERENCE_CALL_REQ Fixed Part Message Body Format

Fixed part

Field name

Value

Data type

Byte size

InvokeID

An ID for this request message that is returned in the corresponding confirm message.

UINT

4

reserved

Set this value to 1.

UINT

4

HeldCallID

The Call ID value assigned to the call held by Unified CCX.

UINT

4

ActiveCallID

The Call ID value assigned to the active call by Unified CCX.

UINT

4

HeldConnectionDeviceType

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

USHORT

2

ActiveConnectionDeviceType

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

USHORT

2

reserved

Set this value to 0.

USHORT

2

reserved

Set this value to 0.

USHORT

2

reserved

Set this value to 0.

USHORT

2

reserved

Set this value to 0.

USHORT

2

reserved

Set this value to 0.

USHORT

2

reserved

Set this value to 0.

USHORT

2

reserved

Set this value to 0.

BOOL

2

reserved

Set this value to 0.

BOOL

2

NumNamedVariables

The number of NamedVariable floating fields present in the floating part of the message.

USHORT

2

NumNamedArrays

The number of NamedArray floating fields present in the floating part of the message.

USHORT

2

CONFERENCE_CALL_REQ Floating Part Message Body Format

Floating part

Field name

Value

Data type

Maximum size

ActiveConnectionDeviceID[50] (required)

The ID of the active call connection.

STRING

64

HeldConnectionDeviceID[53] (optional)

The ID of the held call connection. Either a HeldConnectionDeviceID or DialedNumber is required.

STRING

64

AgentInstrument[6] (required)

The agent’s IP phone number.

STRING

64

DialedNumber[11] (optional)

The number to be dialed. Either a HeldConnectionDeviceID or DialedNumber is required.

STRING

40

CallVariable1[13] (optional)

Call-related variable data.

STRING

40

CallVariable2[14]. through CallVariable9[21] (optional)

CallVariable10[22] (optional)

Call-related variable data.

STRING

40

CallWrapupData[46] (optional)

Call-related wrapup data.

Note

This field is not supported for the CTI clients that connect with version 17 and above. The Wrap-Up Reason value is now expected in the NamedArray field with a key value.

STRING

40

NamedVariable[82] (optional)

Call-related variable data that has a variable name defined in the Unified CCX Editor. See NAMEDVARIABLE Data Format, for the format of this field.

NAMEDVAR

251

NamedArray[83] (optional)

Call-related variable data that has an array variable name defined in the Unified CCX Editor. See NAMEDARRAY Data Format, for the format of this field.

Note

The Wrap-Up Reason is now expected in the NamedArray field with the key name, CCWRAPUP.

The maximum size of the Wrap-Up Reason value can be 40. A maximum number of five (5) Wrap-Up Reasons are allowed.

NAMEDARRAY

252

AccountCode[78] (optional)

Account code used by CTI applications.

STRING

40