Appointment Reminders

Configure automated SMS and push reminders sent 24 hours and 1 hour before appointments

3 min read

Overview

Appointment Reminders in SehaFile are automated notifications sent to patients before their scheduled appointments. The system runs an hourly cron job that checks for appointments 24 hours ahead and sends reminders via in-app notifications, SMS, or push notifications. This significantly reduces no-show rates and helps patients prepare for their visits.

Appointment reminder settings page showing notification channels and timing configuration

How Reminders Work

Automatic Reminder System

The reminder system operates automatically with this flow:

  1. Hourly Check — Every hour, the system scans for appointments scheduled within the next 24-25 hours that have not yet received a reminder (reminder_sent = false).
  2. Send Notification — For each qualifying appointment, a notification is created with:
    • Arabic title: “تذكير بالموعد”
    • English title: “Appointment Reminder”
    • Arabic body: “لديك موعد غدا الساعة [time]”
    • English body: “You have an appointment tomorrow at [time]”
  3. Mark as Sent — The appointment's reminder_sent field is set to true, preventing duplicate reminders.

Notification Channels

  • In-app notification — Always sent; appears in the patient's Citizen App notification center
  • SMS — Sent to the patient's registered phone number (requires SMS credits)
  • Push notification — Sent if the patient has the Citizen App installed with push enabled

Receptionist's Role in Reminders

  1. Verify Contact Information — Ensure patient phone numbers are correct during registration. Incorrect numbers mean reminders will not be delivered.
  2. Monitor Reminder Status — In the appointment list, a “reminder sent” indicator shows which appointments have had reminders delivered. If an appointment tomorrow has not triggered a reminder, check that its status is “scheduled” (cancelled appointments do not get reminders).
  3. Manual Reminder for Same-Day — The automated system only sends reminders ~24 hours before. For same-day appointments or urgent schedule changes, manually call or message the patient.
  4. Handle Reminder Responses — If a patient calls back after receiving a reminder to confirm, cancel, or reschedule, process their request through the appointment management system.

Reminder Conditions

A reminder is sent only when ALL of these are true:

  • Appointment status is “scheduled”
  • Appointment is 24-25 hours in the future
  • reminder_sent is false (not already sent)
  • Patient has a valid contact method
Tip: Reminders are the most effective way to reduce no-shows. Studies show SMS reminders reduce no-show rates by 30-40%. Always ensure patient phone numbers are up to date.
Tip: If a patient says they did not receive a reminder, verify their phone number in the patient profile and check that the appointment status was “scheduled” at the time the reminder job ran.
Warning: Reminders are only sent for appointments with status “scheduled.” If an appointment is cancelled and then rebooked, ensure the new appointment has reminder_sent = false so the system sends a fresh reminder.

FAQ

Can I change the reminder timing?

The default is 24 hours before the appointment. Timing adjustments require admin configuration. Contact your clinic administrator to modify the reminder schedule.

Are reminders sent for walk-in patients?

No. Walk-in patients are already at the clinic, so no reminder is needed. Reminders only apply to future scheduled appointments.

What if the SMS fails to deliver?

The system logs SMS delivery failures. The reminder_sent flag is still set to true to prevent retry loops. For critical appointments, follow up manually by phone.

Can patients opt out of reminders?

Currently, all patients with scheduled appointments receive reminders. Opt-out functionality may be added in future updates through the Citizen App settings.

Was this article helpful?