Skip to content

Push Notifications

Configure push notifications sent to guardians through the Guardian App.

Overview

Push notifications alert guardians in real-time when students arrive at or leave school.

Page Layout

  • Notification Settings - Configure notification types
  • Message Templates - Customize notification text
  • Delivery Report - View notification history
  • Test Notification - Send test messages

Notification Types

TypeTrigger
Student ArrivalStudent scans in at gate
Student DepartureStudent scans out
Late ArrivalStudent arrives after cutoff
Early DepartureStudent leaves before dismissal
Absence AlertStudent marked absent
AnnouncementSchool-wide announcements

Common Tasks

Enabling Notification Types

  1. Go to SchoolGuardian APIPush Notifications
  2. View notification types
  3. Toggle each type on/off
  4. Save settings

Customizing Templates

  1. Go to Message Templates
  2. Select notification type
  3. Edit message:
    Your child {studentName} has arrived at school at {time}.
  4. Available variables:
    • {studentName} - Student's name
    • {time} - Event time
    • {date} - Event date
    • {gate} - Gate location
  5. Save template

Sending Test Notification

  1. Click Test Notification
  2. Enter guardian's phone/email
  3. Select notification type
  4. Click Send
  5. Verify receipt

Viewing Delivery Reports

  1. Go to Delivery Report
  2. View sent notifications:
    • Recipient
    • Message
    • Time sent
    • Status (Delivered/Failed)
  3. Filter by date or status

Notification Settings

SettingDescription
Quiet HoursDon't send during these hours
Batch DelayWait time before sending
Retry CountTimes to retry failed sends
PriorityNormal/High priority

Message Variables

VariableReplaced With
{studentName}Student's full name
{firstName}Student's first name
{time}Event time
{date}Event date
{day}Day of week
{gate}Gate name
{status}Attendance status

Example Templates

Arrival

Good morning! {studentName} has arrived at school at {time}.

Departure

{studentName} has left school at {time}. See you tomorrow!

Late

{studentName} arrived late today at {time}. Please ensure timely arrival.

Troubleshooting

Notifications Not Received

  • Verify guardian has app installed
  • Check FCM token is registered
  • Verify phone has internet
  • Check app notification permissions

Delayed Notifications

  • Check quiet hours settings
  • Verify batch delay settings
  • Check server performance

Tips

  • Clear Messages - Keep notifications concise
  • Useful Info - Include relevant details
  • Test Regularly - Verify notifications work
  • Monitor Delivery - Check for failures
  • Respect Privacy - Only necessary information

💡 Note: Push notifications require guardians to have the Guardian App installed with notifications enabled.

Released under the MIT License.