The Stopcall API is part of Voiso's Voice APIs. Use it to end calls for agents from external systems. The API endpoint description is here.
The Stopcall API requires the base URL (cluster_id) and the contact center API key (client_api_key). It uses the following parameters to terminate a call:
The agent parameter is the agent's extension. This tells Voiso whose call to end. The call is stopped automatically on the agent's configured phone in Agent Panel, the Omnichannel Workspace, or third-party SIP client (softphone or hard phone).
For example:
POST https://cluster1.voiso.com/api/v1/cc7c7b8981d...0ab6c3/click2call_hangup Request body: { "agent": "1002" }
The following issues are sometimes encountered:
If you see this error, "error": "No active calls", there is no active call on the extension you specified.
If you see this error, "error": "Rate limit exceeded", the number of permitted requests to the server is exceeded, and requests are being throttled.
If you see this error, "error": "Invalid agent's extension", the extension specified is either in the wrong format or is not assigned to any agent. Ensure the agent's extension is correctly formatted.
The Stopcall API uses the contact center API key to validate the request. If you see this error, "error": "Invalid API key", check that you are using the correct contact center API key. For more information about API keys, refer to Authentication.