This guide discusses the steps to create a Slack app and configure it to communicate with your Validio installation. These steps are a prerequisite for setting up a Validio notification channel for Slack. For more information, see the Slack integration.

You will need to complete the following steps before you can create a notification channel to send messages and alerts from Validio to your Slack workspace:

1. Create a Slack app for Validio
2. Assign permission scopes to your app
3. Configure the app Request URL
4. Install the app in your workspaces
5. Invite the app to your channels

Create a Slack app for Validio

In your App Management dashboard, click Create New App and Create an app from scratch. Give your app a name and assign it to your Slack workspace.

You will use authentication and secret credentials from the created app to set up a Slack channel within Validio. This enables Validio to send messages to any configured Slack channels and process user interactions on those messages (such as muting incidents from Slack).

For more information, see Slack documentation on creating a new Slack app.

Assign Permission Scopes to App

Slack uses scopes to give your app permissions to perform actions, such as posting messages to your workspace.

You can find the scopes in your App Management dashboard under Features > OAuth and Permissions > Scopes.

Add the following scopes Bot Token Scopes to your app:

For more information, see Slack documentation on assigning scores to an app.

Configure the App Request URL

To interact with the Slack messages sent from Validio (for example, to mute incidents using Slack), Slack needs to be able to communicate back to Validio. Enable this communication by configuring the Slack app with a Request URL.

The app Request URL should be the /slack-webhook https endpoint of your Validio installation. For example, https://my-company.validio.io/slack-webhook. You can find this URL in your App Management dashboard under Features > Interactivity & Shortcuts.

For more information, see Slack documentation for configuring a request URL for your app.

Install the App in Workspaces

Install the app to the Slack workspace where it will be used.

📘

Note

OAuth tokens will be automatically generated when you finish installing your app to your workspace. You’ll use these tokens to authenticate your app.

For more information, see Slack documentation for installing an app to a workspace.

Invite the App to Channels

To allow the app to post messages, invite the installed app to any Slack channels where notifications will be sent.

Configure a Validio Notification Channel for Slack

After you set up your Slack app for Validio, you can create a Validio notification channel to communicate with the Slack app and send messages and alerts to your workspaces and channels in Slack. For more information, see steps for configuring a Validio Notification Channel for Slack.