Slack

Polytomic connects to Slack using a Bot User OAuth Access Token. This requires first creating a Slack app

1. Go to the Slack App site.

2. Click Create an App.

3. Give the app a name (for example: Polytomic) and select the workspace you want to sync data from.

4. Click Create App.

5. Add the following OAuth Scopes to the list of Bot Token Scopes:

• channels:history
• channels:join
• channels:read
• files:read
• groups:read
• groups:history (required if you want to sync messages from private channels)
• links:read
• reactions:read
• remote_files:read
• remote_files:write
• team:read
• usergroups:read
• users.profile:read
• users:read
• users:read.email

6. Install the app to your workspace.

7. After successfully installing the app to your workspace, copy the *Bot User OAuth Access Token presented to you.

8. In Polytomic, go to Connections → Add Connection → Slack.

9. Paste the Bot User OAuth Access Token from Step 7 in the Bot API key field.

10. Click Save.

Ingesting Slack messages

Using Polytomic's Bulk Syncs, you can write Slack messages and threads from your Slack workspace to your data warehouses, databases, and cloud storage buckets.

In order to make messages visible to Polytomic's sync engine, you need to add the Polytomic Slack app you created above to the channels you want to sync messages from. You can do this for each channel with the following steps:

1. Click on the channel name in Slack:

2. Click on the Integrations tab then click on Add an App:

3. Find the Polytomic app in your Slack workspace then click Add:

4. The Messages and Threads tables in your bulk sync config will now yield data when synced to your data warehouses, databases, and cloud storage buckets:

Limiting messages history

When pulling from Slack messages, you may not want to pull from the beginning of time as that may be too many messages. If you'd like to restrict Polytomic to only pulling messages and threads created after a certain time, you can set object-specific cutoff dates in your Polytomic Bulk Sync config:

Ingesting Slack events

If you want to ingest Slack's real-time events using Polytomic's Bulk Syncs, you'll need to perform additional configuration in the Slack app you set up above after the Polytomic Slack connection is saved.

1. Turn on the Enable Events switch in the Event Subscriptions section of your Slack app config:

2. Copy the Event Subscription Request URL from your saved Polytomic Slack connection and paste it in the Request URL field above. You can also use your own URL as long as you implement a 301HTTP redirect to your Polytomic Slack connection's event subscription request URL.
3. Click Add Bot User Event to specify the list of Slack events that Polytomic should ingest.
4. Once you've saved your new Slack application config, you'll be able to add the collection Events to your Polytomic bulk sync config. You'll then receive all Slack events you added in Step 3.