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.
This article covers:
Prerequisites for troubleshooting the Team Chat Migration app
- Pro, Business, Enterprise, or Education account
- Cloud storage and Set retention period for messages and files in Zoom's cloud enabled
Notes:
- The retention period for messages and files in Zoom’s cloud is the period starting from the message migration time.
- In the Team Chat admin settings, ensure that all file types that you want to be migrated are allowed. Any file that is not in this allow list will not be migrated.
- Admin access to the Slack Workspace from where the chat data needs to be migrated
Note: The Slack admin email must be the same as the Zoom admin email, and the admin must be signed in at the same time to connect their workspace to Zoom. - Admin permissions to the Slack account or organization to approve the use of apps within a Slack workspace
- Admin permissions to install the Team Chat migration app in your Zoom account
- All required users are created in the Zoom account
Note: Users will be matched using their email ID. Any active members in Slack that are not built in Zoom will be migrated as deactivated users in Zoom. Slack single-channel and multi-channel guest accounts will not migrate
How to troubleshoot the Team Chat Migration app
When your email shows an authorization error on a web browser:
- On the web browser, sign out of your Zoom account.
- Clear your browser cache.
- On the web browser, open a new incognito window.
- 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. - Click Authorize Email and follow the authentication flow.
After the migration job is completed, if you do not see messages in the Zoom client:
- Sign out of the Zoom client.
- 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: