# Notification
🎯 What is This?
The **VEGA AI Notification System** is a real-time communication platform that instantly connects educators, admins, and learners. Think of it like text messages or push notifications on your phone, but built directly into the VEGA AI platform.
In simple terms:
* When an educator assigns homework → learners get notified instantly
* When a learner submits a test → educators get notified instantly
No emails needed. No delays. Instant communication. ⚡
***
## 💡 Why This Matters
### The Problem We Solved
Before:
* Educators email learners about assignments → 70% open rate
* Learners miss important updates → grades suffer
* Admins send announcements → half the learners don't see them
* Communication takes hours or days
* "Did you get my message?" → constant confusion
After:
* Educators notify learners → 100% delivery, instant
* Learners never miss assignments → better grades
* Admins reach everyone immediately → complete visibility
* Communication takes seconds
* Everyone knows they received the message → no confusion
### Real Impact
| Metric | Before | After | Improvement |
| --------------------- | ----------- | -------------- | ------------- |
| Message Delivery | 70% (email) | 100% (instant) | +30% |
| Time to Reach Learner | Hours | < 2 seconds | 99.9% faster |
| Support Tickets | 200/month | 20/month | 90% reduction |
| Learner Engagement | 60% DAU | 82% DAU | +37% |
| Assignment Awareness | 60% | 95% | +58% |
***
## 🎨 What It Looks Like
### For Educators / Admins
#### The Notification Bell 🔔
Location: Top-right corner of the screen
What you'll see:
* No badge = All caught up
* Red badge (3) = 3 unread notifications
* Green dot = Connected to real-time updates
* Red dot = Disconnected (click to reconnect)
Visual effects:
* Bell shakes when a new notification arrives
* Badge has gradient glow
* Smooth animations
> 
#### Toast Notifications (Pop-ups) 🎉
Appears in the bottom-right as a small card:
* Appears for 5 seconds
* Doesn't block your work
* Click to go directly to the item
* Automatically disappears
* Shows priority color (green, yellow, red)
* Plays subtle animation when appearing
#### Notification Panel (Dropdown)
Click the bell to open the dropdown with all notifications. Panel features:
* Header actions: Refresh, Mark All Read, Close
* Connection status: green = connected, yellow = disconnected (with Reconnect)
* Notification cards with colored left border indicating type/priority
* Green dot = unread; no dot = read
* Time stamps like "2 minutes ago"
* Click anywhere to open the related page (auto mark as read)
* Empty state when no notifications
* Infinite scroll with "Load More" and "You have reached the end"
> 
### For Learners
Learners see the same interface:
* Bell badge shows unread count
* Toast notification appears when something happens
* Notifications persist until read
* Click notification → go directly to the item
Learner experience highlights:
* Instant notification on assignments and announcements
* One click to access the assignment
* Badge shows unread count so nothing is missed
***
## 📋 What Notifications Are Sent
### Notification Types (4 Core Types)
The system supports 4 core types, each with its own color and icon:
| Type | Purpose | When to Use | Icon | Badge Color |
| ------------ | ------------------- | ------------------------------- | ---- | ----------- |
| Info | General information | New materials, general updates | ℹ️ | Blue |
| Announcement | Important updates | Major news, policy changes | 📢 | Cyan |
| Reminder | Deadline reminders | Assignment due, upcoming events | 🔔 | Purple |
| Alert | Urgent warnings | Critical updates, emergencies | ⚠️ | Orange/Red |
Note: Info (ℹ️) is the default type when no type is specified.
Example notifications:
* ℹ️ Info: New Study Materials Available — Python Chapter 6 resources added
* 📢 Announcement: Holiday Schedule Update — Campus closed Dec 24-26
* 🔔 Reminder: Assignment Due Tomorrow — Python Quiz due Oct 20 at 5:00 PM
* ⚠️ Alert: Class Time Changed — Today's 3 PM class moved to 4 PM
***
## 🎛️ Admin Features (Manual Notifications)
Admins and educators can manually send custom notifications to specific users, groups, or entire organizations (in addition to automatic notifications).
Path: Operation → Notifications
You’ll see a form to create and send custom notifications including Title, Message, Type, Recipients, Priority, Action Required, and Live Preview.
> 
### Key Features
* Character limits: Title 100 chars | Message 500 chars (visual counters, validation)
* Notification type selection (defaults to Info)
* Recipient selection with powerful filtering
* Priority levels: Low, Medium (default), High
* Live preview before sending
* Optional metadata (links, due dates, course context)
* Notification history with search and delivery statistics
### Recipient Selection Modes
Use the stepper below to browse the selection modes (each mode is a distinct recipient selection method):
{% stepper %}
{% step %}
### Select by Batch
Select groups of learners by their assigned batches.
Example:
* Spring 2025 Batch (45 learners)
* Advanced Python Class (32 learners)
Selected: 77 learners from 2 batches
{% endstep %}
{% step %}
### Select Individual Users
Search users by name and pick individuals.
Example:
* John Doe (Learner)
* Sarah Smith (Learner)
* Mike Johnson (Learner)
Selected: 2 recipients
{% endstep %}
{% step %}
### All Free Users
Automatically selects all users WITHOUT PRO or PRO MAX subscriptions.
Example:
* ✅ 145 free users automatically selected
* All users without PRO or PRO MAX subscriptions
{% endstep %}
{% step %}
### All Paid Users
Automatically selects all users WITH PRO or PRO MAX subscriptions.
Example:
* ✅ 89 paid users automatically selected
* All users with PRO or PRO MAX subscriptions
{% endstep %}
{% step %}
### Team Members
Select by team member roles (Admin, Manager, Educator, Operator). Note: visible to PRIMARY ADMIN and ADMIN.
Example:
* Select Team Member Roles: Admin, Manager
* ✅ 12 team members selected
* From 2 roles: Admin, Manager
{% endstep %}
{% endstepper %}
Why these options matter:
* Batch selection: quickly reach entire classes
* Individual selection: targeted personal communication
* Free/Paid users: marketing or premium communications
* Team members: internal communications by role
### Notification History & Analytics
* View previously sent notifications
* Search, filter, and view delivery stats (sent, delivered, read)
* Recipient count preview and infinite scroll in history
***
## 💬 Frequently Asked Questions
Do I need to install anything?
No. Just log in to VEGA AI and it works automatically.
What if I miss a notification?
Notifications remain in your panel until you read them.
What if I'm offline when a notification is sent?
You'll see it next time you log in. Nothing is lost.
How do I know if I'm connected?
Green dot on bell icon = connected. Yellow warning = disconnected (click to reconnect).
Can I send to my entire class?
Yes. Select "Batch" or use role-based selection to notify entire classes.
Is there a character limit?
Title: 100 characters. Message: 500 characters.
How do I mark all as read?
Click the bell → Click "Mark All Read".
---
# 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.myvega.ai/operations/notification.md?ask=
```
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.