Slack

Overview

Sifflet Slack integration allows you to receive notifications in case of data quality issues on your most critical tables.

Set up the Integration

To set up the integration, go through the following steps:

• Go to Settings > Alerts Destinations
• Click on the Connect to Slack button

• You should be redirected to a Slack page describing the permissions required by the Sifflet App and prompting you to grant these permissions for your workspace
• Select the workspace you want to integrate the Sifflet App with using the dropdown menu at the top right hand corner of the page
• Grant the Sifflet App permission to access the selected workspace clicking on the Allow button

• You should be redirected to the Alert Destinations page of the Sifflet application and you should see the name of your workspace on the Slack integration tile. This indicates your integration is properly configured.

Configure Channels

Public Channels

From the List

By default, Sifflet tries to pull the list of your public channels. To configure a channel, open the Slack channels dropdown menu, search for your Slack channel of interest, and click it.

The selected channel appears below, in the Configured Slack channels list. This indicates your channel is properly configured.

Manually

In some cases, notably if your Slack workspace has a very large number of channels, Sifflet might not be able to pull all the list of Slack channels from your workspace.

If you do not find the name of the Slack channel you are looking to configure in the list, you can directly type the name of your Slack channel and hit the Enter button or the Add channel: #<your-slack-channel-name> to configure your Slack channel.

If you created a Slack channel after opening Sifflet Alert Destinations page, the name of your channel might also not show up on the list of channels. You can then either add your channel manually as explained above, or refresh the page to have your channel name populate the dropdown menu.

Private Channels

To configure a private Slack channel, you first need to add the Sifflet App to your private Slack channel. To do so:

• Head to your Slack workspace and to the channel of interest
• Click on your channel name at the top of the page to Get channel details

• Click the Integrations tab

• Under the Apps section, click the Add an App button

• Look for the Sifflet App using your search bar, and click the Add button

• You can then head back to the Alert Destinations page of your Sifflet application.
• To configure a channel, open the Slack channels dropdown menu, search for your Slack channel of interest, and click it.

• The selected channel appears below, in the Configured Slack channels list. This indicates your channel is properly configured.

Send Test Notifications

Once you have configured your Slack channel, you can hover its name and hit the paper airplane icon to send a test notification.

This can help you confirm whether or not Sifflet is able to properly send notifications to you configured Slack workspace and channel.

Use Channels in Monitors

Once you have configured your Slack channels, you can start using them in your monitors to receive notifications in case of data quality issues.

To do so, go to the Monitors page and click + New Monitor or open one of your existing monitors. In the Slack channels dropdown of the Notifications section, select the configured Slack channel of interest.

Delete Configured Channels

To delete a configured channel, hover the name of your channel, and click the red garbage icon.

Removing a configured channel will automatically remove it from all monitors it is currently attached to.

Delete Configured Workspace

To delete your configured workspace, click the red garbage icon next to your workspace name.

Removing a configured workspace will automatically remove configured channels from all monitors they are currently attached to.

Permissions

Bot Token Scopes

Troubleshooting

Sifflet could not successfully connect to your Slack workspace, Slack error: <SLACK_ERROR_MESSAGE>

This error shows up whenever Sifflet is unable to connect to the workspace you selected. The Slack API endpoints used under the hood are oauth.v2.access and auth.test, you can read more about their potential errors and root causes here and here.

We could not load all of your Slack channels. You can manually add channels by entering a channel name.

This error message shows up whenever Sifflet is unable to collect all the list of public channels of the workspace. This can notably happen when the number of channels of the workspace is too large as it causes Sifflet to be temporarily rate limited by the Slack API. The Slack API endpoint used under the hood is conversations.list, you can read more about its potential errors and root causes here.

Whenever this error occurs, you can always try to add your channel by manually entering its name and clicking the Add channel: #<your-channel-name> option.

Sifflet cannot reach your #<CHANNEL_NAME> channel. Double-check the spelling, confirm that the Sifflet Slack App was added to your channel if it is a private channel, and try again.

This error shows up whenever Sifflet is unable to reach the channel you selected. The Slack API endpoints used under the hood are chat.scheduleMessage and chat.deleteScheduledMessage, you can read more about their potential errors and root causes here and here.

Sifflet could not successfully send a test message to the #<CHANNEL_NAME> channel in the <WORKSPACE_NAME> Slack workspace, Slack error: <SLACK_ERROR_MESSAGE>

This error shows up whenever Sifflet is unable to send a test notification to the channel you selected. The Slack API endpoint used under the hood is chat.postMessage, you can read more about its potential errors and root causes here.