slack-integration

Slack integration

Installing the Slack App for Datafold

You must be a Slack admin with permission to install apps for your workspace in order to complete this integration.

To install the Slack App, open Settings / Integrations, click New integration, select Slack, click Create.

After clicking Create, you will be forwarded to Slack's website for approval. If you have permission to add applications to your workspace, click Allow. Select the proper one in the upper right corner if you have access to multiple namespaces.

Once allowed, you will be redirected back to Datafold, and the new integration will be seen in the list. It can now be used in alerts.

Application approval

If your Slack workspace requires approval of applications, fill in the form and send the request for approval instead of the Allow button. Contact your Slack administrators for approval.

Once the approval is granted, you will receive a direct message in Slack from Slackbot. To install the application repeat the steps from the beginning — now, you will see the Allow button.

Reinstalling the Datafold Slack App

Optionally, an admin can reinstall the Slack App by opening the existing Slack App integration and clicking the Reinstall button. This will upgrade all the granted scopes (if they have changed), refresh the access credentials, reload the names, channels, groups, and users — as if the application is newly installed — except that it will remain the same integration with the existing subscriptions.

Note: If you created a Slack App integration before Feb'2022, to use Slack groups, you have to reinstall the integration — a new permission scope will be requested to scan the workspace groups. Otherwise, Slack groups will not be available. The rest will continue working as before.

Uninstalling the Datafold Slack App

To uninstall the application:

• Remove the Slack App subscriptions from all alerts.
• Remove the integration from Datafold ("Settings / Integrations").
• Remove the Slack App from your Slack workspace

Subscribing to alerts

Users can subscribe to alerts themselves or be subscribed by others. However, only those Slack users that are mapped to Datafold users can be subscribed. The mapping is performed by a fully matched email address. Unmapped users will not be present in the selection.

Besides, Slack groups or special Slack handles @here & @channel can be subscribed to alerts to notify everyone in that channel (or only those online at the moment).

The subscribed users are mentioned in the alert notifications when they trigger: