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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iadvize.dev/use-cases/data-and-analytics/retrieve-messages-exchanged-within-a-conversation-1/understand-connected-users-indicators.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.