Troubleshoot Microsoft Teams integration with customer engagement apps in Dynamics 365

  • Article
  • 9 minutes to read

This topic provides information almost the error messages you might face with possible resolutions and some known issues.

Troubleshoot configuration issues with Microsoft Teams integration

Microsoft Teams integration uses SharePoint integration at the backend, so if at that place'due south a failure with SharePoint integration or OneDrive configuration, it will too fail when you enable Microsoft Teams integration.

If y'all get an fault while configuring Microsoft Teams Integration from Dynamics 365, it might be because of the following pre-requisites aren't met.

  • SharePoint Integration isn't configured, and OneDrive Integration is enabled. To Fix the event, disable OneDrive.

  • SharePoint Integration isn't configured, but there's an active SharePoint site in your organization. To prepare the issue, deactivate the SharePoint site.

  • SharePoint Integration isn't configured, but there'southward SharePoint document locations created with an accented URL in your system. To fix the issue, delete locations with an absolute URL.

  • If SharePoint Online admin has enabled control admission from unmanaged devices (conditional access policy) to let/block SharePoint sites from unmanaged devices, and so the aforementioned restrictions will be applied for Microsoft Teams integration because Microsoft Teams uses SharePoint sites for document management. This might cake a user when they endeavour to admission a connected squad channel file library on an app page. For more information, meet Control access from unmanaged devices.

  • If you get this error: You lot cannot enable Microsoft Teams integration since the surroundings is integrated with SharePoint on-premises, this means that yous're currently configured to apply SharePoint on-premises for document management. You lot need to set up certificate direction for customer engagement apps to use SharePoint Online. For more information, see Gear up apps to use SharePoint Online.

Error when you lot pivot a record or view of any app to a team aqueduct if the enhanced experience isn't configured correctly past your customer engagement apps admin.

Error: The admin has not consented to apply user sync characteristic, you tin add together them manually.

When you turn on enhanced Microsoft Teams Integration, there are ii dialog boxes that you need to accept. On the second dialog box, when you don't check the Consent on behalf of arrangement cheque box, then users will get this error when they endeavour to pin an entity record or view to Microsoft Teams and share the tab with some other user.

Error message, the admin has not consented to use user sync feature, you can add them manually.

To fix the issue, disable the Enhanced Microsoft Teams integration feature.

  1. Become to, https://portal.azure.com.
  2. Select Azure Active Directory > Enterprise.
  3. In the listing of apps go to, Dynamics 365 Microsoft Teams collaboration integration.
  4. Delete the app.

    Teams error.

  5. Expect for about 5 minutes and then enable the Enhanced Microsoft Teams Integration feature once again. This time brand sure that you to check the Consent on behalf of organization checkbox.

Error when yous pivot a tape or view of any app to a team channel if your user function permission is not configured correctly by your client engagement apps arrangement admin.

Mistake: User does not have permissions to create SharePoint Site or Certificate Location. This record is not connected to Dynamics 365.

This ways the user that is getting this fault doesn't have sufficient permissions such as Create, Read, Write, Append, AppendTo and Delete for the user role to pin an entity to a Microsoft Teams channel; all the same, changes fabricated to the tape in Microsoft Teams will update in customer engagement apps in Dynamics 365.

When the user tries to pin an entity to a Microsoft Teams channel, this error will display in the notification bar:

Microsoft Teams permission error.

To set the issue, do the post-obit:

  1. In Microsoft Teams, select the channel with this error.
  2. Select the tab with this error.
  3. Select the down arrow next to the tab, then select Remove.
  4. In your app, place the part which is assigned to this user:
    1. Sign in equally an admin to your customer engagement app.
    2. Navigate to Settings > Security > Users.
    3. Observe and select the user account that got the error message to open information technology.
    4. Select Manage Roles.
    5. Identify the security role assigned to this user.
    6. Select Shut.
  5. Navigate to Settings > Security > Security Roles.
  6. Open the security role identified higher up.
  7. Go to the Core Records tab.
  8. Give Create, Read, Write, Suspend, AppendTo and Delete permissions to SharePoint Site and Document Location.
  9. Select Salve and Close.

Now, when the user tries to pin the entity to the required Microsoft Teams channel, information technology should piece of work.

Troubleshoot errors in Microsoft Teams

Error: I tin can't find the Dynamics 365 app in the Microsoft Teams app shop.

This happens when the external app for Microsoft Teams service isn't enabled by your Microsoft 365 admin. To prepare the issue, do the following:

  1. Sign in to https://portal.function.com.

  2. From the list of apps, select Admin.

    Admin portal.

  3. From the menu select Settings > Services & add together-ins.

    Settings and add-ins.

  4. Discover Microsoft Teams then enable External Apps.

    Find Microsoft Teams.

  5. Set Allow external app in Microsoft Teams to On.

    Enable external apps.

  6. Restart Microsoft Teams and and so try searching for Dynamics 365 again in the Microsoft Teams app shop.

Fault: Pitiful, the environment you selected is not up-to-engagement or is not supported. Please select another environment.

Errow message, environment is not up-to-date.

Or, you may get this error:

Fault: Sorry! Your Dynamics 365 environment is non the latest version and is non supported for this feature. Delight select a different environment or contact your Dynamics 365 admin to exercise an update.

Error, sorry your Dynamics 365 environment is not the latest version and is not supported for this feature.

The customer engagement app environment that yous are trying to connect does not back up Microsoft Teams integration. You can expect for the environment to be updated or pick a different surround that has been updated to back up Microsoft Teams integration.

Fault: This tape is not connected to Dynamics 365. Repin the tab and try again.

This error is displayed in the following scenarios:

  • When the Dynamics 365 entity that you lot are trying to pivot is not enabled for SharePoint certificate management. For example, if you are trying to pin an appointment record in Teams but the Date entity is non enabled for SharePoint. In this instance, Enable SharePoint certificate management for that entity.

  • When the file synchronization is not fix up between Teams and customer engagement apps in Dynamics 365. In this case, Set upwardly apps in Dynamics 365 to employ SharePoint Online.

  • When the file synchronization has failed betwixt Teams and customer engagement apps in Dynamics 365. In this case, repin the Dynamics 365 tab.

    Important

    When you start create a new squad and channel in Microsoft Teams, you might see this fault because it takes some time for Microsoft Teams to provision a new SharePoint file library for the channel. Wait for a few minutes, so refresh your browser to retry the connexion.

    Annotation

    Though the connection fails, changes fabricated to the tape in Teams are updated in the customer engagement app.

To repin the Dynamics 365 tab

  1. In Microsoft Teams, select the channel with the error.

  2. Select the Dynamics 365 tab with the error.

  3. Select the down arrow next to the tab, and then select Remove.

    Remove a Dynamics 365 apps tab.

  4. On the aforementioned channel, select the Add together button (Add button.).

    Select Add button.

  5. Continue through the steps as in Interact with Microsoft Teams.

Mistake messages in customer engagement apps in Dynamics 365

Mistake: File sharing is not gear up. Go to [URL] to connect a Microsoft Teams aqueduct to this record.

File sharing is not set up.

This record has not been connected to a Microsoft Teams aqueduct. Select the URL to go to the Dynamics 365 Microsoft Teams app and pivot the tape to a channel every bit documented in Collaborate with Microsoft Teams.

Mistake: You don't have permissions to view files in this location. Contact your Microsoft Teams possessor or SharePoint administrator for access.

You don't have permissions to view files.

You need to exist a member of the connected team aqueduct to view files. Contact the owner of the connected team aqueduct, and request to be added as a fellow member. You need to determine the location of the certificate to which you lot need permission.

  1. In your app, open the record with the permissions error bulletin.

  2. Select Related > Documents.

    Select documents.

  3. Select Certificate Location. The beginning item in the list shows the squad for which you demand membership. Request access from the team aqueduct owner.

    Select document location.

Known issues

Embedded Power Apps canvas apps don't work

You tin can embed a canvas app in customer appointment apps (such as Dynamics 365 Sales and Dynamics 365 Customer Service) equally they have the same design and underlying architecture of a model-driven app. However, when you lot embed a customer engagement app in Microsoft Teams, the embedded canvas app won't work.

Authentication issue in Teams when yous have embedded apps within Dynamics 365

You may get an authentication failure when yous open a pinned Dynamics 365 tab in Teams desktop customer that has apps, such equally Ability BI, Ability Automate, LinkedIn Navigation widget, or KnowledgeBase Control enabled.

To piece of work around this issue, open Teams on the web and shut the desktop version.

Error while creating a team or aqueduct. The belongings is missing a required prefix/suffix per your organization's Group naming requirements.

A user may become this error when they try to connect a record or a view to a team channel using the Collaborate push in a customer date app in Dynamics 365. This happens if your tenant admin has configured group level naming policy from Azure portal with a prefix and suffix condition

Prefix error.

To piece of work around this issue, your tenant admin will need to remove this policy from Azure portal.

Error while creating a squad or channel. The displayName cannot contain the blocked give-and-take 'blocked' equally per company policy.

A user may get this error when they attempt to connect a record or a view to a team channel using the Collaborate button in a client engagement app in Dynamics 365. This happens when your tenant admin creates a custom blocked word list on Azure portal.

To piece of work effectually this issue, your tenant admin will need to remove this policy from Azure portal.

Error: Blocked a frame with origin from accessing a cross-origin frame

A few pages in customer engagement apps in Dynamics 365 tin only exist opened in a browser window equally they make use of JavaScript functions trying to access DOM elements and properties through window.top which is non supported to load within Microsoft Teams. When this page is opened without whatsoever iframe and so it works fine as elevation most window'south context is client engagement app page and required attributes and backdrop are available. Whereas when this aforementioned page is opened within Microsoft Teams, information technology's actually loaded inside an iframe where window.elevation represents top most window context which is Microsoft Teams window and not the customer engagement app folio. Hence it'southward not able to detect relevant attributes and properties which lead to showing of mistake bulletin Blocked a frame with origin from accessing a cross-origin frame in the browser console. For example, if you lot open up the schedule board page for Dynamics 365 Project Service Automation within Microsoft Teams, yous will go this error.

To work around this, open the page in your customer engagement app and not in Microsoft Teams.

If the page which is showing the error message, contains a custom resource (JavaScript, custom control etc.), please ensure window is not used in the JavaScript as information technology may cause the folio to not load at all or not load properly. For more information, see Avoid using window top.

Documents can be accessed in your customer engagement app using the Documents tab in an entity record fifty-fifty later on user has left the team.

Whenever a member leaves the squad where an entity record was pinned, the Files tab in Microsoft Teams which shows the documents shared in the team won't be visible anymore every bit the user would lose admission to the squad. However, the user can still go to the customer date app in Dynamics 365 and access the tape that was pinned in the team and can access files in the Documents tab in the Related section.

To disable the user from accessing to the documents in the record from the customer appointment app, an admin tin can remove the access of the record to the user or control the permission using the SharePoint site permissions.