topic hubIntegration & APIsofficial - Microsoftreviewed - checked by Opus

Integrating with Microsoft Teams

Integration of Business Central with Microsoft Teams, aimed at AL developers. It covers Teams cards, card details and tabs, customizing cards with the Brick field group and AL events, detecting Teams sessions, and FAQs on link unfurling, stage view, licensing and permissions.

Path: Integration > Integrating Business Central with Office apps and Microsoft 365 > Integrating with Microsoft Teams · tier official · system integration · narrative reviewed (checked by Opus)

Overview

This section explains how Business Central works inside Microsoft Teams and how to develop for it. The main development page introduces the building blocks: Teams cards, card details, Business Central tabs, the Brick field group, Teams-specific AL events and Graph API integration.

The other pages go deeper. One covers customizing which fields appear on cards shared in Teams, using field groups or event subscribers. Another shows how to get session and environment information, such as whether code runs in a Teams context. The FAQ covers link unfurling, stage view, licensing and permissions. The Tabs subtopic covers creating tabs programmatically through the Microsoft Graph API and customizing the recommended list pages.

Start with the development overview to see the pieces, then move to the metadata page for card customization or the Tabs subtopic for tab setup. Use the FAQ for licensing and permission questions.

Key points

  • Teams cards show Business Central records shared in Teams; the FAQ describes the link unfurling technology and adaptive cards behind them.
  • The platform automatically selects card fields from the Brick field group, the Dropdown field group, or primary key fields.
  • Cards can be customized with the Brick field group or with the OnBeforeGetPageSummary and OnAfterGetSummaryFields events; media fields are also covered.
  • Business Central tabs can be created programmatically in channels and chats through the Microsoft Graph API.
  • The recommended list pages shown when users configure a tab can be customized.
  • Code can check CurrentClientType to know if it runs in Teams, and can detect Microsoft 365 license usage and whether M365 collaboration is enabled.
  • The FAQ covers stage view, licensing requirements and permissions for cards and tabs.

Subtopics

More Learn pages

Videos and posts

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.

What Learn documents here 6 Learn pages