System Notifications

This article describes the procedures for setting up and managing system notifications.

System notifications allow users to configure the data source, events, and channels on the system notification page. When an event is triggered from the specified data source, a notification is sent to the configured channel if the conditions match. For example, if you set the data source to ActOn and choose events such as Closed, Created, and Priority Changed, and select Slack as the notification channel, then whenever an ActOn is closed, created, or has its priority changed, a real-time notification is sent to the configured Slack channel, updating users about the ActOn's status. This setup is for Match all, meaning notifications are triggered when all specified events occur.

However, users can also define conditions for notifications to be sent only when certain conditions are met. This flexibility allows users to receive relevant notifications for signals, Situations, ActOns, or entities. Users can also choose the timing during which the notifications should be received. They can choose to receive notifications always, during business hours or outside business hours. 

Additionally, they can choose between card or plain body message types to control the information shared in notifications. The card type message will be predefined and non-editable whereas plain text can be a custom message.

Furthermore, users can create new channels directly from the channel drop-down menu.

Creating a System Notification

Use this procedure to create a system notification. 

To create a system notification:

1. Do one of the following to access configurations:

• Click the Configurations icon   at the top of the navigation bar
• Click the hamburger menu on the left and select CONFIGURATIONS.

2. From the left menu, under Notifications, click System Notifications.
You will be redirected to the System Notifications page

3. Click Create System Notification.
A new Create System Notifications page appears

4. Enter a unique notification name.

5. Enter Description (Optional).

6. Select the data source. Possible values:

• ActOn
• Entity
• Signal
• Situation

7. Select events from the Events drop-down for which notifications should be sent to the configured channel. The event values differ from one Data source to another.

8. Do one of the following:

• Select the "Match All" checkbox to receive notifications for all selected events when they occur. (or)
• Clear the Match all check box to enable add conditions. Once enabled:
  • Click +Add Condition or +Add Group
  • Select an attribute, operator (Equals or in) from the drop-down list and enter their respective value.
  • Click And (or) Or conditions

For example, if you set the criteria to "Asset name equals Windows" AND "Priority equals P0," you will receive a notification whenever an event meets both conditions. This ensures that you are notified only when the specified asset is "Windows" and its priority level is "P0."

9. Select when notifications should be received. Possible values:

• Anytime – Users receive notifications whenever the selected events are triggered from ActOn, Entity, Signal, or Situation sources.
• During Business Hours – Users receive notifications only during defined business hours.
• Outside Business Hours – Users receive notifications only outside of defined business hours.

Note: If the business hours in the Account Settings are set to 24/7, the Configure Now option will be available. Click this option to select the days of the week and time ranges during which notifications should be received.

You can choose whether notifications should be received during or outside the specified time range. Once custom business hours are configured, two options—During Business Hours and Outside Business Hours—will be available for selection.

10. Select the channel to which notifications must be sent. Based on the selected channel, the message configuration section is displayed. 

11. Select the message type as follows:

• For emails
  • HTML - You can add the email message with header and footer. 
  • Plain text - You can compose the message to be sent to recipients in plain text format without header and footer. 
• For teams
  • Microsoft Teams card - The message is non-editable, and the content on the card varies depending on the selected data source. This data source can be an entity, ActOn, Signal or a Situation.
  • Plain text - You can compose the message in plain text. To include variable data, insert predefined variables using the Add Field option.
• For Slack
  • Slack card -The message is non-editable, and the content on the card depends on the selected data source.
  • Body -You can compose the message in plain text. To include variable data, insert predefined variables using the Add Field option.
• For Webhook:
  • JSON - The message is sent in the JSON format. 
• For Pub/Sub:
  • JSON - The message is sent in the JSON format. 
• For Google Workspace
  • Google Workspace Card - The message is non-editable, and the content on the card varies depending on the selected data source. This data source can be an entity, ActOn, Signal or a Situation.
  • Plain text - You can compose the message in plain text. To include variable data, insert predefined variables using the Add Field option.
• For Webex space
  • Message - You can compose the message in plain text. To include variable data, insert predefined variables using the Add Field option.

Note: You can view all the channels configured in this organization or tenant in the drop-down. If you want to create a new channel, click Create Channel. See Notification Channels.

12. Click Submit.
The newly created system notification will be added to the existing list of system notifications. 

Managing system notifications 

Use this procedure to manage system notifications. You can view, edit, delete and deactivate the system notifications. 

1. Do one of the following to access configurations:

• Click the Configurations icon at the top of the navigation bar.
• Click the hamburger menu  on the left and select CONFIGURATIONS.

2. From the left menu, under Notifications, click System Notifications.

You will be redirected to the System Notifications page

3. Review the System Notifications details:

Field name	Field description
Name	The name of the system notification.
Description	The description of the system notification.
Channel type	The channel to which notifications should be sent in real-time.
Data Source	The data source configured. It can be an entity, a signal, a Situation or an ActOn.
Created on	The date on which the system notification is created.
Created by	The user who created this system notification.
Updated on	The date on which the system notification was last updated.
Updated by	The user who last updated this system notification.

4. Click on the ellipses icon corresponding to the system notification on which you want to perform different actions:

• • View - Select to view system notification details. 
  • Edit - Select to modify system notification details. 
  • Delete - Select to delete the system notification. 
  • Deactivate - Select to deactivate system notifications. Deactivating will prevent notifications from being sent when an event is triggered from the configured data source. However, you can use the Activate option to reactivate system notifications.