6 Bugs in WhatsApp Appointment Reminder Systems (and How to Fix Them)

Appointment reminders look like a cron job and a message. In production, these six bugs show up first.

1. Reminder after a cancellation
   The patient cancelled, but the T-24h job still fires. Fix: unschedule pending jobs on every cancel or reschedule.

2. Wrong time zone
   The appointment was stored in local time and the server runs UTC, so the reminder arrives at the wrong hour. Store timestamps with the time zone and convert once.

3. Duplicate reminders
   The booking was edited twice and three jobs exist. Fix: one job per appointment per stage, keyed on appointment_id + stage.

4. Sent at 2 AM
   A booking made late at night for an early slot triggers a T-2h reminder in the middle of the night. Add quiet hours and skip or shift those reminders.

5. Reply not linked to the booking
   The patient taps “Reschedule”, but the webhook can’t tell which appointment it’s for. Put the appointment ID in the button payload.

6. Diagnosis in the message
   “Reminder: your knee MRI follow-up…” is health information on a lock screen. Keep reminders generic: date, time, clinic, reference number.

Bonus for physiotherapy clinics: send the home exercise plan as a link after each session. It’s helpful for patients and a good reason for them to keep the chat open.

Wabbiyo handles reminders, reply buttons and rescheduling on the official WhatsApp API for WordPress sites. See the physiotherapy clinic setup, or wabbiyo.com.