Table of Contents

Notification Preferences

Morgan Wynnes Updated by Morgan Wynnes

Read Time: 5 mins

Notifications are used to alert Sonar users for various events that occur within the instance; this can range from being notified of when a ticket is assigned to you or a group you belong to, to being made aware of an upcoming due date for an assigned task. These notifications are available in different formats and help to eliminate the chance of important events and information from going unnoticed.

Notification Types

Currently, there are two different types of notifications available: in-app notifications, and email notifications. Users can opt to receive both notification types, just in-app, just email, or neither. Both of these types are explained in further detail below.

By default, all newly created Sonar users will have all in-app notifications enabled, but this can be changed as needed. To learn more about modifying these settings, read the Updating Your Notification Preferences section below.

In-App Notifications

In-app notifications allow you to receive updates without needing to navigate out of your Sonar instance. When a notification is received, a red badge will appear on the Sonar icon in the top-left corner of your instance; the number displayed in the red badge will indicate the number of unread notifications.

To view the notifications, simply click on the Sonar icon, and the list of notifications will be displayed. For each individual notification in the list, there will be an indicator of how long ago the event occurred, visible from the far right side of the notification item.

To view additional details for a notification, simply click on the notification from within the list - it will automatically open a side panel where further details for the event and its associated entity can be viewed.

Older notifications will be automatically deleted from the notifications list after a period of 30 days.
Notifications vs Alerts

Within the Notifications list are two tabs: Notifications and Alerts. All in-app notifications will appear under the "Notifications" tab, with the exception of network alerts that are generated as part of an alerting rotation; if you have in-app notifications toggled on for the "When a network alert is generated for one of my alerting rotations" event, then these specific notifications will appear under the "Alerts" tab instead.

Sorting by Time, Category, and Entity

With the in-app notification list, users are able to sort their notifications by time, category, or entity.

Time: Selecting the "Time" button will sort the notification list by how long ago the event occurred, with the most recent notifications displayed at the top of the list.

This list will be further split up into "Read" and "Unread" sections; when a new notification is received, it will be housed under the "Unread" section, moving into "Read" once the notification has been viewed.

Category: Selecting the "Category" button will group the notifications based on event type. For example, any job-related notifications will be grouped together and displayed under the subheading "Job", whereas task-related notifications will be grouped together and displayed under the subheading "Task".

Within each of these subsections, all of the notifications will be sorted by how long ago the event occurred, with the most recent notification being displayed at the top of the section.

Entity: Selecting the "Entity" button will group notifications by the individual event, and display multiple notifications for the same event together. For example, as can be seen in the image below, each job or task that is assigned will appear as individual entities within the notifications list; if there are multiple events for the same entity (such as having a job assigned to you which is then rescheduled and completed successfully), they will all appear under that specific entity.

For each entity in the list, all of the notifications will be sorted by how long ago the event occurred, with the most recent notification being displayed first.

Email Notifications

With email notifications, updates will be sent in an email directly to your inbox, based on the email address that is associated with your Sonar instance user. These emails are defaults within the system and do not require any configuration in order for email notifications to be functional.

When an event triggers a notification, an email will be sent to your inbox and the email subject will be reflective of the event that occurred.

Within the email itself, the format will be similar to other communications that are sent from your Sonar instance; for example, your company logo will be present, along with your company information that is displayed through the footer at the bottom of the email. Additional key details will be contained within the email, such as the time and date the event occurred, and will vary depending on the type of event that was triggered (for example, if a job you are assigned to was completed successfully, it will also include the name of the user that completed the job).

The content contained within these system-generated emails cannot be modified; however, the company-specific information that gets displayed within the email will be based on the company that is set to be the default for your Sonar instance.

Updating Your Notification Preferences

Notifications will only be received if the event is triggered by another user. For example, if you have the "When a task is assigned to me" event toggled to receive notifications, and you assign a task to yourself, you will not be notified of this event.

Your notification preferences can only be accessed by your instance user, and are available from the "My Info" page for your Sonar instance user - you can navigate there in two different ways:

  1. From the top-right corner of your Sonar instance, click on your avatar > From the dropdown, select "Notification Preferences"
  2. From the top-right corner of your Sonar instance, click on your avatar > From the dropdown, select your name
For more information on the "My Info" page and the other settings available there, refer to the My Info: Your Personal User Settings article here.

All of the events that you can be notified of will be listed underneath the Notification Preferences section. For each event, there will be a toggle for in-app notifications and email notifications; toggling the events here will determine which notifications you receive, and in what format.

Any changes made to your notification preferences are saved automatically.

How did we do?

Mutations in the Sonar API

API Calls Using Third Party Applications: Personal Access Tokens