Managing Microsoft Teams Integration with Business Central

APPLIES TO: Business Central online

This article provides an overview of what you can do as an administrator to control Microsoft Teams integration with Business Central.

In Microsoft Teams

Minimum requirements

This section describes the minimum requirements for the Business Central app features to work in Teams.

  • Required licences

    The Business Central app requires a Teams licence through a Microsoft 365 Business or Enterprise subscription. Standalone Teams subscriptions such as Microsoft Teams (free) or Microsoft Teams Essentials aren't supported.

    Most features of the Business Central app for Teams also require a Business Central licence, as shown in the following table.

    What Business Central licence
    Search for Business Central contacts. check mark
    Paste a link to a Business Central record into a conversation, and send it as a card. check mark
    Share a link from a page in Business Central to Teams conversation. check mark
    View a card of a Business Central record in a conversation.
    View more details of card for a Business Central record in a conversation. check mark
    Open a page link in Business Central from a conversation. check mark
  • Allow URL previews

    Allow URL previews policy setting must be turned on. Otherwise, a card can't be generated for Business Central links pasted into a Teams conversation. For more information about this setting, see Manage messaging policies in Teams.

Managing the Business Central app (optional)

As a Teams administrator, you can manage all apps for your organization, including the Business Central app. You can approve or install the Business Central app for your organization, block user's from installing the app, and more.

For more information, see the following articles in the Microsoft Teams documentation:

In Business Central

Minimum requirements

  • Business Central version:

    Business Central 2021 release wave 1 or later. Teams integration is only supported for Business Central online; not on-premises.

  • Codeunit 2718 Page Summary Provider is published as a web service:

    This codeunit is published as a web service by default. The codeunit is part of the Business Central system application. It's used to get the field data for a Business Central page added to a Teams conversation. For information about publishing web services, see Publish a Web Service.

  • User permissions:

    For the most part, the contact search, pages, and data that users can view and edit in a Teams conversation is controlled by their permissions in Business Central.

    • To search for contacts, users must have at least read permission to the Contacts table.
    • To paste a Business Central link into a Teams conversation and have it expand into a card, users must have at least read permission on the page and its data.
    • Once a card is submitted into a conversation, any user in that conversation can view that card without permission to Business Central.
    • To view more details for a card or open the record in Business Central, users must have read permission on the page and its data.
    • To change data, user's need modify permissions.

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

Installing the Business Central app by using Centralized Deployment

The Microsoft Teams admin centre is where you configure Teams app setup policies for the organization. In the Teams admin centre, you can use the Centralized Deployment feature to automatically install the Business Central app in Teams for all users in your organization, specific groups, or individual users.

Note

To set up Centralized Deployment, your Teams account must have the Teams Service admin role or the Global admin role.

  1. In Business Central, choose the Magnifying glass that opens the Tell Me feature. icon, enter Teams App Centralized Deployment, and then choose the related link. Or select here to open the page directly.

  2. Read the information on the Set up the Business Central app for Teams, then choose Next when ready.

  3. Open the Teams admin centre, and complete the following steps.

    1. Go to Teams apps > Setup policies.

    2. Create a new policy or select the policy that you want to use to install the Business Central app, then select Add apps.

    3. In the Add installed apps page, search for and select Business Central.

    4. Choose Add.

      Business Central should now appear under Installed apps for the policy.

    5. Configure more settings as needed, then choose Save.

    For more information about setup policies in Teams, see Manage app setup policies in Microsoft Teams in the Teams documentation.

  4. Go back to Teams App Centralized Deployment in Business Central and select Done.

Important

It can take up to 24 hours for the app set up policy to be applied and the app deployed to users.

Managing privacy and compliance

Microsoft Teams provides extensive controls for compliance and management of sensitive or personally identifiable data—including data added to chats and channels by the Business Central app.

Understanding where Business Central cards are stored

After a card is sent to a chat, the card and the fields shown on the card are copied to Teams. This information is subject to the Teams policies for your organization, such as data retention policies. When displaying card details, none of the data in the details window is stored in Teams. The data remains stored in Business Central and will only be retrieved by Teams when the user chooses to view the details.

Restricting sharing of cards

You prevent specific users or groups from sending cards to chats or channels by setting up messaging policies that turn off the URL Previews setting. For more information about this setting, see Manage messaging policies in Teams.

You can also use information barriers to prevent individuals or groups from communicating with each other. To learn more, see Information barriers in Microsoft Teams.

Data loss prevention features in the Microsoft 365 Security & Compliance Centre can't be applied specifically to cards. But they can be applied to the chat messages that contain the cards.

Responding to data requests

You allow team members and team owners to delete messages that contain sensitive cards by setting up messaging policies, like: Owners can delete sent messages and Users can delete sent messages. For more information, see Manage messaging policies in Teams.

Content search and eDiscovery compliance features in the Microsoft 365 Security & Compliance Centre can also be applied to cards.

Because card data in Teams is a copy of data in Business Central, you can also use Business Central features to export a customer’s data if requested. For more information about privacy in Business Central, see Privacy FAQ for Business Central Customers.

Show or hide record data on cards

When a record is shared with others in a Teams chat or channel, a card with fields that contain data about the record is shown. All recipients can view this data (or record summary) by default, regardless of their licence or permissions in Business Central. If you're an admin, you can use the Card Settings assisted setup guide to hide the record summary from appearing on cards in Teams. Hiding the record summary removes all fields and images but continues to show the Details button and other non-record information on the card.

Record summary on Record summary off
Image that shows a card in Teams when the record summery is turned on. Image that shows a card in Teams when the record summery is turned off.

You configure the setting per environment. So when you turn the record summary on or off, it will affect all companies in the environment.

  1. In Business Central, open the environment that you want to change.

    Tip

    To switch the environment, select Ctrl+O.

  2. Choose the Magnifying glass that opens the Tell Me feature. icon, enter Card Settings, and then choose the related link.

  3. Read the information on the Card Settings, then choose Next when ready.

  4. On the Data Visibility page, turn on the Show record summary switch to display data on the cards or off to hide the data.

  5. Select Next and follow the instructions to complete the setup guide.

See Also

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

Start a free trial!

Find free e-learning modules for Business Central here