Slack

Send notifications to designated Slack channels.

Prerequisites for Adding a Slack Notification Channel

To send Validio notifications to designated channels in Slack, you will first need to create and configure an app in Slack with the necessary permission scopes to communicate with your Validio installation. You can find step-by-step instructions for creating and configuring the Slack app in the following guide, Setting up a Slack App for Validio.

Create a Notification Channel for Slack

To add a new notification channel for Slack,

  1. In Validio, navigate to Notifications > Channels and click + New Channel.
  2. From the Channel type list, select Slack.
  3. Select the Namespace where the channel will be created.
  4. Enter the Name, Channel ID, Bot Token, App Token, and Application Link URL to configure the channel. For more information, see Slack Configuration Parameters.
  5. (Optional) Check Interactive Message to manage or triage the incident from the notification message sent to Slack.
  6. (Optional) Test the channel.
  7. Click Create.

Slack Configuration Parameters

Field

Description

Channel type

Select Slack as the Channel type to send notifications to.

Namespace

Select the namespace where the channel will be created. Only users who are assigned to the same namespace will have access to this channel.

Name

Identifier for this Validio channel, used to configure notification rules.

Channel ID

ID of the channel in your Slack workspace where the notification messages will be sent. You can find the channel ID in the Slack channel details.

Bot Token

Bot User OAuth Token that is used to authenticate your app for sending messages. You can find this token under Features > OAuth & Permissions > OAuth Tokens. You will need to install the app to your workspace to generate the token. The bot token string contains the prefix: xoxb-

App token

App-level token used to retrieve user events from Slack. You can find and generate this token on Settings > Basic Information under App-Level Token. The app token string contains the prefix: xapp-

Note: App-level tokens require "Socket Mode" to be enabled for the app. Navigate to Settings > Socket Mode > Connect using Socket Mode to enable to the function.`

Application link URL

The URL for your Validio application instance, which will be used to send notifications. For example, https://my-company.validio.io.

The application link URL is predefined based on the web browser URL to your Validio instance. This is NOT the same as the request URL.

Notifying Multiple Slack Channels with one Slack Bot

You can use one Slack bot to notify in more than one Slack channel, but you need to create a Validio channel for each Slack channel. The notification channels can use the same parameters (Token, Signing Secret, and so on), except Channel ID which will be specific to the individual channels.

Slack Notification

Example of notification message with management options

When the notification rule is triggered, a notification is sent to the specified Slack channel. Incident notifications are grouped together and details are provided in threads. You can update the status and owner, mute future notifications, and add comments within the message thread. For more information, see Notification Rules.

📘

Notifications on Backfilled Validators

Validio does not send notifications for incidents when backfilling validators.