Run a chat migration

Follow these steps to migrate your users' chat messages from Microsoft Teams to Google Chat using the new data migration service.

Step 1: Start a migration

You must be signed in as a super administrator for this task.

1. Sign in to your Google Admin console.

   Sign in using an account with super administrator privileges (does not end in @gmail.com).

2. In the Admin console, go to Menu  DataData import & exportData migration.
3. Click Start migration.

   The status changes to In progress and the following information is updated in real time:

   • Discovered tasks—Total number of tasks, such as creating a space or migrating chat messages
   • Warning—Number of items that were migrated but failed to complete as expected
   • Failed—Number of items that failed to migrate due to an error
   • Skipped—Number of items that were skipped
   • Successful—Number of items that were successfully migrated
   • Channels discovered—Number of channels that were migrated, skipped, or failed
   • Spaces created—Number of channels that were migrated to spaces
   • Spaces skipped—Number of spaces that were not created
   • Discovery issues—Number of items that were unable to be read from the source account
4. Click View report to download the reports in CSV format. Once the migration starts, you can download the report at any point.
5. If the Tasks list doesn't automatically open with the downloaded report, click Tasks .
6. For Your Tasks, click the link to open the report.
7. Click Download CSV to download the report.

Step 2: Run a delta migration

During a delta migration, chat migration copies any messages added to Teams since the primary migration. Messages that are already successfully migrated are skipped.

To start a delta migration, in your Google Admin console, click Run delta migration.

Step 3: Make spaces & messages available to users

After you complete the delta migration, make the migrated spaces and messages available to Google Workspace users. You must complete this process within 30 days of the start of the migration, or the migrated spaces are deleted.

1. In your Google Admin console, click Roll out spaces.

   In real time, you can review the number of spaces and messages that successfully migrated.

2. When the process is complete, click Download logs to view information about which spaces and members were successfully added to users' Google Workspace accounts.

Download the logs & exit a completed migration

Important: Once you exit a migration, you can no longer access the logs.

Until you exit a migration, you can review information about a completed migration in the Admin console. You can't start a new migration until you exit a completed migration.

To exit a completed migration:

1. Download the logs. 
2. Click Exit migrationExit and delete migration.