Skip to content

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.
  • LoggingWhatsAppService exists 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

  1. The plan includes the WhatsApp feature.
  2. 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).
  3. WhatsApp is switched on under Settings > Notifications > Notification Channels.
  4. The WhatsApp box is ticked on the message's row and the row is Enabled.
  5. The recipient has a phone number on their record.
  6. The platform has the provider enabled and configured.
  7. The 24-hour rule in section 3 is met.

5. Switching WhatsApp on (school)

Who: Notifications.Manage.

  1. Open Settings > Notifications.
  2. 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."
  3. Tick the WhatsApp box on each student message you want.
  4. 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.