Skip to main content

Notifications

CareLaunch provides a configurable notification system that delivers updates through multiple channels based on user preferences.

Overview​

The notification system enables you to:

  • Receive updates through multiple channels (Email, SMS, In-App, Push)
  • Configure notifications per event type
  • Manage preferences through a simple interface
  • Stay informed of important system events

Notification Settings​

Available Channels​

CareLaunch supports four notification channels:

  1. Email Notifications: Receive updates directly to your email inbox
  2. SMS Notifications: Get text message alerts on your mobile device
  3. In-App Notifications: View notifications within the CareLaunch platform
  4. Browser Push Notifications: Receive real-time alerts even when the app is not open

Configurable Events​

You can enable or disable notifications for these events across any channel:

  1. Appointment Assigned

    • Notifies a provider when they are assigned to an appointment
    • Includes a link to open the appointment details

  2. Appointment Confirmation Request

    • A separate notice, used when a provider is added and still needs to respond
    • Includes action buttons/links to confirm or decline directly

  3. Patient Arrived

    • Alerts providers when a patient joins a virtual visit
    • Enables timely start of telehealth appointments
    • Automatically updates appointment status to "arrived"

  4. Task Assignment

    • Alerts for new task assignments
    • Helps manage workload
    • Ensures task visibility

  5. Patient Registered

    • Notifications for new patient registrations
    • Tracks patient onboarding
    • Maintains patient awareness

  6. New Message

    • Alerts for new communications
    • Ensures timely responses
    • Maintains communication flow

  7. Lab Results Ready for Review (staff only)

    • Notifies staff when lab results are available for clinical review
    • Ensures timely patient follow-up
    • Supports clinical workflows

  8. Lab Results Available (patient)

    • Notifies patients when their lab results are ready to view

  9. Urgent Patient Alert (staff only)

    • High-priority notifications for urgent patient matters
    • Ensures immediate attention to critical situations
    • Supports emergency response workflows
note

The two lab results types and Urgent Patient Alert appear in notification preferences, but no built-in CareLaunch event sends them today.

Template Requirements & Delivery Safeguards​

CareLaunch notification channels that rely on templates now use a fail-safe behavior when a template is not configured.

Missing Template Behavior​

If an event is configured but no template is assigned:

  • Email/SMS reminder sends are safely skipped (no partial or malformed send)
  • A warning is logged for administrators and support teams
  • Delivery status metadata is updated where applicable (for example, invitation error details)

This prevents noisy failures and makes delivery issues easier to troubleshoot in reports and logs.

Invitation Failure Reason Consistency​

For invitation flows, failure reasons are stored in a human-readable format (for example, Notification type disabled) so downstream dashboards, filters, and UI displays stay consistent.

Managing Notifications​

Accessing Settings​

Staff open their preferences from the sidebar: click Notifications, then the Notification preferences icon (a bell with a gear) at the top of the page. Patients use Profile > Notification Settings in the patient portal, which covers email and SMS.

Configuring Preferences​

  1. Email Notifications

    • Toggle switches for each event type
    • Enable/disable email notifications
    • Updates take effect immediately

  2. SMS Notifications

    • Configure text message alerts
    • Toggle per-event SMS notifications
    • Requires verified phone number

  3. In-App Notifications

    • Set platform notification preferences
    • Toggle notifications by event
    • View notifications in real-time

Browser Push Notifications​

Browser push notifications allow you to receive real-time alerts even when the CareLaunch application is not open in your browser.

Enabling Push Notifications​

  1. Click Notifications in the sidebar, then the Notification preferences icon at the top of the page.
  2. Turn on the Browser channel, or turn on Browser for individual notification types.
  3. When prompted by your browser, click Allow to grant permission.

Supported Browsers​

Push notifications are supported on:

  • Google Chrome (desktop and Android)
  • Mozilla Firefox (desktop)
  • Microsoft Edge (desktop)
  • Safari (macOS Ventura and later, iOS 16.4 and later)

Managing Push Notifications​

  • Per-device: Push notifications are registered per browser/device
  • Multiple devices: You can enable push notifications on multiple devices
  • Disable anytime: Turn off the Browser channel in your notification preferences, or revoke the browser permission

Troubleshooting Push Notifications​

Not receiving notifications?

  • Check that your browser supports push notifications
  • Verify you've granted permission (look for the lock icon in your browser's address bar)
  • Ensure the notification type is enabled in your preferences
  • Check that your browser is not in "Do Not Disturb" mode

Permission was denied?

  • You'll need to manually enable notifications in your browser settings
  • In Chrome: Settings → Privacy and Security → Site Settings → Notifications
  • In Firefox: Settings → Privacy & Security → Permissions → Notifications

Best Practices​

Optimizing Notifications​

  • Enable notifications relevant to your role
  • Choose appropriate channels for urgency level
  • Review and update preferences regularly
  • Maintain organized notification management
  • Use push notifications for time-sensitive alerts

Channel Selection​

  • Use Email for detailed updates and records
  • Enable SMS for urgent notifications
  • Keep In-App notifications for platform activity
  • Enable Push for real-time alerts when away from the app

Last updated: March 2026