Troubleshooting Microsoft Teams Integration with Business Central

APPLIES TO: Business Central online

This article provides information on how to identify and fix problems you may experience when using Microsoft Teams with Business Central, as a typical user or administrator.

If you're experiencing this problem, here are a few things to try:

  1. First, make sure that the Business Central app for Teams is installed.

    To check, sign in to the Teams desktop app or Teams in the browser. Then, on the left side, select Apps, and search for Business Central. When you find the Business Central app, select it to open the app details page. If the Add for me button is shown, then the Business Central app isn't installed. For more information about how to install the app, see Install the Business Central App for Microsoft Teams.

    Note

    Guest users can't immediately install apps. For more information about guest users, see our FAQ about collaborating with guests.

  2. Next, check that you've signed in with the correct identity.

    In Teams, go to any chat, and under the message compose box, choose the Business Central icon. When the window appears, check whether the user it says that you're connected as matches what you use to connect to Business Central.

  3. Make sure codeunit 2718 Page Summary Provider is published as a web service.

    Teams connects to Business Central using an endpoint to this codeunit on the Business Central service. For information about publishing web services, see Publish a Web Service.

  4. Your organization may also restrict you from pasting links that expand into cards. Contact your administrator to understand the Teams organizational policies that may apply to you.

A link won't expand into a card in the following situations:

  • The link targets a page of a type that doesn't represent a record. For example, it could be a link to Business Central’s Role Center. You can check the page type using the page inspection pane in the Web client in Business Central. For more information about page inspection, see Inspecting Pages.
  • The link targets a page that (at a technical level) isn't connected to a source table in Business Central. You can check whether a page has a source table by using the page inspection pane in the Web client in Business Central. For more information about page inspection, see Inspecting Pages.
  • Teams doesn't support link previews in some features. For example, when you pop out a chat, you're in a meeting, or you're a guest to another organization.
  • Teams silently abandons trying to display the card after 15 seconds, for example, because of network issues.
  • Teams may not expand the link if you've already pasted a link into the same message compose box and deleted the card.

The link must also contain all the necessary information to locate the record and display the corresponding card. This information includes:

  • The environment name, by including it in the URL path. If you don't specify the environment name, Teams assumes you're attempting to reach the environment named "Production".
  • The company name, by using the company= parameter
  • The page identifier, by using the page= parameter
  • The bookmark to the record, by using the bookmark= parameter

For example:

https://businesscentral.dynamics.com/?environmentname=Production&company=CRONUS%20USA%2C%20Inc.&page=21&dc=0&bookmark=21%3bEgAAAAJ7BTEAMAAwADAAMA%3d%3d

For technical details about Business Central URLs, see Web Client URL in the Business Central Developer and IT Pro Help.

The card is displayed in the message compose box, but selecting the Details button does nothing

After a link gets expanded into a card in the message compose box, you must send the message to the chat before you can use the Details button.

The details window opens, but shows an error before details are shown

This problem can be caused by a couple things: lack of permissions in Business Central or browser settings (when using Teams in the browser).

  1. Verify your permissions in Business Central.

    To view details for a card, Business Central checks your license and permissions to view that specific record and page in the specific company and environment. If you aren't authorized for any of these things, standard Business Central error messages about permissions appear in the details window.

    For more information about permissions, see Assign Permissions to Users and Groups

  2. Check your browser settings if using Teams in the browser.

    • Your browser's pop-up blocker must be either turned off or set to allow pop-ups from the businesscentral.dynamics.com or bc.dynamics.com domains. For information about allowing pop-ups for Business Central, see Setting Up Your Browser.
    • Your browser must have access to local browser storage for cookies and preferences as you work.
    • Avoid using guest or private browsing unless necessary, because they discard or block certain content in some browsers.

    For more information about minimum browser requirements, see Minimum Requirements for Using Business Central

I'm having problems with the camera or location in Teams

When using Business Central features in the details window that require access to your location or device camera, you must first give your consent for Teams to access these device capabilities.

  • For Teams in the browser, make sure that your browser settings allow access to camera and location for https://teams.microsoft.com.

  • For Teams for iOS or Android, make sure that your device settings allow access to camera and location for the Teams mobile app.

For help about changing these settings, see My camera isn't working in Teams on Microsoft Support.

The Business Central app doesn't support location in the Teams desktop app. For more information about location, see the Teams FAQ.

Some browsers, such as the new Microsoft Edge, allow you to choose which device camera to use when your device supports multiple cameras.

Teams displays mixed languages for my cards and card details

For cards and card details to display consistently in the same language in Teams, the language of your Teams client and the language you use in Business Central Web client must match.

For more information on how languages work between Teams and Business Central, see Teams FAQ.

I edited a field in the details window, but my change wasn't saved

Changes you make to a field in the details windows are automatically saved when you leave the field. Before you close the window after changing a field, be sure to press the Tab key or click/tap outside the field.

A new tile appeared in the App Launcher. How do I remove it?

When you view your apps on the Office 365 home page (https://home.office.com) or in the app launcher, a new tile named "Business Central Teams Integration Service Connector" will appear after installing the Business Central app for Teams. This tile provides no value in itself and can be safely hidden.

As an administrator, who has Azure Active Directory admin permissions, you can hide the tile by doing the following steps:

  1. Sign in to the Azure Active Directory admin center.
  2. Select Enterprise apps, then select Business Central Teams Integration Service Connector.
  3. Select Properties, then set the Visible To Users switch to No.
  4. Select Save.
Note

It will be a while before this change takes effect.

See Also

Business Central and Microsoft Teams Integration Overview
Install the Business Central App for Microsoft Teams
Teams FAQ
Developing for Teams Integration

Start a free trial!

Note

Can you tell us about your documentation language preferences? Take a short survey.

The survey will take about seven minutes. No personal data is collected (privacy statement).