# Users

<iframe width="560" height="315" src="https://www.youtube.com/embed/R8igyis9Oho" title="YouTube video player" frameborder="0" allowfullscreen></iframe>

## Description

The **Users tab** shows who is using a specific agent, how often they access it, and when activity peaks.  
Filter by time ranges, view **live and historical counts**, scan **access-time heatmaps**, and drill into **per-user details** (messages sent and last active) to guide outreach and support.

---

## Target Audience

**Administrator · Superadministrator**

---

## Features

#### Live & Historical Counts
View **currently logged-in users**, users active in the **last 30 days**, and the **total registered users** for the agent.

#### Flexible Time Filters
Switch between **Today**, **Past 7 Days**, **Past Month**, or a **Custom Date Range**.  
All tables and charts automatically update to match your selection.

#### Active Users Over Time
Track how many **unique users** engaged with the agent within the selected period.

#### Access Times Heatmap
See a **time-of-day/day-of-week grid** where darker shades indicate higher user activity—helping you quickly spot **peak hours**.

#### User Details Table
For each user, view:
- **Name/Username**  
- **Messages sent** (specific to this agent)  
- **Last active timestamp**

---

## How to Use (step by step)

#### Open Analytics → Users
- In the agent header, click the **Analytics** button.  
- Select the **Users tab**.

#### Set Your Timeframe
- Choose **Today**, **7 Days**, **Past Month**, or **Custom**.  
- All counts, charts, and tables refresh to match your selection.

#### Check Topline Counts
- Review the **currently logged-in**, **last-30-days**, and **total registered users** metrics to gauge adoption and growth.

#### Scan the Active-Users Trend
- Use the chart to observe **growth or decline** in unique users over time.

#### Study the Access Times Heatmap
- Identify **peak access windows** (darkest cells) to schedule announcements, office hours, or reminders when most users are online.

#### Drill into User Details
- Sort or filter the table to find users with:
  - High message volume  
  - Recent activity  
  - Inactivity for targeted follow-up  

---

## Pedagogical Use Cases

#### Targeted Outreach
Filter for **inactive or low-activity learners** and send personalized reminders or learning resources.

#### Scheduling Support
Use the **heatmap** to time **office hours** or **content releases** when most learners are active.

#### Cohort Health Check
Track **30-day activity** and **active-user trends** to confirm adoption following new agent launches or updates.

#### Intervention Prioritization
Combine **messages sent** and **last active** to identify learners who need help (e.g., those with high activity but low success rates or long inactivity).

#### Reporting & Stakeholder Updates
Export or share **clean user counts** and **peak-time visualizations** to demonstrate engagement and participation patterns.

---

The **Users tab** helps you understand **who is engaging**, **when they engage**, and **how often they interact**—so you can deliver **timely, data-driven support** to your learners.
