Notifications & Alerts

EazyClassroom keeps you informed via push notifications (Progressive Web App) and email alerts. This guide covers how to configure these notifications for admins, teachers, and parents.

1. Types of Notifications

Type	Channel	Description
Class Events	Push/Email	Participant join/leave, session start/end.
Recording Ready	Email	Notification when a class recording is processed.
Keyword Alerts	Email	Speech recognition alerts (Beta) when blacklisted words are spoken.
System Alerts	In-browser	Disconnection warnings during live classes.
Subscription	Email	Billing reminders and payment confirmations.

2. Push Notifications (PWA)

To receive push notifications, you must install the EazyClassroom PWA on your device and grant notification permissions.

Setup (Mobile & Desktop)

1. Install the PWA (see White-Label PWA Guide).
2. Tap "Allow" when the browser asks for notification permissions.
3. If you denied it earlier, go to your browser settings → Site Settings → Notifications → Allow app.eazyclassroom.net.

iOS Limitations

• iOS does not support web push notifications (as of June 2026). Users will not receive push alerts on iPhones or iPads.
• They can still receive email notifications (see section 3).

3. Email Notifications

Email notifications are sent to the email address associated with the user’s account.

Which Emails Are Sent

Email Type	Recipients	Frequency
Class event summary	Admin, Teacher	Real‑time (each event) or daily digest (configurable)
Recording ready	Teacher, Parent	One per recording
Keyword alert	Admin	Immediate
Subscription renewal reminder	Admin	7 days before billing
Payment failure	Admin	When PayPro fails
New user welcome	Admin, Teacher, Parent	Once
Password reset	Any user	On request

Configuring Email Notifications

1. Log in to your dashboard.
2. Go to Profile → Notifications.
3. Toggle which emails you want to receive:
   • Class events – On/Off
   • Recording ready – On/Off
   • Keyword alerts – Admin only
   • Marketing emails – Optional
4. Choose Digest frequency (for class events):
   • Real‑time (each event sends an email)
   • Daily (one email per day summarising all events)
   • Weekly

Admin only: You can also configure global email settings in Settings → Email.

4. Real‑time Disconnection Alerts

When a participant loses internet connection during a live session, the teacher receives an in‑browser pop‑up notification.

How It Works

• The system detects when a participant’s WebSocket connection drops.
• A banner appears at the top of the teacher’s screen: “John left the session (connection lost)”.
• When the participant rejoins, another banner appears: “John rejoined”.

Why This Is Useful

• Teachers can pause or repeat content if a student missed something.
• It helps identify connectivity issues.
• No action is required – the alert is automatic.

Disabling Alerts

Teachers can disable disconnection alerts from the session settings menu (gear icon → Notifications → Disconnection alerts).

5. Keyword Alerts (Speech Recognition)

This feature (Beta) monitors live sessions for blacklisted keywords (e.g., phone numbers, email addresses, inappropriate language).

How to Configure Keywords (Admin Only)

1. Go to Settings → Speech Recognition.
2. Click Add Keyword.
3. Enter a word or phrase (e.g., “phone”, “email”, “www”).
4. Choose the alert recipients (admin only, or admin + teacher).
5. Save.

What Happens When a Keyword Is Detected

• The system transcribes audio in real time (no recording is stored; only keyword matching).
• When a match occurs, an email alert is sent to the specified recipients.
• The email includes:
  • Time of detection.
  • The keyword detected.
  • The teacher’s name and session ID.
  • A transcript snippet (if available).

Privacy Note

• Audio is processed only for keyword detection; no continuous recording is kept.
• You can disable speech recognition entirely by turning off the feature in Settings.

6. Notification Preferences (Per User)

Users can customise which notifications they receive.

Accessing Preferences

1. Click your avatar (top‑right corner).
2. Select Settings or Profile.
3. Click Notifications tab.

Available Options

Option	Admin	Teacher	Parent
Push notifications (browser)	✅	✅	✅
Email – class events	✅	✅	✅
Email – recording ready	✅	✅	✅
Email – keyword alerts	✅	❌	❌
Email – subscription reminders	✅	❌	❌
Disconnection alerts (in session)	❌	✅	❌
Chat message alerts	❌	✅	❌ (parents do not receive chat alerts)

7. Testing Notifications

To ensure your notifications are working:

1. Push notifications: After enabling, ask a colleague to join a test session. You should receive a push alert.
2. Email notifications: Trigger a recording-ready event (end a test session) and check your inbox.
3. Keyword alert: Add a test keyword, speak it during a session, and verify the email arrives.

8. Troubleshooting Notifications

Issue	Likely Cause	Solution
No push notifications on Android	PWA not installed or permissions denied	Install the PWA and allow notifications in browser settings.
No push notifications on iOS	iOS limitation	Use email notifications instead.
Emails going to spam	Sender domain not authenticated	Whitelist noreply@eazyclassroom.net in your email client.
Keyword alerts not arriving	Feature disabled or keyword not blacklisted	Check Settings → Speech Recognition.
Disconnection alerts not showing	Teacher disabled them	Re‑enable in session settings.

9. Frequently Asked Questions

Can parents receive push notifications when their child joins a class?

Yes, if they have installed the PWA and enabled notifications. They will receive alerts for their own child’s activity.

Can I receive SMS notifications?

No. Only email and push (web) are supported.

How do I stop receiving daily digest emails?

Go to Profile → Notifications and change digest frequency to “Real‑time” or “Off”.

Are keyword alerts available on all plans?

Yes, speech recognition is available on all plans (Free, Teacher, School). However, the feature is in Beta and may be subject to change.

Can I customise the wording of email notifications?

Not at this time. Contact support if you need custom templates (enterprise only).

Will I receive a notification if a student raises their hand?

Not currently. Hand raise notifications appear only within the session interface (visual indicator). Future version may add push alerts.

10. Technical Details for Developers

• Push notifications use Firebase Cloud Messaging (FCM).
• Notification tokens are stored in the users table (notification_token column).
• The insertClassEvent() method triggers notifications after inserting an event.
• Email notifications are sent via the EmailService class (PHPMailer).
• Keyword detection uses the Gemini API for real‑time audio transcription (Beta).

---

Need help with notifications? Contact support@eazyclassroom.net.