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.

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 the channel to which notifications must be sent. Based on the selected channel, the message configuration section is displayed. 

10. 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. 
  • 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. 
  • For Webhook:
    • JSON - The message is sent in the JSON format. 

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.

11. 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 stop sending notifications when an event is triggered from the configured data source.