Slack Setup Guide

Prerequisites

You need access to an active Slack account.

Authentication options

Slack ETL supports two authentication modes:

• Sign in with Slack (default): use Matia's managed Slack OAuth app. This is the simplest option, but all customers using this mode share Matia's app-level rate limit.
• Private OAuth App: use your own Slack app's Client ID and Client Secret. Recommended if you need a dedicated rate-limit budget or have a strict app-approval process.

Setup Guide — Sign in with Slack (default)

1. Click Sign in With Slack to allow us to access your Slack account using OAuth. You will be redirected to Slack login page.
2. Log in to your Slack account. Matia will take it from here and sync your data from your Slack account.
3. You must add the Matia Slack app to all the channels with the data that you'd want to sync.

   Add Matia Slack App to a channel

   1. Select a channel from the channels list and right click it.
   2. You should see 4 tabs (About, Members, Integrations, Settings), click on the integrations tab.
   3. Click add Apps.
   4. You should see the Matia app below, click Add.
   5. Do the same for other channels if needed.
4. Click Test connection to make sure a connection has been correctly established between Matia to Slack.

Setup Guide — Private OAuth App

Use this mode if you want the Slack connection to use your own Slack app (and your own rate-limit budget).

1. Create a Slack app

1. Go to api.slack.com/apps and click Create New App → From scratch.
2. Give it a name (e.g. "Matia Sync") and pick the workspace you want to sync from.

2. Configure the redirect URL

1. In your app's settings, open OAuth & Permissions.
2. Under Redirect URLs, add Matia's callback URL: https://oauth.matia.io/integrations/slack/callback
3. Save the URL.

3. Add the required scopes

Under OAuth & Permissions → Scopes → User Token Scopes, add the following scopes:

• users:read
• users:read.email
• users.profile:read
• usergroups:read
• channels:read
• channels:history
• groups:read
• groups:history
• im:read
• im:history
• pins:read
• reactions:read
• reminders:read
• remote_files:read
• files:read
• dnd:read
• emoji:read
• team.billing:read
• team.preferences:read

4. Copy your Client ID and Client Secret

1. Open the Basic Information tab of your Slack app.
2. Under App Credentials, copy the Client ID and Client Secret.

5. Connect in Matia

1. In the Slack source form, choose Private OAuth App as the authentication method.
2. Paste the Client ID and Client Secret from step 4.
3. Click Authorize Private App. You'll be redirected to Slack to approve the connection.
4. After approval, add the Slack app to every channel you want to sync (see "Add Matia Slack App to a channel" above — substitute your own app for "Matia").
5. Click Test connection to confirm the connection works.

Supported Streams

• Message