Skip to main content Skip to complementary content

Slack 

Slack is a cloud-based team communication platform.

Slack integration replicates data from a single Slack workspace using the Slack Web API. To replicate data from multiple workspaces, create an additional Slack integration for each workspace.

See the Schema section for a list of objects available for replication.

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

Information noteMake sure that the account you use has read access to the tables you want to fetch.

Qlik Talend Cloud supports data replication from one Slack workspace per connection. To replicate data from multiple workspaces, set up a separate Slack connection for each workspace in Qlik Talend Cloud, using a unique OAuth token for every connection.

To retrieve your token:

  1. Navigate to the Slack App site.
  2. Click Create an App.
  3. Enter a name for the app and select the workspace you want to replicate data from.
  4. Click Create App.
  5. Once your app is created, select it and navigate to Features > OAuth & Permissions.
  6. Scroll to the Scopes section.
  7. In the Bot Token Scopes section, click Add an OAuth Scope.
  8. In the field that appears, search for the following scopes:
    • channels:history
    • channels:join
    • channels:read
    • files:read
    • groups:read
    • links:read
    • reactions:read
    • remote_files:read
    • remote_files:write
    • team:read
    • useergroups:read
    • users.profile:read
    • users:read
    • users:read.email

    After the required scopes are added to the app, you need to install it to your Slack workspace. If you do not have the required permissions to install apps, you may need Workspace Owner approval. See Slack's documentation for app installation requirements.

  9. Scroll up to the OAuth Tokens & Redirect URLs section of the OAuth & Permissions page.
  10. In this section, click Install App to Workspace.
  11. Complete the steps that follow to install the app or submit a request to your Workspace Owner for approval.

    Result: Once the app is installed in your workspace, a Tokens for Your Workspace section containing a Bot User OAuth Access Token field is displayed.

  12. Copy and paste your token into a secured file.

Creating the connection

For more information, see Connecting to SaaS applications.

  1. Fill in the required connection properties.
  2. Provide a name for the connection in Connection name.

  3. Select Open connection metadata to define metadata for the connection when it has been created.

  4. Click Create.

Connection settings
SettingDescription
Data gateway

Select a Data Movement gateway if required by your use case.

Information note

This field is not available with the Qlik Talend Cloud Starter subscription, as it does not support Data Movement gateway. If you have another subscription tier and do not want to use Data Movement gateway, select None.

For information on the benefits of Data Movement gateway and use cases that require it, see Qlik Data Gateway - Data Movement.

Start DateEnter the date, in the format MM/DD/YYYY, from which the data must be replicated from your source to your target.
TokenToken.
Join Public ChannelsSelect the check box to replicate data for all public channels in the workspace you are connecting.
Include Private ChannelsSelect the check box to include data from private channels.
Exclude Archived ChannelsSelect the check box to exclude data from archived channels.

Schema

Information note

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 1.

Depending on your destination, table and column names may not appear as they are outlined below.

channel_members

The channel_members table contain info about members of channels in your Slack workspace. Channels include conversations, channels, and direct messages in your Slack workspace.

Replication Method

Full Table

Primary Keys

channel_id

user_id

Useful links

Slack documentation

Slack API method

channels

The channels table contains info about the channels in your Slack workspace. This includes conversations, channels, and direct messages.

Information noteSome types of channels - for example, private or archived channels - will be replicated only if the appropriate settings are configured in the integration’s settings. Refer to the Slack setup steps for more info.

Replication Method

Full Table

Primary Key

id

Useful links

Slack documentation

Slack API method

files

The files table contains info about Slack team files.

Replication Method

CDC

Primary Key

id

Replication Key

updated

Useful links

Slack documentation

Slack API method

messages

The messages table contains the history of messages and events in conversations in your Slack workspace.

Replication Method

CDC

Primary Keys

channel_id

ts

Replication Key

ts

Useful links

Slack documentation

Slack API method

remote_files

The remote_files table contains info about remote files added to Slack.

Replication Method

CDC

Primary Key

id

Replication Key

updated

Useful links

Slack API method

teams

The teams table contains info about teams in your Slack workspace.

Replication Method

Full Table

Useful links

Slack API method

threads

The threads table contains info about conversation threads in your Slack team.

Information noteWhile this table uses Full Table, it’s not truly replicated in full during each replication job. Each time a message in a thread is updated, the entire thread and all the messages it contains will be replicated in full. This means that while only updated threads are replicated, they are replicated in full whenever they’re updated.

Replication Method

Full Table

Primary Keys

channel_id

thread_ts

Useful links

Slack documentation

Slack API method

user_groups

The user_groups table contains info about user groups from your Slack team.

Replication Method

Full Table

Primary Key

id

Useful links

Slack API method

users

The users table lists contains info about the users in your Slack team. This includes deactivated and deleted users.

Replication Method

CDC

Primary Key

id

Replication Key

updated

Useful links

Slack API method

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!