This document helps you configure notification messages sent to your organization from the Expel Workbench.

Tip

This article was accurate at the time of writing, but changes happen. If you find the instructions are outdated, leave a description in the comment field below and let us know!

To perform this procedure, you must have:

  • Organization admin privileges in Workbench.

  • At least 1 communication channel established between your organization and Workbench. Communication channels currently available include:

    • Slack

    • Teams

    • Ticketing System: Asana, JIRA, ServiceNow

    • PagerDuty

    • OpsGenie

Note

If you don't see a link to the needed communication channel, contact your engagement manager for help.

What are organization notifications?

Expel Workbench sends alerts and other messages to your organization. What these messages are about and how you should react varies from one to the next. To acquaint yourself with notifications and how to interpret them, read the Notification definitions guide.

How do I set up notifications for my organization?

Organization admins can choose which notifications to receive and how they are received. Any communications tool your organization integrates with Workbench can be used. This includes Slack, PagerDuty, and more.

Use the Organization Notifications checklist to make a list of the notifications you're interested in receiving and how you want them delivered. You can refer to this during the setup process.

The setup process is pretty simple. If you've ever created a rule in an email program, then this looks familiar:

  • First, select the event to watch, like incidents or investigations. Let's say Investigation.

  • Second, select an action, like opened or closed. (Investigation is closed.)

  • (Optional) If +Add Condition appears, you can refine your notification by selecting a general condition, like reason to close, and then selecting a specific condition, like possible policy violation. (Investigation is closed and the reason to close is a possible policy violation.) Conditions narrow your notifications down to specific issues you care the most about.

  • Finally, select one or more communication paths. If there is a communication path you want but it's not there, contact your engagement manager. (When Investigation is opened, notify through Slack and PagerDuty.)

That's all there is to it! Workbench sends the selected notifications to your organization through the communication path(s) you specified as events occur.

Organization admins can view, add, edit, and delete organization notifications. Click below to jump to a task:

Viewing notifications

To view notifications settings for your organization, take these steps:

  1. In a new browser tab, login to https://workbench.expel.io.

  2. From any screen, click Settings.

    WB_Settings_Navigate.png
  3. Click My Organizations on the left side of the screen.

    mceclip4.png
  4. Click the Notifications tab.

    mceclip5.png
  5. The notifications are listed in the tab.

    mceclip4.png
Adding notifications

To add notifications, take these steps:

  1. Click Add Notification.

    mceclip5.png
  2. A blank notification appears.

    mceclip6.png
  3. Select an event.

    mceclip7.png
  4. Select an action for that event.

    mceclip8.png
  5. (Optional) If +Add condition is available, click it and then select a condition and a specific property for that event.

    CondNotification_SelectCondition.png
  6. Select a notification channel.

    mceclip9.png
  7. (Optional) Click + Add Another add another notification channel.

    Tip

    You can select 2 or more channels for a notification.

    mceclip10.png
  8. mceclip11.png
  9. The notification appears under the Notifications tab.

    mceclip13.png
Editing notifications

To edit notifications, take these steps:

  1. Hover your mouse pointer over the notification and click the pencil.

    mceclip15.png
  2. The notification appears.

    mceclip16.png
  3. Change the notification as needed.

    mceclip17.png
  4. Your edited notification appears in the Email Notifications section.

    mceclip18.png
Deleting notifications

To delete notifications, take these steps:

  1. Hover your mouse pointer over the notification and click the trash can.

    mceclip19.png
  2. The Delete Notification popup appears. Click Delete.

    mceclip20.png
Where do we go from here?

After setting up notifications for your organization, a logical next step should be to set up notifications for your individual users. Similar to organization notifications, user notifications are sent through email. For instructions, see the User Notifications setup guide.