Screenshots - Microsoft Teams Migration Tool

Microsoft Teams Chat migration

With SharePoint migration software, you can migrate Teams Chat from one tenant to another. Here’s a step-by-step process that guides you on how to do it.

Here’s what the source and destination look like before migrating the chats.

Source Tenant

1:1 chat between two users at the source that we will migrate.

Group chat between multiple users sending texts and files appears like the image below.

Destination Teams is currently empty, and we’ll move our chats here and then see what it looks like after the migration.

Step 1: Launch Kernel Migration for SharePoint, go to the Source pane, and right-click Microsoft Teams. Now click on Add Teams to add your teams account to it.

Step 2: In the Add Teams wizard, provide a Project Name and enter the credentials based on the Authentication you choose from the two.

Step 2-A: Modern Authentication: Enter Tenant ID, Client ID, Client Secret Value, and User Name from the App Registration in Azure Active Directory

Step 2-B: For Basic Authentication (Recommended method), input a Global Admin User Id and its password.

Note: User should be a Global Administrator and possess a valid license of Microsoft 365 and Microsoft Teams to execute the data transfer.

Click Register and Connect.

Step 3: The Microsoft Teams account is added to the source. You can expand the Project Name and see the components of Teams account under the project name you created.

Step 4: Now go to the destination pane and right-click Microsoft Teams to add the destination account with the same process you followed to add source.

Step 5: Enter the Project Name and credentials as per the Authentication Type and then click Register and Connect to connect with the destination Teams account.

Step 5-A: Modern Authentication: Enter Tenant ID, Client ID, Client Secret Value, and User Name as available in the App Registration in Azure Active Directory and proceed as per the instructions on the screen.

Note: Please make sure that the selected user is a Global Administrator with a valid Microsoft 365 and Microsoft Teams license. We recommend creating a new user in the destination tenant for migration.

Step 5-A [I]: In the Sign in to your account window and copy the given URL.

Step 5-A [II]: Now, go to Private /Incognito window of your browser and paste the same URL in the search bar. If you’re not logged in to your Microsoft Office 365 account, it will first ask you to sign in.

Step 5-A [III]: Copy the new visual studio URL from the Incognito window.

Step 5-A [IV]: Paste the URL copied in previous step to Auth URL box and then click OK. This will connect the tool with the destination tenant.

Step 5-B: Basic Authentication: Provide a Global Admin User Id and then enter its password.

Step 6: This will add the Teams to the destination pane. You can expand and see all the Teams within the tenant by clicking on + icon preceding project name.

Step 7: Now we have two ways of moving chats from one tenant to other.

Step 7 [A]: Copy-Paste method

Step 7 [A-I]: Once both the source and destination are connected, click on the connected teams to expand its components and right-click on Chats. Now select Copy to copy chats (1:1 and group both) for the transfer.

Step 7 [A-II]: Once the data is copied from the source, go to the destination pane and right click on Chats and then select Paste to move the user chats (1:1 and group chats).

Step 7 [B]: Migrate method

Step 8: Click on the three dots (…) to map Source User with the Destination User to ensure the chats are migrated to the specific user accounts that you want. Ensure that you do not end up mapping wrong users else the chat will show under the name of other users that’s not intended to.

Note: Use the search box to find users with the User name or email. Items marked in red signifies that the users from the source are not present in the destination. While the green color shows that user are mapped successfully with the users at the destination. The tool also allows you to import CSV file for easy user mapping or you can even export the mapped source and destination users in the form of a CSV file for future use.

Step 9: If some users are left unmapped at the destination and you press Next to proceed, the tool will show a pop-up saying, “Some users are not mapped. Do you still want to process?” Select Yes or No and to proceed.

Step 10: Select users from the list whose chat you want to move to the users at the destination.

Step 11: Once you select users whose chats you want to move select from the available filters:

Step 11 [A-I]: Migrate chat attachments to Migration admin’s OneDrive or Migrate chat attachments to the selected destination user’s OneDrive account

Step 11 [A-II]: Exclude conversation of unmapped users

Step 11 [A-III]: Skip left chats

Once done, click Next.

Step 12: The process of migrating 1:1 and group chat has begun. You can check the status of the process in the below Progress window.

Note: You can click on Stop button to stop or abort the process.

Step 13: After the process completion, you’ll see a wizard with message, “Migration completed.” Click OK to end process.

Step 14: You can save the migration summary of process in CSV file format.

After the migration process is complete here’s how the sample destination Teams look like.

Step 15 [A-I]: After the migration process is complete here’s how the sample destination Teams look like.

Step 15 [A-II]: Here’s how the group chat on the destination end looks like after migrating the chats.