Documentation

Description

Slack is a platform that provides an API for programmatically interacting with workspace data, enabling the automation of messages and integration with other tools.

Follow our setup guide to connect Slack to Improvado.

Step 1. Ensure you have permission to install apps in your workspace.

Step 2. Click the Make a new connection button on the Connections page and select Slack in the Data sources catalog.

Step 3. Choose authorization option:

{%docs-accordion title="OAuth (recommended)"%}

Step 3.1. Authorize your Slack account via OAuth. Before authorization, please ensure you are signed in to the account from which you want to extract data.

{%docs-informer info%}

• Improvado uses token rotation for authentication. Learn more in the official Slack guide.
• Use an Incognito window to ensure you authorize the correct Slack account.

{%docs-informer-end%}

Step 3.2. Add the Improvado app to every Slack channel you want to sync:

• Open the channel → Integrations → Add an app → select the Improvado app.
• Repeat for each channel you need.

{%docs-informer info%}

Slack only lets an app read data from channels it’s in, so adding the app per-channel is required for data capture.

{%docs-informer-end%}

{%docs-accordion-end%}

{%docs-accordion title="API Token"%}

Step 3.1. Go to api.slack.com/apps and create an app in the workspace you want to connect.

Step 3.2. Open OAuth & Permissions and add the Bot Token Scopes you need:

• chat:write — send messages to channels the app is a member of (add chat:write.public to post to public channels without joining).
• users:read, channels:read — add these only if you also need to extract workspace data.

Step 3.3. Install the app to your workspace and copy the Bot User OAuth Token (it starts with xoxb-).

Step 3.4. Invite the bot to any private or target channels it should post to or read from (type /invite @your-app in the channel).

Step 3.5. Paste the token into the Bot User OAuth Token field.

{%docs-informer info%}

Use this method to connect with a token from your own Slack app — no Improvado app approval is required.

{%docs-informer-end%}

{%docs-accordion-end%}

‍

Step 4. After completing the connection process, the Slack connection will appear in your Connected sources list.

Step 5. When the connection status is Active, and the account status column shows a number of accounts, you can move on to data extraction.

Step 6. To extract data from the connected sources, check the instructions on how to set up data extraction.

{%docs-informer info title="Need help?"%}

• Install blocked? Ask a workspace owner/admin to approve the app.
• Don’t see data from a channel? Make sure the app was added to that specific channel.

{%docs-informer-end%}