Notifications at a glance¶
Applies to: Owner, Administrator, Manager (anyone with Notifications.View). Last reviewed: 2026-11-18.
This page summarises every message DriveFlow sends: who receives it, by which channel and when. It is built from the detailed pages; follow the link in each row for the full rules, and see Notification triggers for the complete matrix.
DriveFlow sends messages by email, SMS, WhatsApp and Android push. Email works on every plan and is switched on by default. SMS, WhatsApp and push depend on your plan, add-ons and settings. Message wording is fixed and cannot be edited.
How a notification travels¶
Most lesson, payment and reminder messages go through the notification engine, which checks your school's settings before anything is sent. Invoices, quotes, receipts and account emails are sent directly by email.
flowchart TD
A["Business event<br/>staff or student action, online payment,<br/>or a scheduled reminder job"] --> B{"Engine message<br/>or direct email?"}
B -- "engine message" --> C{"School's notification settings<br/>exist and are active?"}
C -- no --> X["Not sent<br/>(no row in the Notification Log)"]
C -- yes --> D{"Message switched on<br/>(Enabled)?"}
D -- off --> X
D -- on --> Q{"Inside quiet hours?"}
Q -- "urgent message" --> CH
Q -- "lesson or test reminder" --> H["Held until quiet hours end"]
H --> CH
Q -- "Student Welcome or text payment reminder" --> X
Q -- "outside quiet hours" --> CH["Choose channels<br/>Email: switched on and ticked<br/>SMS: switched on, ticked, plan + credits<br/>WhatsApp: switched on, ticked, plan + paid add-on<br/>Push: plan includes the Mobile App"]
CH --> R{"Recipient has an email address,<br/>phone number or registered phone?"}
R -- no --> X
R -- yes --> S["Send by Email / SMS / WhatsApp / Push"]
S --> L["Notification Log<br/>one row per channel: Sent or Failed"]
B -- "direct email" --> E["Email only<br/>(automatic invoice and reminder emails need the Email switch<br/>and the message switched on; manual sends ignore the settings)"]
E --> M["Your own SMTP server or DriveFlow's mail server"]
M --> L2["Notification Log<br/>(not for account emails or the test email)"]
Nothing is retried
A failed message is recorded as Failed in the Notification Log and is not sent again automatically. The only exception is the automatic payment reminder email, which is tried again at the next daily run. The booking, payment or other action that caused the message always goes ahead.
Immediate notifications¶
Sent at the moment the action happens.
| Notification | Who receives it | Channels | When | Details |
|---|---|---|---|---|
| Student Welcome | Student | Email, SMS, WhatsApp, Push | When the student is registered | Dropped (not delayed) during quiet hours. Triggers A1 |
| Lesson Booking Confirmation | Student | Email, SMS, WhatsApp, Push | When staff book a lesson, or approve the student's lesson request | One message per date. Triggers A2, A4 |
| Lesson Rescheduled | Student | Email, SMS, WhatsApp, Push | When staff move a lesson, or approve the student's change request | Triggers A6, A9 |
| Lesson Cancelled | Student | Email, SMS, WhatsApp, Push | When a lesson is cancelled | One message per day for a block or series. Triggers A11 |
| Lesson Request Declined | Student | Email, SMS, WhatsApp, Push | When staff decline a lesson or change request | Includes the reason typed by staff. Triggers A8 |
| Lesson Completed | Student | Email and Push only | When the student signs off a lesson after the instructor | Not in the settings list; follows the Email master switch. Triggers A13 |
| Invoice (Invoice Issued) | Student, or the customer on the invoice | Email only | When an invoice is created at registration, for an extra lesson or an assessment, or from a converted quote | SMS and WhatsApp ticks have no effect. Triggers B1-B4 |
Sent when a staff member clicks a button (these ignore the notification settings):
| Notification | Who receives it | Channels | When | Details |
|---|---|---|---|---|
| Invoice email | Student or walk-in customer | Email only | Send Email on an invoice | Not for cancelled invoices. Triggers B5 |
| Payment reminder | Student or walk-in customer | Email (plus SMS, WhatsApp, Push for student invoices) | Send Reminder on an invoice | Counts towards the reminder maximum. Triggers B7 |
| Quote | Student or customer on the quote | Email only | Sending a quote | Not for rejected quotes. Triggers B9 |
| Student portal invite | Student | Email only | Invite to portal / Resend invite | Not in the Notification Log. Triggers B12 |
| Notification | Who receives it | Channels | When | Details |
|---|---|---|---|---|
| New Lesson Assigned | Instructor | Email and Push (SMS or WhatsApp only if ticked in the owner's mobile app) | When staff book a lesson or approve a lesson request | Triggers A3, A5 |
| Lesson Rescheduled | Instructor the lesson belonged to before the move | Email and Push (as above) | When staff move a lesson, or approve a change request | The new instructor is not told. Triggers A7, A10 |
| Lesson Cancelled | Instructor | Email and Push (as above) | When a lesson is cancelled | Triggers A12 |
| New user account | The new staff user | Email only | When a staff user is created | Contains a temporary password. Not in the Notification Log. Triggers B10 |
| New password | That user | Email only | When an administrator resets a user's password | Not in the Notification Log. Triggers B11 |
| Password reset link | The user | Email only | Forgot password | Link works once, for 60 minutes. Not in the Notification Log. Triggers B13 |
| Welcome to DriveFlow | The school's email and the owner's sign-in email | Email only | When the school registers | Sent from DriveFlow's mail server. Triggers B14 |
| New registration alert | DriveFlow platform admin | Email only | When a school registers | Triggers B15 |
| Test email | The address typed | Email only | Send Test Email under Settings > Email | Not in the Notification Log. Triggers B19 |
Owners, administrators and receptionists are not notified of anything by email; only instructors receive staff messages.
Scheduled notifications¶
Sent by background jobs before or after a set time. See Lesson reminders for every rule.
| Notification | Who receives it | Channels | When | Details |
|---|---|---|---|---|
| Lesson Reminder | Student | Email, SMS, WhatsApp, Push | Default 24 hours before the lesson (school-wide, 15 minutes to 31 days); checked every 15 minutes | One per lesson; only lessons with status Scheduled; held during quiet hours. Lesson reminders |
| Driving Test Reminder | Student | Email, SMS, WhatsApp, Push | Default 24 hours before the test; checked every 15 minutes | Only tests with status Booked. Lesson reminders |
| Payment due soon | Student or walk-in customer on the invoice | Email (plus SMS, WhatsApp, Push for student invoices) | Daily run, by default 3 days before the due date, once | Rules under Settings > Payments. Lesson reminders |
| Overdue payment reminders | Student or walk-in customer on the invoice | Email (plus SMS, WhatsApp, Push for student invoices) | Daily run, by default 1 day after the due date, then every 7 days, at most 3 | Stop when the invoice is paid or cancelled. Lesson reminders |
| Reminders on the phone | Student using the mobile app | Phone notification (set by the app, not sent by the server) | 18:00 the evening before, and one hour before | For the next 10 lessons; not in the Notification Log. Lesson reminders |
| Document expiry reminder | Intended: the person who uploaded the document | Daily | Does not work in the current version. Lesson reminders |
Daily run times
The daily payment reminder run is scheduled for 08:00 UTC, which is 10:00 South African time, unless the deployment changes this. Reminder timing and quiet hours use the server's clock, not the branch time zone.
Payment-triggered notifications¶
Sent when a payment is recorded or confirmed. Payment reminders are in Scheduled notifications.
| Notification | Who receives it | Channels | When | Details |
|---|---|---|---|---|
| Payment Received | Student | Email with receipt PDF, SMS, WhatsApp, Push | When staff record a payment | Nothing is sent for a walk-in payment. Triggers A16 |
| Payment Received | Student | Email with receipt PDF, SMS, WhatsApp, Push | When PayFast confirms an online payment | Triggers A17 |
| Payment receipt | Student, or the customer email on the invoice | Email only | When staff click Email Receipt on a payment | Payment must be Successful. Use this for walk-in customers. Triggers B8 |
| Your DriveFlow invoice (paid) | The school's organisation email | Email only | When PayFast confirms a subscription, add-on or SMS bundle payment | Triggers B16 |
| Your DriveFlow invoice | The school's organisation email | Email only | When a SuperAdmin billing action raises a subscription invoice, or the invoice is sent from Settings > Billing | Triggers B17, B18 |
Nothing is sent when a payment is refunded or deleted, or an invoice is voided.
Notifications that need administrator configuration¶
What has to be in place before each channel works.
| Configuration | What it controls | Who sets it | Where | Details |
|---|---|---|---|---|
| Email channel switch | Default on. Off stops every automatic email; manual sends and account emails still go. | Notifications.Manage |
Settings > Notifications | Notification settings |
| SMS channel switch and SMS ticks | Default off. Needs a plan with SMS and, on a paid plan, prepaid SMS credits. One credit per SMS part; most messages use 2 or more. | Notifications.Manage; credits bought with Subscription.Manage |
Settings > Notifications; Settings > Billing | SMS notifications |
| WhatsApp channel switch and WhatsApp ticks | Default off. Needs a plan with WhatsApp and, on a paid plan, the paid monthly add-on. Meta's 24-hour rule blocks most messages. | Notifications.Manage; add-on paid with Subscription.Manage |
Settings > Notifications; Settings > Billing | WhatsApp notifications |
| Email server | DriveFlow's default mail server, or your own SMTP server (use port 587; 465 is not supported) | Email.Manage |
Settings > Email | Email notifications |
| Mobile App in your plan | Push is added automatically for students and instructors signed in on Android; no switch in the web settings | Your subscription plan | Your plan (upgrades under Settings > Subscription) | Push notifications |
| Reminder timing | How long before a lesson or test the reminder goes | Notifications.Manage |
Settings > Notifications > Reminders | Notification settings |
| Quiet hours | Urgent messages still go; reminders are held; Student Welcome and text payment reminders are dropped | Notifications.Manage |
Settings > Notifications > Quiet Hours | Notification settings |
| Payment reminder rules | Grace period, due-soon email, overdue reminders, repeat and maximum | Settings.Manage |
Settings > Payments | Notification settings |
| SMS, WhatsApp and push providers | The single platform SMS account, WhatsApp number and Firebase set-up. A school cannot change them. | DriveFlow platform team | Server configuration | Notification system overview |
Free trial
During a free trial, add-on features such as SMS and WhatsApp are available without paying for the add-on.
What is never sent¶
No message exists for these events, whatever the settings:
- A student marked as no-show, or a lesson deleted.
- An instructor signing off a lesson.
- A new lesson request or change request from a student (staff see it in the header bell only).
- The daily schedule for instructors (the setting exists but does nothing).
- Driving test booked, changed, cancelled, passed or failed, and learner's test events.
- Leads and lead follow-ups (header bell only).
- Trial ending, subscription expiring or expired, add-on lapsing, low SMS credits, failed subscription payment.
- Vehicle licence disc, roadworthy, insurance or service dates, and fleet alerts (header bell only).
- Instructor earnings, sales commissions and payouts.
- Refunds, deleted payments and voided invoices.
- Anything to a guardian or emergency contact.
- Instructor reviews.
The full list is in Notification triggers.
Delivery and troubleshooting¶
- Check what was sent: Settings > System > Notification Log shows every message sent or attempted, with its status. See Notification log.
- "Sent" is not "received": it means the provider accepted the message. If the platform has switched the SMS or WhatsApp provider off, messages still show as Sent.
- No row in the log means the message was never attempted: switched off, quiet hours, missing address or phone number, or the plan does not cover the channel.
- Fixing problems: Notification troubleshooting lists causes and fixes per channel, plus how to resend.
- Wording of each message: Notification templates.