Appointment Reminders
Configure automated SMS and push reminders sent 24 hours and 1 hour before appointments
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:
- 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).
- 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]”
- 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
- Verify Contact Information — Ensure patient phone numbers are correct during registration. Incorrect numbers mean reminders will not be delivered.
- 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).
- 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.
- 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
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?
Related Articles
Receptionist Dashboard
Overview of today's appointments, queue status, and check-ins pending
📋Patient Registration
Register new patients with National ID auto-parsing, insurance info, and consent management
📅Appointment Scheduling
Book appointments by selecting patient, doctor, date, time slot, type, and duration