Install and set up Microsoft Teams integration

By default, the Basic and Enhanced Microsoft Teams Integration is disabled for customer engagement apps in Dynamics 365 (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing, and Dynamics 365 Project Service Automation). To turn these features on, follow the steps below. To learn more about what the difference, see Difference between the Basic and Enhanced Collaboration Experience with Microsoft Teams.

Settings page

Note

  • If Microsoft Teams integration is not enabled on the System Settings page, then Microsoft Teams users can still connect to record or view in customer engagement apps (such as Dynamics 365 Sales and Dynamics 365 Customer Service) to Microsoft Teams collaboration channel, but the connected Microsoft Teams channel and the file library do not appear in customer engagement apps in Dynamics 365.
  • When the feature is enabled, the collaboration feature is enabled only for a selected set of system entities. If you want to enable Microsoft Teams integration for additional entities or custom entities, you can only do it programmatically using the msdyn_SetTeamsDocumentStatus Web API action. More information: Enable or disable Microsoft Teams Integration using code.
  • If you run into any issues during configuration, see Troubleshoot configuration issues with Teams Integration.

Prerequisites

Microsoft Teams integration uses SharePoint integration at the backend. Make sure these prerequisites are met:

  • If SharePoint integration is not configured, OneDrive integration must be disabled too. If this is not met, you will get error code 800503ca when you try to enable Teams Integration with customer engagement apps in Dynamics 365.

  • If SharePoint Integration is not configured, there should not be any active SharePoint site in your organization. Deactivated SharePoint sites should not cause a problem. If this is not met, you will get error code 800503ca when you try to enable Teams Integration with customer engagement apps in Dynamics 365.

  • If SharePoint Integration is not configured, there should not be any SharePoint document locations created with an absolute URL in your organization. The locations with absolute URL must be deleted. If this is not met, you will get error code 800503ca whne you try to enable Teams Integration with customer engagement apps in Dynamics 365

  • If you are currently configured to use SharePoint on-premises for document management, you need to set up document management for a customer engagement app to use SharePoint Online. For more information, see Set up apps in Dynamics 365 to use SharePoint Online.

  • If SharePoint Online admin has enabled control access from unmanaged devices (conditional access policy) to allow/block SharePoint sites from unmanaged devices, then the same restrictions will be applied for Microsoft Teams integration because Microsoft Teams uses SharePoint sites for document management. This might block a user when they try to access a connected team channel file library on a customer engagement app page. For more information, see Control access from unmanaged devices.

If you get an error while configuring Microsoft Teams Integration from Dynamics 365, it might be because of the above prerequisites are not met. For more infomation, see Troubleshoot Microsoft Teams integration.

For admins: enable Microsoft Teams integration feature

  1. Sign in as a system administrator to your customer engagement app in Dynamics 365
  2. Go to Settings > Administration > System Settings > General tab.
  3. To enable basic collaboration experience, select Yes for Enable Basic Microsoft Teams Integration. When Basic Microsoft Teams Integration is enabled, the Collaborate button appears on in customer engagement app records so you can see the connected team channel or set up a new connection in Microsoft Teams. In addition, in the Documents tab on the record page, the connected team channel file library will appear.

    Note

    You can only set Enable Enhanced Microsoft Teams Integration to, Yes if Enable Basic Microsoft Teams Integration is set to, Yes. If you don't enable Basic Microsoft Teams Integration then the option Enable Enhanced Microsoft Teams Integration is grayed out.

    Enhanced experience disabled

  1. To enable enhanced collaboration experience, select Yes for Enable Enhanced Microsoft Teams Integration. To turn this option on, you need Microsoft 365 tenant admin permissions. When Enhanced Microsoft Teams Integration is enabled, the Collaborate button appears on the record and view page in customer engagement apps. You can set up a connection with any Microsoft Teams collaboration channel within an app.

    1. When you select Yes to Enable Enhanced Microsoft Teams Integration, there is two consent permission popup boxes that will display. If you have a pop-up blocker and you don't see the second consent dialog, then you need to disable the pop-up blocker in your browser.

      Disable popup blocker

    2. On the second consent dialog box, select the checkbox for Consent on behalf of organization and then select Accept.

      Note

      If you don't select Consent on behalf of organization option, then when another user tries to pin an entity record or view to Microsoft Teams and shares the tab with another user, they will get this error message, The admin has not consented to use user sync feature, you can add them manually. If you see this error message, see Error when you pin a record or view to teams channel.

      Select consent checkbox

  2. After the second consent is accepted select, Finish and then select OK on the System Settings screen. If you don't select OK on the System Settings screen then you will lose your changes.

    Finish setup

In Microsoft Teams: Install the Dynamics 365 app and set up the Microsoft Teams collaboration channel tab

  1. In Microsoft Teams, select Store.

    Select Store

  2. Search for dynamics, and then select the Dynamics 365 tile.

    Search for and select Dynamics 365

  3. Verify that Add for you and Add to a team are both set to Yes.

    You can use Dynamics 365 app for your own use or use on a Microsoft Teams channel to collaborate with others. If you have an existing Microsoft Teams channel, select both options. Otherwise, you can start installing for your personal use and install the app for your Microsoft Teams later.

    Enable personal and team features

  4. For Add to a team, choose a team and then select Install.

    Add to team

  5. Pick a channel in Microsoft Teams to connect to an app record and then select Set up.

    Pick a channel and select Set up

  6. Select a version 9.x environment and a Unified Interface app to connect, and then choose Save.

    Select environment and app module

    Note

    • Only environments that contain customer engagement apps (such as Dynamics 365 Sales and Dynamics 365 Customer Service) appear in the list. Also, only active environments (those that are not disabled or provisioning) are displayed.
    • Only Unified Interface apps are listed.
    • Only app modules licensed for the selected environment are listed.
  7. Select Entity Selection or View Selection.

    1. Entity Selection: Select an entity to connect. You can pick a recently viewed record or use search to find records. You can use Filter by to narrow the search to an entity type. Once you've picked a record, select Save.

    Select an entity

    1. View Selection: Select an entity to see the list of available views. Once you've picked a view, select Save.

    Select a view

    Note

    If you select a personal view (My Views) instead of System Views, it’s recommended that you share the view with other users before you add the view to the Microsoft Teams channel. Otherwise, other team members will not have access to the view tab content.

  8. After completing the above steps, you will see a new Dynamics 365 tab in the selected team channel.

See Collaborate with Microsoft Teams for information on how you can use the tab feature to collaborate with Dynamics 365 apps.

In Microsoft Teams: Set up the personal dashboard

Set up the personal dashboard (My Dashboard) to interact with customer engagement apps in Dynamics 365 without involving other team members.

  1. Open the Dynamics 365 app.

    Open the Dynamics 365 app

  2. Select an environment and a Unified Interface app to connect with customer engagement apps in Dynamics 365, and then choose Save Changes.

    Select environment and app module

    Note

    • Only environments that have customer engagement apps (such as Dynamics 365 Sales and Dynamics 365 Customer Service) appear in the list. Also, only active environments (those that are not disabled or provisioning) are displayed.
    • Only Unified Interface apps are listed.
    • Only app modules licensed for the selected environments are listed.
  3. Select the My Dashboard tab.

See Use the personal dashboard for information on how you can use My Dashboard.

See also

Troubleshoot Microsoft Teams integration