Understand connected users indicators

The connectedUsersIndicator query allows you to monitor live user availability on the iAdvize platform. It provides visibility into how many users are connected, how many are available for chat, and how occupied they are, helping you understand team readiness in real time.

What is the connectedUsersIndicator query for?

You can use this query to retrieve indicators about users who are currently connected to iAdvize, with details about:

• Their availability status

• Their chat availability

• Their occupancy level in production

Available filters

You can fine-tune your query with the following filters:

Filter	Description
availabilityStatus	Filter by user availability status (AVAILABLE, BUSY, TOGGLE_OFF)
chatAvailability	Filter by chat availability (AVAILABLE, BUSY, TOGGLE_OFF)
groupIds	Filter by user group IDs
projectIds	Filter by project ID(s)
roles	Filter by user role(s): operator, manager, admin, expert, bot
routingGroupIds	Filter by routing group IDs
userIds	Filter by specific user ID(s)

You can combine multiple filters to scope the results to specific teams, projects, or user segments.

Response fields

The API response includes three key indicators:

1. connectedUsersCount (Int!)

Total number of users currently connected to the iAdvize desk.

• This reflects all users actively logged in, regardless of availability or role.

2. countByChatAvailabilityStatus (ChannelGroupAvailabilityStatus)

Number of users currently connected and available, broken down by chat availability status (AVAILABLE, BUSY, TOGGLE_OFF).

• This allows you to see how many users are available or busy on the chat channel.

• It helps you assess how ready your team is to handle new incoming conversations.

3. usersInProductionChatOccupancy (UsersInProductionOccupancy)

Detailed average chat occupancy of users currently in production. This includes:

Field	Description
maximumSimultaneousConversationAverage (Float!)	Average of max processing capacity (maxSlots) of agents in production, on the Chat channel
simultaneousConversationAverage (Float!)	Average slots (currentSlots) currently taken by agents in production
occupancyRate (Float!) %	Total number of slots currently taken by agents in production divided by the total number of slots defined by these agents in the chat channel. (sum(currentSlots) / sum(maxSlots))

What does occupancy represent? Occupancy reflects the period during which an agent is logged in to the conversation panel and is partially occupied or occupied to maximum capacity.

Next steps

You can test this query and explore the full schema in the iAdvize GraphQL API Explorer.

For more insights on building complete dashboards, you may also be interested in:

• Production Indicator

• Pre-aggregated Indicators