Module, SMS Notifications

SMS
Gateway

Configurable HTTP SMS provider, event-driven rules, BullMQ delivery with retries, and a permission-gated delivery log. Provider secrets stay masked in the UI.

What it covers

SMS hub settings (endpoint, auth, templates), rules that map clinical/operational events to recipients (appointments, lab, leave, billing, and more), queue-backed sends with deduplication, and delivery audit history.

Why

  • → Patients and staff need reliable outbound reminders
  • → Retries and logs prevent silent delivery failures

SMS delivery path

Technical Architecture

FieldTypeInstitutional Role
eventKeyStringTriggering domain event.
recipientStringMasked phone in UI where required.
statusEnumQueued, sent, failed, retried.
providerResponseJSON?Gateway payload for troubleshooting.

Note: Sensitive fields use AES-256 field-level encryption where applicable.

Governance & Power

sms:settings:view
sms:rules:view
sms:log:view