Integrate Tableau with a Slack workspace

Beginning with version 2021.3, Tableau Server and Tableau Online support integration with Slack, making Tableau notifications available to licensed Tableau users in their Slack workspace.

The Tableau for Slack integration lets you connect your Tableau site with a Slack workspace. Once it’s enabled, Tableau users can see notifications in Slack when teammates share content with them, when they're mentioned in a comment, or when data meets a specified threshold in a data-driven alert. If a site administrator in Tableau Online or a server administrator in Tableau Server enables notifications on a site, users can control which notifications they receive in Slack by configuring their Account Settings(Link opens in a new window). For more information, See Tableau notifications in Slack.

To integrate Slack with your Tableau site, there are a few necessary configuration steps, including some in your Tableau site and some in the Slack workspace you want to connect. This overview outlines these steps for both Tableau site administrators on Tableau Online or a Tableau Server Administrator on Tableau Server, and Slack workspace administrators.

Requirements

Enabling Tableau in Slack requires both a Slack workspace administrator and either a Tableau site administrator in Tableau Online or a Tableau server administrator in Tableau Server.

Connect a Tableau Server site to a Slack workspace

A Tableau Server administrator can connect a Slack workspace to one Tableau Server site. Connecting your Tableau site to a Slack workspace consists of three tasks:

  • Slack workspace administrator: Create a private Slack application on the Slack API platform
  • Tableau administrator: Use the app information to add an OAuth client
  • Tableau administrator: connect your Tableau site to Slack

For information about creating Slack apps, see Slack's Best practices and guidelines for Slack platform(Link opens in a new window).

Note: You are limited to one Slack workspace connection per Tableau site.

Step 1: Create a Tableau Slack app

Slack workspace administrator:

  1. Go to Slack's API documentation(Link opens in a new window) and select Create New App
  2. Select From Scratch, then add an app name and the workspace for the app to exist within. Select Create New App.
  3. Give your app a name and select a Slack workspace.
  4. You'll be taken to the app's basic information settings. From here, you can modify the app's privileges, description and more.
  5. Select Bots from the Add features and functionality section, then select Review Scopes to Add.
  6. Under Bot Token Scopes, add these scopes:
    • chat:write
    • files:write
    • users:read
    • users:read.email
  7. Select OAuth & Permissions from the navigation menu.
  8. Select Add New Redirect URL.
  9. Add a fully qualified URL https://<url>/auth/add_oauth_token
  10. Select Basic Information from the navigation menu.
  11. Give the Client ID, Client Secret and Redirect URL to the Tableau site administrator.
  12. Add the Tableau app into the Slack workspace by selecting Basic Information from the Settings menu, then Install.

Note: Administrators can share their app with other Slack workspaces by activating a distribution option. For more information, see Manage Distribution(Link opens in a new window) in Slack's documentation.

Step 2: Add an OAuth client to the Tableau site

Tableau site administrator:

The Tableau site administrator will add the OAuth client from the Slack workspace administrator, then connect the Tableau site to Slack.

  1. Sign in to the site you’d like to connect to Slack. On the Settings page of your site, select the Integrations tab.

    Integrations tab in Tableau site settings

  2. Under Slack Connectivity, select Add OAuth Client.
  3. Add the Client ID, Client Secret and Redirect URL from the Slack workspace administrator, then select Add OAuth Client in the dialog.
  4. The connection type and Client ID will appear in the table.

Step 3: Finalise the connection

When the OAuth client is added under Slack Connectivity:

  1. Select Connect to Slack.
  2. Follow the prompt to sign in to your Slack workspace.
  3. Select Allow to give your Tableau site access to the Slack workspace.

The Tableau site and Slack workspace are now connected. In the Slack workspace, licensed Tableau users can receive Slack notifications when someone shares Tableau content, when a data-driven alert is triggered or when someone is @mentioned in a comment on a view or workbook.

Disconnect a Tableau Server site from Slack

You can disconnect a Tableau site from a Slack workspace by selecting Disconnect from Slack in the Integrations tab of site settings. Users will continue to receive notifications for some time. The OAuth client information you added in Step 2 is retained and can be used to connect to a new workspace if needed.

Update your Tableau Slack application

When a new version of the Tableau Slack application is available, Tableau recommends reinstalling the application to maintain app performance and use new features.

To reinstall the Tableau for Slack app, select Disconnect from Slack in the Integrations tab of your site settings, then go through the connection steps in Integrate Tableau with a Slack workspace.

Thanks for your feedback!