Skip to content

Notification settings

Applies to: Owner, Administrator and any role with Notifications.View (see) or Notifications.Manage (change); Settings.View / Settings.Manage for payment reminder rules; Email.View / Email.Manage for email settings. Last reviewed: 2026-11-18.

This page lists every setting that affects notifications, its default, where it is, who may change it and what it does. Most settings are on the Notification Settings page; payment reminder rules and the school's own mail server have their own pages.

1. Where the settings are

Settings Where to click Permission to see Permission to change
Channels, per-message switches, reminder timing, quiet hours Side menu Settings > Notifications tile ("Notification preferences"). Page title Notification Settings, address /settings/notifications. Notifications.View Notifications.Manage
Payment reminder rules Settings > Payments. Page title Payment Settings, /settings/payments. Settings.View Settings.Manage
The school's own mail server Settings > Email. Page title Email Settings, /settings/email. Email.View Email.Manage
Notification Log Settings > System, /settings/system. Notifications.View Read-only
SMS bundles, WhatsApp add-on Settings > Billing Subscription.View Subscription.Manage

The Settings entry in the side menu needs Settings.View. The Notifications, Email and System tiles are hidden from a SuperAdmin, because a SuperAdmin does not belong to a school.

In the default role set, Notifications.View, Notifications.Manage, Email.View and Email.Manage are granted together to the school's administrative roles (RolePermissionSeeder). A school can change this for its own custom roles under Settings > Roles.

A user with view permission only sees the banner "You can view these settings but not change them." and the Save Changes button is disabled.

The owner's mobile app has a simpler copy of the Notifications page; see section 6.

2. Notification Settings page

Screenshot to be added

Screen: Notification Settings. Should show: whole page showing Notification Channels, Student Notifications, Reminders, Staff Notifications and Quiet Hours.

Important

Nothing is saved until you click Save Changes at the top right. Success: "Notification settings saved successfully."

2.1 Notification Channels

"Choose which communication channels are available for your organisation."

Setting Default Effect
Email On Master switch for email. Off stops all engine emails, automatic invoice emails and automatic payment reminders. Manual sends and account emails still go.
SMS Off Master switch for SMS. Can only be switched on when the plan includes SMS and credits are available.
WhatsApp Off Master switch for WhatsApp. Can only be switched on when the plan includes WhatsApp and the add-on is paid.

A channel master switch is the outer limit: a per-message tick can only narrow it.

There is no switch for push; see Push notifications.

2.2 Student Notifications

"Notifications sent to students." One row per message with columns Notification, Enabled, Email, SMS, WhatsApp, Timing.

Notification Enabled Email SMS WhatsApp Timing shown Notes
Student Welcome On On Off Off Immediately Skipped during quiet hours
Lesson Booking Confirmation On On Off Off Immediately
Lesson Reminder On On Off Off "1 day before" Timing set in the Reminders card
Driving Test Reminder On On Off Off "1 day before" Timing set in the Reminders card
Lesson Rescheduled On On Off Off Immediately
Lesson Cancelled On On Off Off Immediately
Lesson Request Declined On On Off Off Immediately
Payment Received On On Off Off Immediately Email carries the receipt PDF
Payment Reminder On On Off Off Link "Set in Payment settings" Timing comes from Settings > Payments
Invoice Issued On On Off Off Immediately Email only: the SMS and WhatsApp ticks have no effect
  • Enabled off stops the message on every channel, including push.
  • The SMS and WhatsApp boxes are disabled until the matching channel is switched on above.
  • "Lesson Completed" is not in this list and cannot be configured (see section 5).

2.3 Reminders

"Choose when students receive lesson and driving test reminders."

Setting Default Range Effect
Lesson Reminder: send before 1,440 minutes 15 to 44,640 minutes (31 days), steps of 15 How long before the lesson start the reminder is sent
Driving Test Reminder: send before 1,440 minutes Same How long before the test the reminder is sent
  • The value is in minutes. 60 = 1 hour, 120 = 2 hours, 1,440 = 1 day, 2,880 = 2 days. The text under the field shows it in words, for example "Current value: 2 hours before".
  • If the reminder is switched off in the student list the field is disabled and shows "Switched off in the student notifications list."
  • The setting applies to the whole school. There is no per-branch or per-student timing, and only one reminder per lesson.
  • Empty or 0 is treated as 24 hours. The API only rejects negative numbers ("Invalid reminder timing for ...").
  • "Reminders held back by quiet hours go out when quiet hours end."

Details: Lesson reminders.

2.4 Staff Notifications

"Keep instructors and staff informed." One on/off switch per message.

Notification Default Effect
New Lesson Assigned On Email (and push) to the instructor when a lesson is booked for them
Lesson Rescheduled On Email (and push) to the instructor when a lesson is moved
Lesson Cancelled On Email (and push) to the instructor when a lesson is cancelled
Daily Instructor Schedule Off Has no effect. No code sends this message.

On the web page staff messages have no channel boxes: they go by email (default) and push. The stored preference does have SMS and WhatsApp flags, which the owner's mobile settings screen can change (section 6).

Note

Only instructors receive staff messages. Owners, administrators and receptionists are not notified of anything by email.

2.5 Quiet Hours

"Prevent non-urgent notifications from being sent during these hours."

Setting Default Effect
Quiet Hours switch Off Turns the quiet window on
Quiet hours start Empty Start of the window, 24-hour clock
Quiet hours end Empty End of the window
  • Both times are required when the switch is on: "Please specify both quiet hour times." (page) or "Quiet hours require both a start and end time." (API).
  • A window may run overnight (for example 21:00 to 07:00). If start and end are the same there is no quiet window.
  • The clock used is the server's, not the branch's.

What quiet hours really do

The page says "Notifications scheduled during quiet hours will be delayed until the quiet period ends.", but the code behaves as shown in the table below. Most messages are sent anyway or dropped, not delayed.

Message During quiet hours
Lesson Booking Confirmation, Lesson Rescheduled, Lesson Cancelled, Lesson Completed, Lesson Request Declined, Payment Received, and the three instructor messages Sent anyway (treated as urgent)
Lesson Reminder, Driving Test Reminder Held and sent at the first 15-minute run after the window ends, if the lesson or test is still ahead
Student Welcome Dropped. Not sent later.
Payment Reminder by SMS, WhatsApp or push Dropped for that day's run
Payment reminder email, invoice emails, receipts, quotes, account emails Not affected by quiet hours

There is no queue of delayed messages.

Tip

If you register students in the evening and want them to get the welcome message, keep the quiet window clear of your working hours.

3. Settings that exist but are not on any page

Setting Value Notes
CompanyNotificationSettings.IsActive True If false the engine sends nothing for the school. No page changes it.
SendStudentWelcome, SendLessonReminder, LessonReminderHoursBefore, PaymentReminderDaysBefore and similar columns on CompanyNotificationSettings Various Older columns. The engine does not read them; the per-message preferences replaced them.
Payment Reminder "send before" (4,320 minutes) Stored Not used. Timing comes from Payment Settings.

When the settings are created

  • Default settings and preferences are created when a school registers (AuthService).
  • If a school somehow has none, they are created the first time someone opens the Notification Settings page. Until then the engine sends nothing for that school ("notifications are not configured or not active" in the server log).
  • When DriveFlow adds a new message type, its preference row is created with defaults the next time the page is opened. Until then the engine treats the new message as enabled, email on, SMS and WhatsApp off.

4. Payment Settings page (payment reminders)

Settings > Payments. Save with Save Changes ("Payment settings saved."). "Changes apply from the next daily run."

Card Setting Default Range Effect
Overdue Invoices Grace period (days after due date) 0 0-90 "0 marks an invoice overdue the day after its due date."
Payment Reminder Emails - Before the due date Send a "payment due soon" email (days before) 3 0-30 "0 turns the due-soon email off."
After the due date On / Off switch On - Overdue reminders on or off
First reminder (days after) 1 1-90 Days after the due date for the first overdue reminder
Repeat every (days) 7 0-90 "0 sends one reminder only."
Maximum reminders 3 1-20 Total overdue reminders per invoice

The Example card on the right shows the dates these rules produce for an invoice due on the 1st of next month.

The page notes: "Reminders are sent daily at 08:00, and only while email notifications and the Payment Reminder notification are switched on in Notification settings. You can also send one at any time from an invoice's menu." See Lesson reminders section 4 for the time zone of that run.

The same page holds the school's PayFast details for online payments. When those are set up, reminders include a pay-online link.

5. What cannot be configured

Item Behaviour
Lesson Completed message Always sent by email (if the Email master switch is on) and push
Push Automatic when the plan includes the Mobile App
Message wording, subject lines, sender footer Fixed in code; see Notification templates
Per-student or per-instructor opt-out Does not exist
Per-branch settings Do not exist; all settings are per school
CC to the office, reply-to address Do not exist
SMS sender name, WhatsApp number Platform-wide
Number of lesson reminders Always one

6. The same settings in the owner's mobile app

The mobile app has a Notifications screen under Settings ("Which messages DriveFlow sends for your school, and how."), using the same API and permissions.

Differences from the web page:

  • Channels are check boxes: Email, SMS, WhatsApp (marked "add-on" when not available).
  • Quiet hours are labelled Hold messages overnight.
  • Messages are grouped To students and To instructors and staff, and every message, including the staff ones, shows Email / SMS / WhatsApp boxes for the channels that are switched on. This is the only place where SMS or WhatsApp can be ticked for an instructor message.
  • Reminder timings are not shown; they are kept as they are and changed on the web.
  • The button is Save notification settings.

7. Platform settings (server administrator)

Set in the API configuration, not in the application.

Section Purpose
EmailSettings Global SMTP server and sender
VodacomSms SMS provider, including Enabled, sender id and default country code
MetaWhatsApp WhatsApp Cloud API, including Enabled
Firebase (push) The Firebase key that push notifications need (kept private)
Platform:AppUrl Web app address used in links and the email logo
Platform:AdminEmail Receives new-registration alerts
Billing issuer options Legal name, trading name and contact email shown on DriveFlow's own emails to schools
Default connection string Also used by Hangfire for the job schedule

Never put real values for these in documentation or source control.