Run a chat import

Follow these steps to import your users' chat messages from Microsoft Teams to Google Chat using the data import tool.

Steps to run an import

Avoid duplicate files

If you exit an import and then start a new import for the same data set, the second import might create duplicate files in Workspace. To prevent duplication, avoid creating 2 separate imports for the same data set.

Step 1: Start an import

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

  1. In the Google Admin console, go to Menu and then Data and then Data import & export and then Data import.

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

  2. Click Start import.

    This action grants domain-wide delegation and creates a client ID for Data Import in the target account. For more information, go to Control API access with domain-wide delegation.

  3. 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 importing chat messages
    • Warning—Number of items that were imported but failed to complete as expected
    • Failed—Number of items that failed to import due to an error
    • Skipped—Number of items that were skipped
    • Successful—Number of items that were successfully imported
    • Channels discovered—Number of channels that were imported, skipped, or failed
    • Spaces created—Number of channels that were imported 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
    When the import is complete, you get an email with import statistics. Any reports are attached.
  4. Click View report to download the reports in CSV format. Once the import 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 import

During a delta import, the data import tool copies any messages added to Teams since the primary import. Messages that are already successfully imported are skipped.

Note: You can't run a delta import after you click Roll out spaces.

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

Step 3: Make spaces & messages available to users

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

Important: Don't complete these steps if you still need to run a delta import. You can't run a delta import after you click Roll out spaces.

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

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

  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.

    Note: If any spaces fail to import, click Roll out spaces again to retry the process on all the spaces that failed to import.

Download the logs & exit a completed import

Important: Once you exit an import, you can no longer access the logs.

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

To exit a completed import:

  1. Download the logs.
  2. Click Exit import and then Exit and delete import.


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.