Slack Connector Configuration

Generate a Slack OAuth token for migration to Microsoft Teams or Google Chat.

Last updated: 2025-01-15 Plan & Prepare

Slack Migration Paths

💬
Slack
Source
👥
Microsoft Teams
💬
Google Chat

Overview

The Cloudiway platform requires a Slack OAuth token to access your workspace data for migration. This token enables the migration platform to read channels, messages, files, and user information from your Slack workspace.

Migration Targets

  • Microsoft Teams - Channels, messages, and files
  • Google Chat - Spaces and conversations

Step 1: Create Slack App

  1. 1

    Access Slack API Portal

    Visit api.slack.com/apps and sign in with your Slack account.

  2. 2

    Navigate to Your Apps

    Click on Your Apps in the upper right of the screen.

  3. 3

    Create New App

    Click Create New App, choose "From scratch", provide a name (e.g., "Cloudiway Migration"), and select your target workspace.

  4. 4

    Confirm Creation

    Click Create App to complete the app creation.

Step 2: Configure Required Permissions

Navigate to OAuth & Permissions in your app settings and add the following User Token Scopes:

Required Scopes (12 total)

Channel Access

  • • channels:history
  • • channels:read
  • • groups:history
  • • groups:read

Direct Messages

  • • im:history
  • • im:read
  • • mpim:history
  • • mpim:read

Files & Users

  • • files:read
  • • users:read
  • • users:read.email
  • • users.profile:read

Important: Add all scopes listed above and click Save Changes before proceeding to installation.

Step 3: Install App and Get Token

  1. 1

    Install to Workspace

    Click Install to Workspace at the top of the OAuth & Permissions page.

  2. 2

    Authorize

    Review the requested permissions and click Allow to authorize the app.

  3. 3

    Copy OAuth Token

    After installation, an OAuth Access Token is generated. Copy this token for use in Cloudiway.

Token Security

Keep your OAuth token secure. It provides access to your Slack workspace data. Do not share it publicly or commit it to version control.

Step 4: Configure Cloudiway Connector

  1. Log in to the Cloudiway platform
  2. Navigate to Connectors and click Add Connector
  3. Select Slack as the connector type
  4. Enter your connector name
  5. Paste the OAuth Access Token you copied from Slack
  6. Click Save to create the connector
  7. Test the connection to verify it works correctly

Success Indicators

  • Connection test passes
  • User list can be retrieved
  • Channel list is accessible

Was this article helpful?

We value your feedback

Help us improve your experience

What would you like to share with us?

Need direct support? Open a ticket