Slack

This document describes the Dataworkz connector configuration required to access Slack, including the steps to set up a Slack connected app and configure a connector in Dataworkz.

There are two types of connected apps for Slack:

1. Private connected app — App specific to an organization that can only fetch data from organization workspaces linked to the app.

2. Distributed/Public connected app — Multiple distributed workspaces from any organization can be registered with this app.

Prerequisite (Creating a Distributed Slack App)

Before configuring Dataworkz for Slack, create a Distributed Connected App in Slack. Follow the steps below.

1. Go to https://api.slack.com/apps and click Create new app.

2. Select From Scratch. Enter the app name and the workspace to use for the connected app.

1. Click Create App and on the next page, select Add features and functionality.

   
2. Enter the following redirect URL, click Add, and then save the URLs:

https://<Dataworkz application domain>/dataworkz-web/restApi/oauth/slack/get_oauth_token (get the complete URL from the Dataworkz Slack configuration setup)

1. Add the following Bot token scopes for permissions:

   1. channels:history

   2. channels:read

1. In the OAuth Tokens for Workspace section, click Install to Workspace. Select the workspace and grant permission to access it. This generates the Bot Token.

2. Select Opt In to allow token rotation for security.

1. Connect and log in to Slack to manage and register the app with channels: https://app.slack.com/apps-manage.

1. Search for the connected app name in the Description field.

1. Select the connected app and go to the App details tab on the next page.

1. Click Open in Slack. This redirects to the Slack app.

2. Click the connected app dropdown arrow to register with a channel.

1. Click Add this app to channel and configure the app with the required channel.

2. Log in to Dataworkz and enter the Client ID and Secret for the Slack configuration. If the Dataworkz OAuth option is selected, add the Slack configuration to the OAUTH_CONFIGURATION table in the Dataworkz database.

1. Click Save and follow the authentication process to complete the configuration.

Creating Slack Connector in Dataworkz

1. Log in to the Dataworkz application.

2. Go to Configuration > SaaS Applications > Slack.

3. Click the + icon to add a new configuration.

4. Enter a name for the connector.

5. Select the OAuth option.

OAuth

1. Select the Workspace and Collection for the connector data.

2. After saving, Dataworkz prompts you to log in to Slack. After a successful login, the configuration is saved.

Private Connected App

1. If the custom app is not yet created, select No to get the Redirect URL for creating a connected app in Slack.

2. Enter the Client ID and Secret configured during connected app creation.

3. Select the Workspace and Collection for the resulting dataset.

4. After saving, Dataworkz prompts you to log in to Slack. After a successful login, the configuration is saved.

Configuring Slack Connector Details

Go to Configuration > SaaS Applications > Slack.

1. Click the Slack connector created in the previous section.

2. Click the Configuration tab, then click the + icon to add a new configuration.

3. Enter a name for the dataset.

4. Select the channel from which to read messages.

5. Choose between pulling all historical data or a date range.

6. Toggle between one-time and recurring pull.

7. Click Add to create the configuration.