Agent API

The Agent API is a set of method calls used to create, manage, and end "agent sessions". With an agent session, you are able to set the agent’s state and manage interactions (phone calls, chats, emails, voice mails, and work items).

General Requirements

To start an agent session, you need to get an API token from the token service. All API methods require some form of authentication token in each method call. Most agent applications require an Implicit or Password authentication token. See the Getting Started tutorial for information on what type of token is needed for your application and how to get an API Authentication Token.

Once you have an API Authentication Token, you use this token to create an agent session for the agent whose credentials you used to get the token. This is done by requesting the method, https://api-{cluster}.incontact.com/inContactAPI/services/v13.0/agent-sessions and supplying either a "station ID" or a phone number which will be delivered to the agent.

Once you start an agent session, you receive a "session ID". This will be used in most Agent API method calls. The agent session is referenced using its ID as a resource, like this: https://api-{cluster}.incontact.com/services/v13.0/agent-sessions/{session-id}.


NOTE : The application calling APIs can inject an ID called the CorrelationId in the API headers. In such a case, the API response will send back the injected CorrelationId in the API response. There is no change in the API response if the CorrelationID is not injected. See the CorrelationId: Getting Started for more information on CorrelationId.

Loading...