Slack

Overview

Sifflet integration for Slack 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 & Privacy Policy

Bot Token Scopes

Privacy Policy

You can learn more about Sifflet privacy policy here.

Troubleshooting

I cannot find the Sifflet App when I try to add it to my channel

Because the Sifflet App is not yet listed on the Slack App Directory (our App is currently being reviewed by the Slack App Directory team), you will only find it when browsing available apps on your Slack application (desktop, browser, or mobile) if it was previously added to your workspace.

If the Sifflet App was not yet added to your Slack workspace, make sure to first set up the Slack integration from the Sifflet web application. This will add the Sifflet App to your workspace and allow you to then add it to all your Slack channels.

I cannot add the Sifflet App to my Slack workspace

By default, any member of a Slack workspace can install an app. However, your organization might have turned on app approval in which case you might need admin approval to install new apps to your workspace. You can read more about this on Slack documentation.

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.