Web & Email Notifications

Web Notifications

OpenWISP Notifications sends web notifications to recipients through Django's admin site. The following components facilitate browsing web notifications:

Widget

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/notification-widget.gif

The OpenWISP admin includes a notifications widget with the following features:

  • Infinite scroll to load notifications dynamically and smoothly.

  • Button to mark all as read.

  • Button to edit Notification Preferences.

Toasts

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/notification-toast.gif

Notification toasts display messages in real time, so users can read them without opening the widget. A bell sound plays each time a toast is shown.

To prevent overload, an anti-storm mechanism temporarily disables toasts when many notifications arrive in a short time. Refer to OPENWISP_NOTIFICATIONS_NOTIFICATION_STORM_PREVENTION for more information.

Email Notifications

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/25/emails/template.png

Along with web notifications OpenWISP Notifications also sends email notifications leveraging the send_email feature of OpenWISP Utils.

Email Batches

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/25/emails/batch-email.png

Batching email notifications helps manage the flow of emails sent to users, especially during periods of increased alert activity.

By grouping emails into batches, the system minimizes the risk of emails being marked as spam and prevents inboxes from rejecting alerts due to high volumes.

Key aspects of the batch email notification feature include:

  • When multiple emails are triggered for the same user within a short time frame, subsequent emails are grouped into a summary.

  • The sending of individual emails is paused for a specified batch interval when batching is enabled.

Note

If new alerts are received while a batch is pending, they will be added to the current summary without resetting the timer. The batched email will be sent when the initial batch interval expires.

You can customize the behavior of batch email notifications using the following settings:

Unsubscribing from Email Notifications

In addition to updating notification preferences via the preferences page, users can opt out of receiving email notifications using the unsubscribe link included in every notification email.

Furthermore, email notifications include List-Unsubscribe headers, enabling modern email clients to provide an unsubscribe button directly within their interface, offering a seamless opt-out experience.