Core REST API

Introduction

Anywhere365 has a Representational State Transfer (REST) Application Programming Interface (API), which can be used to GET realtime data directly from the dashboard service. For example you can use this information to connect with a Microsoft Power BI, Power Automate flow or any other application which can integrate with a REST API.

Prerequisites

Available for UCC A Unified Contact Center, or UCC, is a queue of interactions (voice, email, IM, etc.) that are handled by Agents. Each UCC has its own settings, IVR menus and Agents. Agents can belong to one or several UCCs and can have multiple skills (competencies). A UCC can be visualized as a contact center “micro service”. Customers can utilize one UCC (e.g. a global helpdesk), a few UCC’s (e.g. for each department or regional office) or hundreds of UCC’s (e.g. for each bed at a hospital). They are interconnected and can all be managed from one central location. Core service from 5.0.16453.0 and higher

Available REST API's

Get All Agents

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/agent

This shows information about all signed-in agents only (formal signed-in or informal)

Tip: If you also want to see the formal signed-out agents, you can add a parameter:

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/agent?includeFormalStopped=true

Fields:

Item	Description
ActivityToken	The current activity of the agent. Empty of no activity.
AverageHandlingTime	The average handling time of the agent
CsPresenceState	Name of the presence of the agent.
DeviceType	The last active device of the agent.
LastPresenceChange	The date/time of the last presence change of the agent
LastReasonCodeChange	The date/time of the last reason code change the agent has done
MaxChats	When the agent can't receive anymore chats than he currently is handling, the value would be true.
PresenceState	The current presence state of the agent.
ReasonCode	The current reason code the agent is in
RemainingWrapUpTime	The reaming wrap up time (DischargeDuration) the agent has.
SipAddress	The SIP The Session Initiation Protocol, or SIP, is a protocol for multimedia communication (audio, video and data communication). SIP is also used for Voice over IP (VoIP). SIP has interactions with other Internet protocols such as HTTP and SMTP. address of the agent.
Skills	The skills the agent owns. Name: The name of the skill that the agent has. Value: The score the agent has for this skill.
TotalCallsToday	The amount of calls the agent has accepted today.

Get Agent By URI (no “sip:”)

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/agent/user@host

This shows information about all signed-in agents only (formal signed-in or informal)

Fields:

Item	Description
AverageHandlingTime	The average handling time of the agent
LastPresenceChange	The date/time of the last presence change of the agent
LastReasonCodeChange	The date/time of the last reason code change the agent has done
MaxChats	When the agent can receive multiple chats, the value would be true.
PresenceState	The current presence state of the agent.
ReasonCode	The current reason code the agent is in
RemainingWrapUpTime	The reaming wrap up time (DischargeDuration) the agent has.
SipAddress	The SIP address of the agent.
Skills	The skills the agent owns. Name: The name of the skill that the agent has. Value: The score the agent has for this skill.
TotalCallsToday	The amount of calls the agent has accepted today

Get Active calls of Agent By URI (no sip:)

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/agent/user@host/calls

Fields

String: Shows the LineURI(s) of the callers who are currently connected to this agent.

Get Calls

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/calls

This shows information about all active UCC calls (in queue, in IVR Interactive Voice Response, or IVR, is a telephone application to take orders via telephone keypad or voice through a computer. By choosing menu options the caller receives information, without the intervention of a human operator, or will be forwarded to the appropriate Agent., connected with agent, etc)

Fields:

Item	Description
AcceptedSince	The date/time when the agent accepted the call
Agent SipAdress	The SIP address of the agent who accepted the call
CallId	The unique correlation id of the call
ConnectedSince	The date/time when the caller entered the UCC
CustomerSipAddress	The SIP address or LineURI of the caller
DisconnectedSince	The date/time of the disconnect of the call
InQueueSince	The date/time of moment the caller went into the queue
Skill	The skill the caller is in
AgentDisplayName	The display name of the agent who accepted the call
CurrentlyHunting	When the UCC is hunting the agent the value would be true
CustomerDisplayName	The display name of the caller
Huntlist	List of agent who are selected for the hunt. Based on the reservations
IsHunting	When the UCC is hunting the agent the value would be true
IsOnHold	When the caller is on hold, the value would be true

Get Calls by skill

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/calls/{skillname}

This shows information about all active UCC calls per skill (in queue, in IVR, connected with agent, etc)

Fields:

Item	Description
AcceptedSince	The date/time when the agent accepted the call
Agent SipAdress	The SIP address of the agent who accepted the call
CallId	The unique correlation id of the call
ConnectedSince	The date/time when the caller entered the UCC
CustomerSipAddress	The SIP address or line URI of the caller
DisconnectedSince	The date/time of the disconnect of the call
InQueueSince	The date/time of moment the caller went into the queue
Skill	The skill the caller is in
AgentDisplayName	The display name of the agent who accepted the call
CurrentlyHunting	When the UCC is hunting the agent the value would be true
CustomerDisplayName	the display name of the caller
IsHunting	When the UCC is hunting the agent the value would be true
IsOnHold	When the caller is on hold, the value would be true

Get Queues

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/queue

This shows information about all queues (skills)

Fields:

Item	Description
AgentsOnCall	The amount of agents who are in a call for this skill
AvgWait	The average wait time (callers in the queue) in seconds
ID	The internal id of the skill
LongestWait	The time in seconds of the call who was in the queue for the longest time
Name	The name of the skill
CurrentSize	The amount of callers in the queue for this particular skill
MaxSize	The maximum size of the skill (OverflowThreshold setting)
Name	The name of the skill

Queues by skill

Copy

HTTP Request

GET http(s)://{fqdn}/dashboardservice/api/{uccname}/queue/{skillname}

Fields:

Item	Description
AgentsOnCall	The amount of agents who are in a call for this skill
AvgWait	The average wait time (callers in the queue) in seconds
ID	The internal id of the skill
LongestWait	The time in seconds of the call who was in the queue for the longest time
Name	The name of the skill
CurrentSize	The amount of callers in the queue for this particular skill
MaxSize	The maximum size of the skill (OverflowThreshold setting)