WhatsApp notifications¶
Applies to: Owner, Administrator and any role with Notifications.Manage; SuperAdmin / server administrator for provider configuration. Last reviewed: 2026-11-18.
WhatsApp is an optional channel, sold as a monthly add-on, for the messages the notification engine sends. Read section 3 before relying on it: because of Meta's 24-hour rule, most WhatsApp notifications are refused in the current version.
1. What WhatsApp is used for¶
WhatsApp is an optional extra channel for the same messages as SMS: Student Welcome, Lesson Booking Confirmation, Lesson Reminder, Driving Test Reminder, Lesson Rescheduled, Lesson Cancelled, Lesson Request Declined, Payment Received and Payment Reminder.
It is not used for Invoice Issued, Lesson Completed, documents, account emails or messages to the school.
The WhatsApp text is the plain-text version of the email.
2. Provider¶
- The provider registered in the API is
MetaWhatsAppService, which calls the Meta WhatsApp Cloud API. LoggingWhatsAppServiceexists in the code but is not registered.- One WhatsApp business number, owned by the platform, serves every school. A school cannot connect its own WhatsApp number for notifications. (The Facebook connection under Settings > Integrations is for importing leads and is a different feature.)
Platform configuration (server administrator)¶
Configuration section MetaWhatsApp:
| Setting | Purpose | Default in code |
|---|---|---|
Enabled |
Master switch for real sending | false |
BaseUrl |
Graph API address | Meta graph address |
ApiVersion |
Graph API version | v21.0 |
PhoneNumberId |
Id of the WhatsApp business number (not the number itself) | empty |
AccessToken |
Permanent system-user token | empty |
DefaultCountryCode |
Dialling code added to local numbers | 27 |
TimeoutSeconds |
Request timeout | 15 |
There is no page in the application for these.
A disabled provider is still logged as Sent
When Enabled is false, the service logs "[WhatsApp disabled] Meta WhatsApp is not enabled; message to ... was not sent." and returns normally, so the Notification Log shows Sent although nothing left the server.
3. The 24-hour rule (important)¶
DriveFlow sends every WhatsApp notification as free-form text. Meta only accepts free-form text to a person who has messaged the business number within the last 24 hours. Outside that window Meta rejects the message (error code 131047) and requires an approved message template.
DriveFlow does not use approved message templates
In practice this means a WhatsApp notification to a student who has not recently written to the business number will fail, and the Notification Log will show Failed with Meta's response.
Treat WhatsApp as unreliable for first contact and for reminders until template support is added. Email remains the dependable channel.
4. What a school needs before WhatsApp works¶
All of the following must be true
- The plan includes the WhatsApp feature.
- On a paid plan, the WhatsApp add-on is paid up (it is a monthly add-on; on a free trial it works without payment).
- WhatsApp is switched on under Settings > Notifications > Notification Channels.
- The WhatsApp box is ticked on the message's row and the row is Enabled.
- The recipient has a phone number on their record.
- The platform has the provider enabled and configured.
- The 24-hour rule in section 3 is met.
5. Switching WhatsApp on (school)¶
Who: Notifications.Manage.
- Open Settings > Notifications.
- In Notification Channels, switch WhatsApp on.
- Not in the plan: "WhatsApp is not included in your plan. Upgrade under Settings > Subscription to use it."
- Add-on not paid: "WhatsApp is a paid add-on. Activate it under Settings > Billing to use it."
- Tick the WhatsApp box on each student message you want.
- Click Save Changes.
Screenshot to be added
Screen: Notification Settings. Should show: WhatsApp channel card showing the add-on warning text.
6. Cost¶
WhatsApp is a monthly add-on bought under Settings > Billing. There is no per-message charge or credit count in DriveFlow. The Billing page offers a discount when it is bought together with the Leads add-on.
When the paid month ends and is not renewed, the feature drops out and the engine stops using the channel; nothing is logged per message for that case.
7. Phone numbers¶
The same conversion as SMS is applied (PhoneNumberNormalizer): local numbers get the default country code, and the plus sign is removed. See SMS notifications section 6.
8. Failures and retries¶
| What is logged | Cause |
|---|---|
| "Meta WhatsApp is enabled but the access token or phone number id is not configured." | Platform configuration incomplete |
| "'...' is not a valid destination number." | The stored phone number has no digits |
| "Meta WhatsApp send failed with status 4xx: ..." with Meta's response | Most often the 24-hour rule (131047), a number without WhatsApp, or an expired token |
| "Recipient has no phone number." | Never logged in practice: a recipient with no number is skipped before a log row is created, with a warning in the server log |
Nothing is retried. "Sent" means Meta's API accepted the request; delivery and read receipts are not tracked.
9. Limitations and notes¶
- No approved templates, so the 24-hour rule blocks most unsolicited messages.
- No inbound messages, no delivery or read status.
- The school cannot use its own number.
- A disabled provider is logged as Sent.
- The caption "WhatsApp can be enabled when a WhatsApp provider is configured." on the settings page is static text.