Deprecated
This Call Control in Conference API will be deprecated by 30th April 2025.
We recommend to start using the new version of the Call Control in Conference APIs.
Call Control API is used to perform toolbar actions when dialing through offline campaigns. This API helps in taking a third-party number into a conference and then can Mute, Unmute, Hold, Unhold, and KICK_CALL(which is also DROP) numbers without the interference of Agent login.
To access this API the following parameters MUST be passed.
Parameter | Description |
---|---|
action* | CONFERENCE/HOLD/UNHOLD/MUTE/UNMUTE/KICK_CALL |
ucid* | Unique ID generated when offline call is initiated |
conferenceNumber* |
|
did* | Phone number through which calls are dialed out to agents and customers |
agentPhoneName* | Phone name associated with an agent number |
api_key* | Available in CloudAgent admin login |
output | xml/json (desired output format) |
playRing* | Should be 'true' always |
sip | "true" - if the conference number is a SIP number |
Note
- Desired ‘action’(parameter) impacts the PhoneName that is passed in the parameter field.
- Parameters with ‘*’ are mandatory parameters.
- Always pass the agent phone number in the 'conferenceNumber' parameter to use 'KICK_CALL' action
- No call controller options will be shown to the SIP agent when a conference call is answered
All possible responses
Success HOLD response | "status": "Success" |
Success UNHOLD response | "status": "Success" |
Success MUTE response | "status": "Success" |
Success UNMUTE response | "status": "Success" |
Success response to END | "status": "Success" |
Failure response | "status": "Error" |
Failure response | "status": "Error" |
Further Insights
By default, the domain name is https://in1-ccaas-api.ozonetel.com. Please refer here to change based on the need.