The Agent Status API is part of Voiso's Agent Application APIs. Use it to obtain the email address, extension, and current availability status of every agent in the contact center. The API endpoint description is here.
The Agent Status API requires the base URL (cluster_id) and the The Contact Center API key) (client_api_key). It uses the following parameters to initiate a call:
The contact center API key. Voiso responds with a list of all agents and their current availability status.
For example:
https://cluster1.voiso.com/api/v1/cc7c76b8b...b80ab6c3/agents_status
Or as a JSON request:
{
"method": "GET",
"url": "https://cluster1.voiso.com/api/v1/cc7c76b8b...b80ab6c3/agents_status",
"headers": {
"Accept": "application/json",
}
}
The response contains an array of information about each user, including their sign-in email address, phone extension, and current status.
The following table describes the elements of the response.
| Element | Description | Type | Notes |
|---|---|---|---|
| The user's sign-in email address. | string | ||
| ext | The user's phone extension. | string | |
| status | The user's current availability status. | string | Valid values are: Available, Idle, Logout, Outbound, Inbound, Dialer waiting, and Unavailable with one of the unavailable codes defined for your contact center. |
[
{
"email": "pt@fg.com",
"ext": "7777",
"status": "available"
},
{
"email": "px@fg.com",
"ext": "5555",
"status": "unavailable"
}
]
The following issues are sometimes encountered:
The Agent Status API requires the contact center API key to validate the request. If you see this error, "error": "Invalid key", check that you are using the correct contact center API key. For more information about API keys, refer to Authentication.
Was this page helpful?