GOOGLE CHAT TO TEAMS MIGRATION GUIDE

1. Google Chat To Teams Migration : Introduction

2. What's Migrated

3. Google Chat to Teams Migration Prerequisites

Google feeds need to be granted. Administrator credentials are required.

Migration uses a mix of Graph APIs and CSOM calls, which require specific permissions to execute. An Entra ID application needs to be installed, and global tenant admin credentials are required for this task.

The migration will occur under the identity of a specific account.
We recommend creating an account dedicated to the migration. You can then delete this account once the migration is completed.

  • The migration account needs an Microsoft 365 Teams License.
  • It must be a SharePoint administrator.
  • It must not be configured with multi-factored authentication (MFA) or SSO (ADFS).

2 kind of licenses are required for the Google Chat to Teams Migration:

  • Licenses for migrating the Spaces
  • User licenses (Cal) for migrating the Google Chats.

Please reachout Cloudiway Sales to request for pricing and quote.

4. Google Chat To Teams Migration Process

  1. Create the source and target  connectors.

  2. Discover the Spaces and users or upload your list from a CSV file.

  3. Configure the target location and Target Connectors

  4. Fill the Mapping Table.

  5. Optionally run an Audit to count the number of messags in each Space.

  6. Run the Pre-Processing task to create the target teams and migrate the permissions.

  7. Run the Google Chat to Teams migration.

  8. Close the Team

To facilitate the Slack to Teams migration, the Cloudiway platform needs to be able to communicate with both your source and target domains. To do this, Cloudiway uses connectors. You will need to set up a connector for each source tenant and each target tenant.

Google connector

To configure your Google connector, proceed with the steps in the following article : Google Workspace connector configuration.

Microsoft 365 connector

Follow this Microsoft 365 connector configuration guide to create the Microsoft 365 connector. 

For very large projects, you can create multiple connectors to run more migrations in parallal.
 

There are three ways to retrieve or upload your Google Spaces: Run a Get List, upload a CSV, or manually create a single channel.
We recommand to run the Get List task as it will automatically fill your migration list.

How does the GetList Work?

The discovert task retrieves the list of all the users of your tenant (for all the domains defined in the Google Source connector).

For each user, it then discovers its Google spaces and store them in the list.

 

Procedure

Select the Group List tab under the Sites product.

Group List

Under MIGRATION , click on the Get List option:

CloudiwayGetLists

In the popup window, select your source connector and the type of elements that you wish to retrieve (in our case it is Google Spaces) , then click on Get to start the process.

Once the list is retrieved, you need to define the target locations for each entry.

The second way to edit the slack migration list is to upload a CSV file.

Check this article for generating the CSV file correctly: https://help.cloudiway.com/article/how-to-fill-the-users-groups-csv-file/

Click MANAGE > Import. Select the CSV File, the Source, and Target Connectors, then click Upload.

Cloud Importcsv

 After uploading a CSV file, there is no need to define the source and target location.

Import CSV

You can also manage and create your list manually.

Click the MANAGE tab, and from the drop-down list click Create, then fill all the required fields.

you have the choice to select where to migrate your Space: 

  1. Into a team (General channel of the team).

  2. Into a specific channel.

  3. Into a private channel.

If you want to migrate into a specific channel, set the name of the team in the Target Name field, and the name of the channel in the Target Channel Name field. 

If you leave these fields blank, the Space will be migrated into the general channel of the team.

slack target channel name

If the team or the channel doesn’t exist in the target, it will be created during the pre-processing task.

You have run a discovery and it has pulled all your Spaces. However the target location is not filled and you don’t want edit the list one by one.

You can run the 3 options from the menu (Add Prefix, Assign Target and Change Target Recipient) to mass modify your list.

Assign Target : It will automatically assign a target connector to the selected entries.

Add Prefix: It automatically rename and add a prefix to the selected entries (in Target Group Name and Target Group Email Address).

Change Target Recipient: It automatically set the Recipient Type.

In the Group List, check one or more objects that you want to modify. Go to MANAGE, then run the action your choice:

prefix

 

Permissions and metadata may contain email addresses. During the migration, these addresses must be converted into target accounts.

The conversion is automatically done by the platform.

It uses the mapping table  to perform the conversion.

Cloudiway automatically populates the mapping table during the Discovery process.  Anyway it is your responsibility to check and validate the mapping table before starting the migration as entries may be missing or emails may be different at the target. This may happen if not all the users and groups are provisioned at the destination.

Read carefully:

Any error in the mapping table will corruptions and incomplete migrations (loss of metadata, loss of permissions). If you make an error, you cannot rerun the migration as the delta pass will only propagate changes and will not remigrate the permissions and metadata. If you make an error in your mapping table, you will have to erase everything and restart the migration with new licenses.

The audit is optional and purely informative.  

The audit connects to the source Space and counts the number of messages, replies and files.

To run the Audit, in Group List, select an entry and click MIGRATION > Audit.

slack audit

The pre-processing tool does 2 things.

  1. It connects to the Source Space and adds the migration account defined in the Google connector as owner of the space. This is mandatory by Google apis, else the migration account cannot access the space.
  2. It creates the team at the target if it doesn’t already exist:
    • It uses the graph APIs (Client ID and Client Secret) and gives the owner role to the migration account defined in the target connector.

    • It migrates membership and ownership.

To pre-process a Space, in the Group List, select an entry and click MIGRATION > Pre-Processing.

Note on Migration: The Google Chat to Teams migration tool is leveraging Microsoft Teams Import Apis to maximize throughput. This Microsoft article explains how it works.

In Group List, select an entry and click on MIGRATION, Start.

The migration will start as soon as there is a free spot on the platform. You can monitor your migration by clicking on an entry and checking the logs.

Google Chat To Teams Migration logs

When your migration is completed, run the Post Migration Task. 

This will close the Team that has been created in import mode.

Note 1: Private channels cannot be created in Import mode. Therefore, if you are migrating to a private channel, you don’t have to run the Post Migration Task

Note that once it is closed, the import api cannot be used anymore. It means that if you start a delta pass after you have closed the team, the delta pass will work but the meta data will not be injected anymore into the messages.

From the group user list, simply select a user and start the migration.

5. Troubleshooting