Agent status

API Docs by APIMATIC
API OverviewAgent Application

Agent status
#

Agent Status
#

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.

Prerequisites
#

Making requests
#

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

Response
#

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.

ElementDescriptionTypeNotes
emailThe user's sign-in email address.string
extThe user's phone extension.string
statusThe user's current availability status.stringValid values are: Available, Idle, Logout, Outbound, Inbound, Dialer waiting, and Unavailable with one of the unavailable codes defined for your contact center.

Response sample
#

[
  {
    "email": "pt@fg.com",
    "ext": "7777",
    "status": "available"
  },
  {
    "email": "px@fg.com",
    "ext": "5555",
    "status": "unavailable"
  }
]

Troubleshooting
#

The following issues are sometimes encountered:

Invalid key
#

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?

Thank you! Your feedback has been received.