Troubleshooting the Team Chat Migration app

If you are experiencing an email authorization error when using the Team Chat Migration app, follow the user authorization steps below.

Learn more about using the Team Chat Migration app, getting started with the Zoom Team Chat Migration app, and Zoom Team Chat Migration app mapping.

Requirements for troubleshooting the Team Chat Migration app

Table of Contents

How to troubleshoot the Team Chat Migration app

When your email shows an authorization error on a web browser:

  1. On the web browser, sign out of your Zoom account.
  2. Clear your browser cache.
  3. On the web browser, open a new incognito window.
  4. Sign in to your Zoom account that contains the same email as your Slack account.
    Note: Ensure that you are signed out of all other Zoom accounts.
  5. Click Authorize Email and follow the authentication flow.

After the migration job is completed, if you do not see messages in the Zoom client:

  1. Sign out of the Zoom client.
  2. Sign back in to the Zoom client.
    All the migrated messages will appear.

A job’s status is “Error” and you see this message: We have identified that for {x} user(s), authorization to Slack has become invalidated. If you would like these user(s) to re-authorize, please click the "Remind Again" link above to send out a new authorization email to all unauthorized users, so that these users can have all of their private data migrated.

This is not a critical error. It is caused by some user(s) in your Slack account losing their authorization status and the ability of the app to migrate their private data. This can happen if their user role is changed, the user is deleted or deactivated, their email or account is changed, or any other account changes for them. By inspecting the Unauthorized Users list provided for the job, you can check which users need to authorize their data via email and decide if you need to resend the email or continue the job without those users’ authorization.

Note: Clicking Retry on the job will eliminate this error.

Additional resources

Learn more about the Zoom Team Chat Migration app by viewing the following articles:

warning icon
Due to changes in Slack’s API rate-limiting policies, API-based migration jobs are restricted to migrating only 15 messages per minute. This will significantly slow down the migration process when using an online workspace connection.
To avoid these delays, we recommend using our Import Tool, which lets you upload an exported Slack chat history file and does not rely on Slack APIs. If you must use the API method, consider contacting Slack support to request a rate limit exception for our migration app. Learn more about Slack’s API rate limits.