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 > Collaboration Tools
• 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 Collaboration Tools 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 Collaboration Tools 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

• At the very bottom of the modal, look for your Channel ID and click the icon to copy it

  

• Then click the Integrations tab

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

If you already have apps configured on your channel, look for aAdd apps link instead.

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

• You can then head back to the Collaboration Tools page of your Sifflet application.
• To configure a channel, open the Slack channels dropdown menu and paste the channel ID you previously copied. The channel id with (private channel) appended should show up as a menu entry. Click this entry.

• 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.

Public Channels

To use public channels in monitors, go to the Monitors page and click + New Monitor or open one of your existing monitors. If not done yet, turn on the Notify by Slack toggle in the Overview and notifications > Notification method section. Then, select the configured Slack channel of interest.

Private Channels

To use private channels in monitors:

• 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

• At the very bottom of the modal, look for your Channel ID and click the icon to copy it

• 

• Head back to the Sifflet application, to the Collaboration Tools page and make sure the copied channel ID shows up as a Configured Slack channels section of the Slack card.
• Go to the Monitors page and click + New Monitor or open one of your existing monitors. If not done yet, turn on the Notify by Slack toggle in the Overview and notifications > Notification method section. Then, paste the previously copied channel ID and select the corresponding configured Slack channel.

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 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.

I don't see the channel name I want to use in the list of channels in monitors

You first need to set up the integration and configure Slack channels before being able to use them in monitors.