Slack

This document describes the Dataworkz connector configuration required to access Slack. It lists the steps needed to setup Slack connected app and to configure a connector for the same in Dataworkz.

There are 2 type of connected apps for Slack:

1. Private connected app :- App specific to an organization that can only fetch data from organization workspace(s) linked to app.

2. Distributed/Public connected app :- Multiple distributed workspaces can be registered with this app which can be of any organization.

Prerequisite (creating Distributed Slack App)

Before configuring Dataworkz for Slack, a "Distributed Connected App" needs to be configured in Slack. Following steps should be followed for the purpose.

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

2. Select “From Scratch” option. Enter app name and workspace to be used for connected app.

1. Click on “Create App” and on next page select “Add features and functionality”.

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

https://<Dataworkz application domain>/dataworkz-web/restApi/oauth/slack/get_oauth_token (Go to Dataworkz Slack configuration setup and get complete url)

1. Add following Bot token scopes for permission.

   1. channels:history

   2. channels:read

1. In the “OAuth Tokens for Workspace” section click “Install to Workspace”. Select the workspace and give the permission to access workspace and that will generate the Bot Token.

2. Select “Opt In” to allow token rotation for security reasons.

1. Connect and login to slack to manage and register app with channels. https://app.slack.com/apps-manage

1. Search using connected app name in Description.

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

1. Click on “Open in Slack“. It will redirect to slack app.

2. Select Connected app down arrow to register with channel.

1. Click on Add this app to channel and configured this app with required channel.

2. Login to Dataworkz web and enter client Id and secret for slack configuration in dataworkz. If OAuth option selected is “Dataworkz OAuth” then add slack configuration in OAUTH_CONFIGURATION table of Dataworkz DB.

1. Click on save and follow authentication process to complete configuration creation.

Creating Slack Connector in Dataworkz

1. Login to Dataworkz Application

2. Goto Configuration -> SaaS Applications -> Slack

3. Click the + icon to add a new configuration

1. Enter name for the connector

2. Select the OAuth option

OAuth

1. Select the Workspace & Collection to which the connector data belongs to

2. Upon saving you will be prompted to log into Slack. Upon successful login the configuration would be saved

Private Connected App

1. If custom app isn't already created selecting "No" would give the "Redirect URL" that can be used to create a connected app in Slack

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

3. Select the Workspace & Collection that would contain the resulting dataset

4. Upon saving you will be prompted to log into Slack. Upon successful login the configuration would be saved

Configuring Slack Connector Details

Goto Configuration -> SaaS Applications -> Slack

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

2. Click the Configuration tab. It will open Configuration tab. Click the + icon to add a new configuration

3. Enter name of the dataset that would comprise the Slack data

1. Select the channel from which messages need to be read

2. Choose between pulling all the historic data or for a date range

3. Toggle between one time and recurring pull

4. Click add to create the configuration