Migrate Slack Workspace to Microsoft Teams

based on the great Channel Surf util

Moving to Microsoft Teams from Slack or starting fresh? You've come to the right place. Here's what this tool can do for you:

• Migrate Slack workspace channels structure in Teams
• Migrate team and channel members
• Migrate all messages including:
  • Thread hierarchy
  • File attachments
• Migrate users

Slack Archive

You can create a Slack Team export on a self-service basis as a Slack Team Owner or Admin at this page https://my.slack.com/services/export. Download the export file and tell Channel Surf its location. We'll scan it and re-create the Slack channel structure in Teams - and give you the option to do more.

Setup a development environment

• Clone this GitHub repository.
• Install Visual Studio 2019. Don't have it? Download the free Visual Studio Community Edition
• Don't want to use Visual Studio? Project was written using .NET Core and runs on Windows, macOS, and Linux. Instead of using Visual Studio, you can simply download the SDK necessary to build and run this application.
  • https://www.microsoft.com/net/download/core

Identify a test user account

• Sign in to your Office 365 environment as an administrator at https://portal.office.com/admin/default.aspx
• Ensure you have enabled Microsoft Teams for your organization https://portal.office.com/adminportal/home#/Settings/ServicesAndAddIns
• Identify a user whose account you'd like to use
  • Alternatively, you can choose to use your Office 365 administrator account

Azure App registrations

You must register this application in the Azure Active Directory tenant associated with your Office 365 organization.

• Sign in to your Azure Management Portal at https://portal.azure.com
  • Or, from the Office 365 Admin center select "Azure AD"
• Within the Azure Portal, select Azure Active Directory -> App registrations -> New application registration
  • Name: TeamsMigrationCli (anything will work - we suggest you keep this value)
  • Application type: Native
  • Redirect URI: https://migrator-cli (anything else will work if you want to change it)
  • NOTE: In earlier versions of this code, we hard-coded this value in Program.cs. It's now been moved to appsettings.json and we've agained defaulted it to https://migrator-cli
  • Click Create
• Once Azure has created your app, copy your Application Id and give your application access to the required Microsoft Graph API permissions.

  • Click your app's name (i.e. TeamsMigrationCli) from the list of applications

  • Copy the Application Id

  • All settings -> Required permissions

    • Click Add
    • Select an API -> Microsoft Graph -> Select (button)
    • Select permissions:

    API / Permissions name	Type	Description
    Channel.Create	Application	Create channels
    Channel.ReadBasic.All	Application	Read the names and descriptions of all channels
    ChannelMember.ReadWrite.All	Application	Add and remove members from all channels
    ChannelMessage.Read.All	Application	Read all channel messages
    ChatMessage.Read.All	Application	Read all chat messages
    Group.Create	Application	Create groups
    Group.ReadWrite.All	Application	Read and write all groups
    GroupMember.ReadWrite.All	Delegated	Read and write group memberships
    GroupMember.ReadWrite.All	Application	Read and write all group memberships
    profile	Delegated	View users' basic profile
    Team.Create	Application	Create teams
    Team.ReadBasic.All	Delegated	Read the names and descriptions of teams
    TeamMember.ReadWrite.All	Delegated	Add and remove members from teams
    TeamMember.ReadWrite.All	Application	Add and remove members from all teams
    Teamwork.Migrate.All	Application	Create chat and channel messages with anyone's identity and with any timestamp
    User.Read	Delegated	Sign in and read user profile
    User.ReadWrite.All	Application	Read and write all users' full profiles

  • If you plan to run Channel Surf as a non-administrator: applications built using the Graph API permissions above require administrative consent before non-administrative users can sign in - which fortunately, you'll only need to do once.

    • You can immediately provide consent to all users in your organization using the Azure Portal. Click the "Grant permissions" button, which you can reach via your app's "Required permissions" link.
      • Here's the full path to "Grant permissions": Azure Active Directory -> App registrations -> Your app (i.e. ChannelSurfCli) -> All settings -> Required permissions -> Grant permissions
    • Or, whenever you successfully launch ChannelSurfCli, we'll show you a URL that an administrative user can visit to provide consent.
      • Note: if you've configured the re-direct URL to be the same value as we've shown you on this page (i.e. https://channelsurf-cli), you'll be sent to an invalid page after successfully signing in. Don't worry!
• Take note of your tenant name, which is typically in the form of your-domain.onmicrosoft.com. You'll need to supply this when building or running ChannelSurfCli.

Usage

• n/name [string] (required) - Team name
• m/messages [boolean] - Migrate channel messages
• f/files [boolean] - Migrate channel files
• e/export [string] (required) - Export file path
• c/client [string] (required) - Application (client) ID
• t/tenant [string] (required) - Directory (tenant) ID
• r/redirect [string] (required) - Redirect URI
• a/authority [string] - Authentication authority URL. Default 'https://login.microsoftonline.com/{0}'
• d/domain [string] (required) - Users domain
• s/secret [string] (required) - Client Secret token
• r/readonly [boolean] - Readonly mode
• v/verbose [boolean] - Verbose

For example:

TeamsMigrate.exe -v -e myworkspace.zip -d myworkspace.onmicrosoft.com -c <client id> -t <tenant> -r 'https://migrator-cli'

Questions and comments

We'd love to get your feedback about this sample. You can send your questions and suggestions to us in the Issues section of this repository.

Questions about Microsoft Graph development in general should be posted to Stack Overflow. Make sure that your questions or comments are tagged with [microsoftgraph].

Additional resources

• Import third-party platform messages to Teams using Microsoft Graph
• Use the Microsoft Graph API to work with Microsoft Teams
• Microsoft Graph Beta Endpoint Reference
• Microsoft Graph API Explorer
• Overview - Microsoft Graph
• Microsoft Teams - Dev Center
• Channel Surf

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.