> For the complete documentation index, see [llms.txt](https://docs.iadvize.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iadvize.dev/use-cases/data-and-analytics/retrieve-messages-exchanged-within-a-conversation-1/understand-connected-users-indicators.md).

# 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)) |

{% hint style="info" %}
**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.
{% endhint %}

### Next steps

You can test this query and explore the full schema in the [iAdvize GraphQL API Explorer](https://graphql.iadvize.dev/queries/connectedUsersIndicator).

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

* [Production Indicator](https://docs.iadvize.dev/use-cases/data-and-analytics/retrieve-messages-exchanged-within-a-conversation-1/understand-production-indicators)
* [Pre-aggregated Indicators](https://docs.iadvize.dev/use-cases/data-and-analytics/retrieve-messages-exchanged-within-a-conversation-1/pre-aggregated-indicators)