[All Hosts] (devx) Article to situate add-ins in M365 ecosystem

docs/concepts/extend-to-microsoft-365.md

@@ -0,0 +1,87 @@
+---
+title: Extend your solution to other parts of Microsoft 365
+description: Learn how an Office Add-ins can be combined with other extensions into an app for Microsoft 365
+ms.date: 01/17/2025
+ms.localizationpriority: medium
+---
+
+# Extend your solution to other parts of Microsoft 365
+
+An Office Add-in is an App for Microsoft 365, just as a custom Teams app and a custom Copilot agent are. This enables you to combine an add-in with one or more of these other types of Microsoft 365 extensions. Your combination solution has a single manifest that configures all of its parts, and a single app package — a ZIP file — that is the unit of sideloading and of publishing to Microsoft Marketplace or the Microsoft 365 admin center.
+
+> [!TIP]
+> You can't include a [SharePoint Framework app](/sharepoint/dev/spfx/sharepoint-framework-overview) in the Microsoft extension's app package, but you can bundle your Microsoft 365 extension with one or more SharePoint Framework apps into a single Software as a Service (SaaS) offering. The SaaS is installed and managed as a unit using the integrated apps portal in the admin center. For more information, see [SaaS linked apps](/microsoft-365/admin/manage/saas-linked-apps) and [Integrated Apps portal](/microsoft-365/admin/manage/test-and-deploy-microsoft-365-apps).
+
+We recommend that you take advantage of this packaging system to combine closely related functionality and experiences into a single app for Microsoft 365. The following are just a few of the scenarios. 
+
+- Make a page experience available in both your add-in task pane and in a custom personal tab in one or more of the Microsoft 365 applications with an **App bar**: Teams, Outlook, and the Microsoft 365 Copilot application.
+- Create a Copilot agent that gets Microsoft Graph data and is available in Excel and Teams. 
+- Include similar handlers for similar events, such as a user being added to a Teams conversation and a recipient being added to an Outlook message.
+- Record in a database discrete user actions in an Office application, and view the accumulated data in a custom tab that is opened from the **App bar** in Teams, Outlook, or Microsoft 365 Copilot.
+
+## Cross application development features
+
+The following sections introduce some of the Microsoft 365 development features that cross the boundaries between Office, Teams, and Copilot. For a matrix of support on various platforms, see [Platform support](#platform-support).
+
+### Personal tabs
+
+Reach your users where they are, right in the context of their work by extending your web app as a [personal tab](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab) application that also runs in Outlook, Teams, and the Microsoft 365 Copilot application. 
+
+:::image type="content" source="../images/outlook-office-teams-personal-tab.png" alt-text="The screenshot is an example that shows Personal tab running in Outlook, Microsoft 365, and Teams.":::
+
+On mobile, you can test and debug your Teams personal tab running on Microsoft 365 for [iOS](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#microsoft-365-for-ios) and [Android app](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#microsoft-365-for-android-app), in addition to Outlook for [iOS](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#outlook-app-for-ios) and [Android app](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#outlook-for-android-app).
+
+# [Android](#tab/Android)
+
+:::image type="content" source="../images/office-mobile-personal-tab.png" alt-text="The screenshot is an example that shows personal tab running in Microsoft 365 on Android app.":::
+
+# [iOS](#tab/iOS)
+
+:::image type="content" source="../images/m365-mobile-personal-tab.png" alt-text="The screenshot is an example that shows personal tab running in Microsoft 365 on iOS.":::
+
+---
+
+> [!TIP]
+> Personal tabs can be built and hosted with [SharePoint Framework](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#sharepoint-framework-spfx-apps) (SPFx) version 1.16 and later as an alternative to hosting them on a web server or web service. See [Add Teams tab to SharePoint](/microsoftteams/platform/tabs/how-to/tabs-in-sharepoint) and [Build Microsoft Teams tab using SharePoint Framework - Tutorial](/sharepoint/dev/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab). Although these articles use the term "Teams tab" they apply also to personal tabs in Outlook and Microsoft 365 Copilot.
+
+### Message extensions and link unfurling
+
+Message extensions enable users to interact with your web service using buttons and forms. Users can search or initiate actions in an external system from chat messages in Teams and email messages in Outlook.
+
+:::image type="content" source="../images/outlook-teams-messaging-ext.png" alt-text="The screenshot is an example that shows Message extension running in Outlook and Teams.":::
+
+Link unfurling works in both Outlook messages and Teams chat messages. You can also unfurl links with cards that launch Stageview.
+
+:::image type="content" source="../images/outlook-teams-link-unfurling.png" alt-text="The screenshot is an example that shows Link unfurling running in Outlook and Teams.":::
+
+For more information, see [Build message extensions](/microsoftteams/platform/messaging-extensions/what-are-messaging-extensions) and [Teams message extensions](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension). See also the guidance in [Scenarios for creating an Outlook add-in and a message extension](/microsoftteams/platform/m365-apps/me-or-outlook-add-in) to learn when to use a Outlook add-in and when to use a message extension in Outlook.
+
+### Meeting apps
+
+Meeting apps are essentially tab apps that are designed to foster collaboration before, during, and after meetings. You can configure and add meeting apps to the Teams meetings scheduled from Outlook and also run meeting apps within the Outlook calendar.
+
+:::image type="content" source="../images/outlook-teams-meeting-app.png" alt-text="Screenshot of a sample meeting app running in both Teams and Outlook":::
+
+For more information, see [Apps for meetings and calls](/microsoftteams/platform/apps-in-teams-meetings/teams-apps-in-meetings) and [Extend a meeting app to Outlook](/microsoftteams/platform/m365-apps/extend-m365-meeting-app).
+
+### Platform support 
+
+The following table shows platforms support the various types of Apps for Microsoft 365.
+
+| Teams app features| Teams support |Outlook support |Microsoft 365 Copilot application support |Word, Excel, PowerPoint support| Notes |
+|--|--|--|--|--|--|--|
+| [**Tabs-personal scope**](/microsoftteams/platform/tabs/how-to/create-personal-tab)     |Web, Desktop, Mobile | Web, Desktop, Mobile (Android, iOS) | Web, Desktop, Mobile (Android, iOS)|-|Channel and group scopes aren't supported for Microsoft 365. For more information, see [Teams JavaScript client library](/microsoftteams/platform/tabs/how-to/using-teams-client-sdk#microsoft-365-support-running-teams-apps-in-office-and-outlook).
+| [**Meeting apps**](/microsoftteams/platform/m365-apps/extend-m365-meeting-app)|Web, Desktop, Mobile|Desktop|-|-|Meeting Stageview isn't supported in Outlook. See [Extend a meeting app to Outlook](/microsoftteams/platform/m365-apps/extend-m365-meeting-app).|
+| [**Message extensions-search-based**](/microsoftteams/platform/messaging-extensions/how-to/search-commands/define-search-command)| Web, Desktop, Mobile| Web, Desktop | - |-|For limitations and troubleshooting, see [Limitations](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension#limitations). |
+| [**Action-based message extensions**](/microsoftteams/platform/messaging-extensions/how-to/action-commands/define-action-command)| Web, Desktop, Mobile| Web | - |-| Viewable/actionable (not composable) in Teams/Outlook mobile preview (iOS, Android). For limitations and troubleshooting, see [Limitations](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension#limitations). |
+| [**Link unfurling (including Stageview)**](/microsoftteams/platform/tabs/tabs-link-unfurling) | Web, Desktop | Web, Desktop | - | -|See notes on [link unfurling](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension) and [Stageview](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension)|
+| [**Adaptive Card Loop components**](/microsoftteams/platform/m365-apps/design-loop-components)|Web, Desktop |Web, Desktop (only for [new Outlook](https://support.microsoft.com/office/getting-started-with-the-new-outlook-for-windows-656bb8d9-5a60-49b2-a98b-ba7822bc7627)) |-|-| Viewable (not composable) in Teams/Outlook mobile preview (iOS, Android). See [Adaptive Card-based Loop components](/microsoftteams/platform/m365-apps/cards-loop-component).|
+| [**Stageview**](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension)|Web, Desktop, Mobile|Web (preview), Desktop (preview)|-|-| Viewable/actionable (not composable) in Outlook mobile preview (iOS, Android). See [Message extensions](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension).|
+| [**Office Add-ins**](../overview/office-add-ins.md) | - | Web, Desktop | - | Web, Desktop | See [office Add-ins platform overview](../overview/office-add-ins.md).|
+| [**Copilot agents**](/microsoft-365-copilot/extensibility/ecosystem) | Web, Desktop | - | Web, Desktop | Web, Desktop | See [Declarative agents for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/overview-declarative-agent) |
+
+## See also
+
+- [Office Add-ins developer documentation](../overview/office-add-ins.md)
+- [Microsoft 365 Copilot Agent developer documenation](/microsoft-365-copilot/extensibility/ecosystem)
+- [Teams developer documentation](/microsoftteams/platform/overview)

docs/toc.yml

@@ -69,6 +69,8 @@
     - name: Manage both a unified manifest and an add-in only manifest version of your add-in
       href: concepts/duplicate-legacy-metaos-add-ins.md
       displayName: Excel, Word, PowerPoint, Outlook
+    - name: Extend your solution to other parts of Microsoft 365
+      href: concepts/extend-to-microsoft-365.md
   - name: Develop
     items:
     - name: Overview