AvePoint Docs
Graph API
My support tickets
Graph API
My support tickets
English

    Home > Microsoft Teams Chat Migration Process > Preparation

    Export to PDF

    Preparation

    Before the migration, you need to identify what object types they want to migrate. See the .

    1. Create delegated app profile and app profile with required permissions

    To connect Fly to your Teams Chats, create an app profile with required permissions in AvePoint Online Services. Refer to the latest to check the required permissions for Microsoft Teams Chat Migration.

    2. Create users in destination tenant

    Add new Microsoft 365 users or synchronize users from the local Active Directory to Microsoft 365.

    - If your source domain will be moved to the destination environment: It is recommended that you use the user principal name with the default Microsoft 365 domain(**user@contoso.onmicrosoft.com**) in migration projects. Or you can use user principal names ending with an owned domain. After the domain name of your source tenant is changed to your destination tenant for go-live, if the final incremental migration is needed, use **Change** **mapping domain** in Fly to update the user principal names in projects in bulk. - If the source domain will not be moved to the destination environment, you can just use user principal names with different domains when configuring mappings in migration projects. - Refer to the .

    3. Assign licenses for users

    You need to assign Microsoft Teams and SharePoint Online licenses to the destination service account (or consent user of delegated app profile) before the migration.

    4. Prepare sensitivity labels in destination (optional)

    If the source tenant does not have sensitivity labels, you can ignore this step.

    If the source tenant has sensitivity labels, and you want to keep the source sensitivity labels applied on chat attachment files to the destination, you need to create and publish the sensitivity labels in the destination before the migration. Refer to for details.

    5. Configure a placeholder account in the destination tenant

    Source chats will be converted to group chats due to API limitations. A placeholder account is required to create a group chat and must meet the following criteria:

    - The account must be an active user in the destination tenant, which does not need any licenses or admin roles. - The account cannot be the same as the destination service account (or consent user of destination delegated app profile) or a destination chat user in the migration.

    6. Check destination retention policies

    If retention policies are configured for the source data, check to make sure the destination retention policies are the same as the source retention policies. Otherwise, the destination data may be deleted due to different retention policies.

    7. Create source and destination connections

    Refer to to connect Fly to your source and destination Teams chats.

    Pay attention to the following information:

    - If you only use the delegated app profile or service account in the destination connection and remove the consent user or service account from destination chats after the migration, the consent user or service account cannot be re-added to those chats in the next incremental migration job. Therefore, source newly added or edited messages cannot be migrated into those destination chats. - If you only use the delegated app profile or service account in the destination connection and change the consent user or service account after the migration, the new consent user or service account cannot be added to those already migrated chats in the next incremental migration job since the new consent user or service account has no permission to those chats. Therefore, source newly added or edited messages cannot be migrated into those destination chats.

    Based on the situations above, we recommend you also provide an app profile in the destination connection. Fly can add the service account to those destination chats and migrate source newly added or edited messages to those destination chats.

    - If you only use the delegated app profile or service account in the destination connection, the consent user or service account will be shown as the creator of destination chats. If you also use an app profile in the destination connection, the app name will be shown as the creator of destination chats.

    8. Migration throughput

    Generally, the average migration rate of chat messages ranges from 1000/hour/mapping to 4000/hour/mapping, depending on your tenant's performance. The number of mappings that run in parallel is automatically allocated based on your purchased subscription. The more subscriptions you purchase, the more mappings you can run in parallel.

    9. Project setup

    Generally, we recommend you keep using the source chats during the migration process until you migrate all data to the destination.

    10. Prepare the user mapping file

    Refer to to prepare a user mapping file.

    Make sure the user mappings of source and destination chat users are correct. This can ensure that your desired destination chat users can view the migrated chat messages of source chat users and continue chatting in the destination.

    11. Design the migration policy

    A Microsoft Teams Chat migration policy allows you to define the migration scope of Teams chats, whether to migrate chat file attachments, the conflict resolution for chat file attachments, how to map chat users, and how to manage the sensitivity labels of chat file attachments for Microsoft Teams Chat migrations. Refer to for details.

    12. Understand when users will receive notifications

    Source or destination users may receive notification in the following situations.

    - The chat messages will be marked as unread after being migrated to the destination. If the destination chat users have configured their **Chat message notifications** setting as **Show in banner**, they will receive notifications about the messages while using the Teams app. - If a user is mentioned in a message in the source chat, the destination user of the mentioned user will receive a notification during the migration. - If a message is marked as Urgent in the source chat, notifications will be sent repeatedly to the migrated chat in the destination until the chat is read. - The owners of destination OneDrive sites will receive notifications: - Shared links of the **Anyone with the link** type are migrated to the destination. - Shared links of the **People in [tenant] with the link** or **People** **you choose** type that are shared with external users are migrated to the destination.

    13. Plan a pilot run

    We recommend you do a pilot run for the following purposes:

    - Get familiar with the Fly interface and understand the whole migration process. - Discover any potential issues early and resolve them before production migration. - Understand the throttling situation in case content size is large, and then try to resolve with source and destination.