Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide
10-12
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 10 Call Object
Methods
Java:
int Conference(Arguments optional_args)
.NET:
CilError Conference(Arguments optional_args)
Parameters
optional_args
An optional input parameter, which is a pointer or reference to an Arguments array that contains a
member with the string value that is the UniqueObjectID of the call to which this call should be
conferenced. If this argument is used, it should be added to the Arguments parameter with the
keyword of “CallReferenceObjectID”. This would only be necessary in an environment where there
are multiple held calls and the request is being made through the talking call. If the request is being
made through a specific held call in this scenario, or if there are only two calls at the device, this
parameter is unnecessary.
member with the string value that is the UniqueObjectID of the call to which this call should be
conferenced. If this argument is used, it should be added to the Arguments parameter with the
keyword of “CallReferenceObjectID”. This would only be necessary in an environment where there
are multiple held calls and the request is being made through the talking call. If the request is being
made through a specific held call in this scenario, or if there are only two calls at the device, this
parameter is unnecessary.
errorcode
An output parameter (return parameter in VB) that contains an error code from
Return Value
Default CTI OS return values. See
Remarks
Before making this request, it is necessary for the original call to be in the held state and the consult call
to be in the talking state or the request will fail. Therefore, if the calls are alternated (see Alternate), they
must be alternated again to return the two calls to their appropriate states.
to be in the talking state or the request will fail. Therefore, if the calls are alternated (see Alternate), they
must be alternated again to return the two calls to their appropriate states.
If there are only two calls at the device, this method may be called using either the current or held call.
For switches which allow more than two calls at a device (for example G3), make this request through
the desired held call to avoid the ambiguity caused by multiple held calls at the device. Otherwise,
indicate the desired held call using the optional parameter.
For switches which allow more than two calls at a device (for example G3), make this request through
the desired held call to avoid the ambiguity caused by multiple held calls at the device. Otherwise,
indicate the desired held call using the optional parameter.
The Conference request must be made via a call whose call status is LCS_CONNECT or LCS_HELD
or it will fail.
or it will fail.
On certain switches (notably IPCC), only the Conference Controller (the party that first initiated the
conference call) may add additional parties to an existing conference call.
conference call) may add additional parties to an existing conference call.
The following events will be received if this request is successful:
•
OnConferenceCallConf event
•
OnCallConferenced event
The following events will be received if this request fails:
•
OnControlFailureConf event
GetCallContext
The GetCallContext method returns an Arguments array containing the values for call properties other
than CallVariables and ECC Variables, such as ANI, DNIS, and the other properties listed in
than CallVariables and ECC Variables, such as ANI, DNIS, and the other properties listed in