{"title":"Developing for Microsoft Teams Integration","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-develop-for-teams/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-develop-for-teams, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-develop-for-teams","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Provides an introduction to developing pages for Microsoft Teams integration.","date":"2022-11-23","meta":{"topic":"overview"},"outline":[{"level":1,"title":"Developing for Microsoft Teams Integration","slug":"developing-for-microsoft-teams-integration","at":0,"chars":7280},{"level":2,"title":"Introduction to the Business Central app for Teams","slug":"introduction-to-the-business-central-app-for-teams","at":577,"chars":1018},{"level":2,"title":"Managing, Installing, and Using the Business Central App for Teams","slug":"managing-installing-and-using-the-business-central-app-for-teams","at":1595,"chars":266},{"level":2,"title":"Development overview","slug":"development-overview","at":1861,"chars":4547},{"level":3,"title":"About cards","slug":"about-cards","at":2220,"chars":1906},{"level":3,"title":"About card details","slug":"about-card-details","at":4126,"chars":803},{"level":3,"title":"About Business Central tabs","slug":"about-business-central-tabs","at":4929,"chars":1479},{"level":2,"title":"Preparing your environment for development and testing","slug":"preparing-your-environment-for-development-and-testing","at":6408,"chars":717},{"level":2,"title":"Related information","slug":"related-information","at":7125,"chars":155}],"text":"# Developing for Microsoft Teams Integration\n> APPLIES TO: Business Central online\nhttps://www.microsoft.com/microsoft-365/microsoft-teams is a Microsoft 365 product that lets you connect with others, collaborate seamlessly and simplify work. Business Central offers an app that connects Microsoft Teams to your business data in Business Central so users can quickly share details across team members and respond faster to inquiries. This article gives you an overview of what you can do as developer to customize displaying Business Central data and Teams channels and chats.\n## Introduction to the Business Central app for Teams\nIn short, the app lets users:\n Add a tab that embeds Business Central data, such as a filtered list.\n Copy a link to any Business Central record and paste it into Teams conversation to share with your coworkers. In Teams, the link will expand that into a compact card that displays a defined set of fields about the record.\n From the card in teams, users can select a button to view more details about the record. The card opens a window inside Teams that includes FactBoxes and other embedded content, such as charts.\n With the proper permissions, Business Central users in the chat or channel can edit fields, create records, start work flows, and take action from a card details or tab&mdash;without having to switch from Teams.\n Search for business contacts and view related details in a window in Teams\n![Teams integration with Business Central.]<https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/media/teams-intro-v3.png#lightbox>\n## Managing, Installing, and Using the Business Central App for Teams\nFor more information about installing and using the Business Central app in Teams from an admin and user perspective, see Business Central and Microsoft Teams Integration</across-teams-overview>.\n## Development overview\nAs a developer, you can influence the Business Central experience in Teams as part of your extensions using AL code. Most of the experience in Teams is powered by Business Central APIs and by embedding the Business Central Web client tailored for Teams. Business Central also offers AL events specifically for use with Teams features.\n### About cards\nCards in Teams are used to summarize a Business Central page or record, and provide a convenient way for users to drill down to the full details, without leaving the Teams application. Users can create cards in different ways:\n when searching for business contacts in Teams\n when pasting a link to a Business Central record\n when using the Share to Teams feature in the Business Central Web client.\nNo matter how a user chooses to create a card, the resulting card is always the same. Developers can choose which fields are shown on the card, but can't choose the layout or style, or create more action buttons.\nThe Business Central card is designed to work with entity pages that represent a single record. More specifically, it's designed for Card, Document, or ListPlus pages. Teams is ready to work with links to these page types and the underlying data in the source tables.\nIn most cases, displaying a card in Teams requires no extra development effort. But if a card doesn't display the fields and data you want, you have a couple options in AL code for making changes:\n Use a field group control on the source table\n  This method primarily involves using the Brick field group on the page's source table.\n Use Teams-specific events\n  There are currently two events that you can code against to change the fields that display in the card at runtime. We recommend that you use these events as an additive measure.\nIn most cases, we recommend you set the Brick field group instead of using events to define card content. Using the Brick field group ensures a consistent experience across the Business Central Web client, mobile devices, and Teams. If a table doesn't include a Brick field group, you should add one, then use the events to change the fields as needed.\nFor more information about these two development options, see Extending Teams Cards<devenv-develop-for-teams-cards>.\n### About card details\nUsers can select the Details button on a Teams card to drill into the details of the card without leaving the Teams app. This button opens the Business Central Web client in a window that's embedded inside Teams. The window displays the target page object. The page includes any extensions to the page and its source table, role customizations, and user personalization. The experience is nearly identical to that of displaying the same record in the Business Central Web client, except with some minor client differences.\nYou can modify or extend the layout and behavior of the page, like you would any page. The changes you make will affect the page in all Business Central clients, not just in Teams. For more information about implementing pages, go to devenv-pages-overview.\n### About Business Central tabs\nIn Teams, tabs appear at the top of channels and chats, giving participants quick access to pertinent information. Tabs are similar to card details as far as the content they display and what users can do with the content in Teams:\n A tab displays the target page object, including any extensions to the page and its source table, role customizations and user personalization.\n Apart from minor differences, a tab looks like what you'd see for the same record in the Business Central Web client.\n You can drill into the details of the record.\nAs a developer, you can modify or extend the layout and behavior of the source page. The changes you make will affect the page in all Business Central clients, not just in Teams.\nBusiness Central tabs, like card details, are designed to embed most Business Central entity page types, including Card, Document, or ListPlus. But tabs also support collection page types such as List and Worksheet. Role Center page objects aren't supported.\nUsing the Graph API, you can add Business Central tabs to new or existing channels and chats in Teams. Together with the Business Central app for Teams, you can set up a Teams environment complete with teams, channels, and Business Central tabs&mdash;without requiring users to do anything extra.\nSee Create Business Central tabs for Teams<devenv-develop-for-teams-tabs> and Provide Recommended Content to Business Central Tab<devenv-develop-for-teams-tab-content>.\n## Preparing your environment for development and testing\nDeveloping for Teams integration is similar to other development activities in Business Central. It requires Visual Studio Code, installed with the AL language extension, and knowledge of the AL language. However, because the Business Central app for Teams only supports Business Central online, you must deploy your extensions to an online sandbox to test the implementation. The sandbox must also be deployed to a Microsoft Entra tenant that has access to Microsoft Teams through one of the supported Microsoft 365 plans. For more information about sandboxes, see Sandbox Environments for Dynamics 365 Business Central Development<devenv-sandbox-overview>.\n## Related information\nFAQ for Teams Integration<devenv-dev-faq-teams>\ndevenv-field-groups\ndevenv-designing-list-pages\ndevenv-working-with-media-on-records"}