| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| platform | Bots Filesv4 | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/bots-filesv4.md | Title: Send and receive files using bot description: Learn how to send and receive files through the bot using Graph APIs for personal, channel and groupchat scopes. Previously updated : 05/20/2019 Last updated : 04/17/2023 ms.localizationpriority: medium |
| platform | Extend M365 Teams Message Extension | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/m365-apps/extend-m365-teams-message-extension.md | To preview your app running in Outlook on the web: 1. Sign in to [outlook.com](https://www.outlook.com) using your test tenant credentials. 1. Select **New message**.-1. Open **More apps** flyout menu on the bottom of the composition window. +1. Select **Apps** on the ribbon. - :::image type="content" source="images/outlook-web-compose-more-apps.png" alt-text="The screenshot is an example that shows the 'More apps' menu on the bottom of the mail composition window to use your message extension."::: + :::image type="content" source="images/outlook-web-compose-more-apps.png" alt-text="The screenshot is an example that shows the 'Apps' menu on the ribbon of the mail composition window to launch your message extension."::: Your message extension is listed. You can invoke it from there and use it just as you would while composing a message in Teams. To preview your app running in Outlook on Windows desktop: 1. Launch Outlook and sign in with your test tenant credentials. 1. Select **New Email**.-1. Open the **More Apps** flyout menu on the top ribbon. +1. Select **All Apps** on the ribbon. - :::image type="content" source="images/outlook-desktop-compose-more-apps.png" alt-text="The screenshot is an example that shows the 'More Apps' on the composition window ribbon to use your message extension."::: + :::image type="content" source="images/outlook-desktop-compose-more-apps.png" alt-text="The screenshot is an example that shows the 'All Apps' menu on the ribbon of the composition window to launch your message extension."::: Your message extension is listed, it opens an adjacent pane to display search results. |
| platform | Extend M365 Teams Personal Tab | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/m365-apps/extend-m365-teams-personal-tab.md | ms.localizationpriority: medium # Extend a Teams personal tab across Microsoft 365 app -Personal tabs provide a great way to enhance the Microsoft Teams experience. Using personal tabs, you can provide a user access to their application right within Teams, without the user having to leave the experience or sign in again. With this preview, personal tabs can light up within other Microsoft 365 applications too. This tutorial demonstrates the process of taking an existing Teams personal tab and updating it to run in both Outlook and Microsoft 365 desktop and web experiences, as well as Microsoft 365 app for Android. +Personal tabs provide a great way to enhance the Microsoft Teams experience. Using personal tabs, you can provide a user access to their application right within Teams, without the user having to leave the experience or sign in again. With this preview, personal tabs can light up within other Microsoft 365 applications too. This tutorial demonstrates the process of taking an existing Teams personal tab and updating it to run in both Outlook and Microsoft 365 desktop and web experiences, as well as Microsoft 365 for Android app. Updating your personal app to run in Outlook and Microsoft 365 involves these steps: To complete this tutorial, you need: * A Microsoft 365 Developer Program sandbox tenant. * Your sandbox tenant enrolled in *Microsoft 365 Targeted Releases*. * A machine with Microsoft 365 apps installed from the Microsoft 365 Apps *beta channel*.-* (Optional) An Android device or emulator with Microsoft 365 app for Android installed. +* (Optional) An Android device or emulator with Microsoft 365 for Android app installed. * (Optional) [Teams Toolkit](https://aka.ms/teams-toolkit) extension for Microsoft Visual Studio Code to help update your code. > [!div class="nextstepaction"] The final step to running your app in Microsoft 365 and Outlook is to sideload y :::image type="content" source="images/teams-upload-custom-app.png" alt-text="The screenshot is an example that shows the option to upload am app in Teams."::: -After it's sideloaded to Teams, your personal tab is available in Outlook and Microsoft 365 app. You must sign in with the same credentials that you used to sideload your app into Teams. When running the Microsoft 365 app for Android, you need to restart the app to use your personal tab app from the Microsoft 365 app. +After it's sideloaded to Teams, your personal tab is available in Outlook and Microsoft 365 app. You must sign in with the same credentials that you used to sideload your app into Teams. When running the Microsoft 365 for Android app, you need to restart the app to use your personal tab app from the Microsoft 365 app. You can pin the app for quick access, or you can find your app in the ellipses (**...**) flyout among recent applications in the sidebar on the left. Be aware, that pinning an app in Teams doesn't pin it as an app in Microsoft 365 app or Outlook. Here's how to preview your app running in Microsoft 365 and Outlook, web and Win To view your app running in Outlook on Windows desktop: 1. Launch Outlook and sign in using your dev tenant account.-1. On the side bar, select **More Apps**. Your sideloaded app title appears among your installed apps. +1. On the side bar, select **More apps**. Your sideloaded app title appears among your installed apps. 1. Select your app icon to launch your app in Outlook. - :::image type="content" source="images/outlook-desktop-more-apps.png" alt-text="The screenshot is an example that shows the ellipses (More apps) option on the side bar of Outlook desktop client to see your installed personal tabs."::: + :::image type="content" source="images/outlook-desktop-more-apps.png" alt-text="The screenshot is an example that shows the More apps option on the side bar of Outlook desktop client to see your installed tab app."::: ### Outlook on the web To view your app in Outlook on the web: 1. Go to [Outlook on the web](https://outlook.office.com) and sign in using your dev tenant account.-1. On the side bar, select **More Apps**. Your sideloaded app title appears among your installed apps. +1. On the side bar, select **Apps**. Your sideloaded app title appears among your installed apps. 1. Select your app icon to launch and preview your app running in Outlook on the web. - :::image type="content" source="images/outlook-web-more-apps.png" alt-text="The screenshot is an example that shows the ellipses (More apps) option on the side bar of outlook.com to see your installed personal tabs."::: + :::image type="content" source="images/outlook-web-more-apps.png" alt-text="The screenshot is an example that shows the Apps option on the side bar of outlook.com to see your installed tab app."::: ++### Outlook for Android app ++To view your app running in Outlook for Android app: ++1. Open the Outlook app on your Android device and sign in using your developer tenant account. If the Outlook for Android app was already running prior to sideloading your app, restart Outlook to see it in the installed apps section. +1. Select the **More** icon. Your sideloaded app appears among installed apps. +1. Select your app icon to open your app in Outlook for Android. ++ :::image type="content" source="images/outlook-mobile-more.png" alt-text="The screenshot is an example that shows the 'More' option on the side bar of the Outlook app to see your installed personal tabs in Android."::: ++### Outlook app for iOS ++To view your app running in Outlook app for iOS: ++1. Open the Outlook app on your device and sign in using your developer tenant account. If the Outlook app was already running prior to sideloading your app in Teams, restart Outlook to see it in the installed apps section. +1. Select the **More** icon. Your sideloaded app appears among installed apps. +1. Select your app icon to open your app in the Outlook app. ++ :::image type="content" source="images/outlook-ios-mobile-more.png" alt-text="The screenshot is an example that shows the 'More' option on the side bar of the Outlook app to see your installed personal tabs in iOS."::: ### Microsoft 365 on Windows To view your app running in Microsoft 365 on Windows desktop: 1. Select the **Apps** icon on the side bar. Your sideloaded app title appears among your installed apps. 1. Select your app icon to launch your app in Microsoft 365. - :::image type="content" source="images/office-desktop-more-apps.png" alt-text="The screenshot is an example that shows the ellipses (More apps) option on the side bar of Microsoft 365 desktop client to see your installed personal tabs."::: + :::image type="content" source="images/office-desktop-more-apps.png" alt-text="The screenshot is an example that shows Apps option on the side bar of Microsoft 365 desktop client to see your installed tab app."::: ### Microsoft 365 on the web To preview your app running in Microsoft 365 on the web: 1. Select the **Apps** icon on the side bar. Your sideloaded app title appears among your installed apps. 1. Select your app icon to launch your app in Microsoft 365 on the web. - :::image type="content" source="images/office-web-more-apps.png" alt-text="The screenshot is an example that shows the (More apps) option on the side bar of microsoft365.com to see your installed personal tabs."::: + :::image type="content" source="images/office-web-more-apps.png" alt-text="The screenshot is an example that shows the Apps option on the side bar of microsoft365.com to see your installed tab app."::: -### Microsoft 365 app for Android +### Microsoft 365 for Android app -To view your app running in Microsoft 365 app for Android: +To view your app running in Microsoft 365 for Android app: -1. Launch the Microsoft 365 app and sign in using your dev tenant account. If the Microsoft 365 app for Android was already running prior to sideloading your app in Teams, you need to restart it in order to see in your installed apps. +1. Launch the Microsoft 365 app and sign in using your dev tenant account. If the Microsoft 365 app was already running prior to sideloading your app in Teams, you need to restart it in order to see in your installed apps. 1. Select the **Apps** icon. Your sideloaded app appears among installed apps.-1. Select your app icon to launch your app in Microsoft 365 app for Android. +1. Select your app icon to launch your app in the Microsoft 365 app. :::image type="content" source="images/office-mobile-apps.png" alt-text="The screenshot is an example that shows the 'Apps' option on the side bar of the Microsoft 365 app to see your installed personal tabs."::: Provide feedback and report any issues with the Teams Toolkit debugging experien #### Mobile debugging -Teams Toolkit (`F5`) debugging isn't yet supported with Microsoft 365 app for Android. Here's how to remotely debug your app running in Microsoft 365 app for Android: +##### Debugging Outlook for Android ++To debug your app in Outlook for Android: ++1. Select the **More** icon in the Teams mobile client and open your sideloaded app to run within the Outlook app. +1. Ensure your Android device is connected to your dev machine. From your dev machine, open your browser to its DevTools inspection page. For example, go to `edge://inspect/#devices` in Microsoft Edge to display a list of debug-enabled Android WebViews. +1. Find the `Microsoft Teams Tab` with your tab URL and select **inspect** to start debugging your app with DevTools. ++ :::image type="content" source="images/office-android-debug.png" alt-text="The screenshot is an example that shows the list of webviews in devtool."::: ++1. Debug your tab app within the Android WebView. In the same way you [remotely debug](/microsoft-edge/devtools-guide-chromium/remote-debugging) a regular website on an Android device ++##### Debugging Microsoft 365 for Android ++Teams Toolkit (`F5`) debugging isn't yet supported with Microsoft 365 for Android app. Here's how to remotely debug your app running in Microsoft 365 for Android app: 1. If you debug using a physical Android device, connect it to your dev machine and enable the option for [USB debugging](https://developer.android.com/studio/debug/dev-options). This is enabled by default with the Android emulator. 1. Launch the Microsoft 365 app From your Android device. |
| platform | Overview | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/m365-apps/overview.md | The Teams app platform continues to evolve and expand holistically into the Micr | Teams app features| App manifest element | Teams support |Outlook support | Microsoft 365 app support | Notes | |--|--|--|--|--|--|-| [**Tabs-personal scope**](../tabs/how-to/create-personal-tab.md) |`staticTabs` | Web, Desktop, Mobile | Web (Targeted Release), Desktop (Beta Channel) | Web, Desktop, Mobile (Android)| Channel and group scope not yet supported for Microsoft 365. See [notes](../tabs/how-to/using-teams-client-sdk.md#microsoft-365-support-running-teams-apps-in-office-and-outlook). -| [**Message extensions-search-based**](../messaging-extensions/how-to/search-commands/define-search-command.md)| `composeExtensions` | Web, Desktop, Mobile| Web (Targeted release), Desktop (Beta Channel)| - |Action-based not yet supported for Microsoft 365. See [notes](extend-m365-teams-message-extension.md#troubleshooting). | +| [**Tabs-personal scope**](../tabs/how-to/create-personal-tab.md) |`staticTabs` | Web, Desktop, Mobile | Web (Targeted Release), Desktop (Beta Channel), Mobile (Android) | Web, Desktop, Mobile (Android)| Channel and group scope not yet supported for Microsoft 365. See [notes](../tabs/how-to/using-teams-client-sdk.md#microsoft-365-support-running-teams-apps-in-office-and-outlook). +| [**Message extensions-search-based**](../messaging-extensions/how-to/search-commands/define-search-command.md)| `composeExtensions` | Web, Desktop, Mobile| Web (Targeted Release), Desktop (Beta Channel)| - |Action-based not yet supported for Microsoft 365. See [notes](extend-m365-teams-message-extension.md#troubleshooting). | | link unfurling (including stage view) | `composeExtensions.messageHandlers` | Web, Desktop | Web (Targeted release), Desktop (Beta Channel) | - | See notes on [link unfurling](extend-m365-teams-message-extension.md#link-unfurling) and [stage view](extend-m365-teams-message-extension.md#stage-view)| | [**Office Add-ins**](/office/dev/add-ins/develop/json-manifest-overview) (preview) | `extensions` | - | Web, Desktop | - | Only available in [devPreview](../resources/schem) manifest version. See [notes](#office-add-ins-preview).| Reach your users where they are, right in the context of their work by extending :::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 app for Android](extend-m365-teams-personal-tab.md#microsoft-365-app-for-android). +On mobile, you can test and debug your Teams personal tab running on [Microsoft 365 for Android app](extend-m365-teams-personal-tab.md#microsoft-365-for-android-app) and [Outlook for Android app](extend-m365-teams-personal-tab.md#outlook-for-android-app). :::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."::: With an aim toward simplifying and streamlining the Microsoft 365 developer ecos ### Office Add-ins (preview) -You can now define and deploy Office Add-ins in the [developer preview version](../resources/schem) of the Microsoft Teams app manifest. Currently, this preview is limited to Outlook Add-ins running on subscription Microsoft 365 app for Windows. +You can now define and deploy Office Add-ins in the [developer preview version](../resources/schem) of the Microsoft Teams app manifest. Currently, this preview is limited to Outlook Add-ins running on subscription Microsoft 365 for Windows app. For more information, see [Teams manifest for Office Add-ins (preview)](/office/dev/add-ins/develop/json-manifest-overview). |
| platform | Prerequisites | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/m365-apps/prerequisites.md | To install Microsoft 365 Beta Channel applications in your test environment: ### Mobile -Install the Microsoft 365 app to preview your Teams personal tab app running your physical Android device or Android emulator: +#### Android ++Install the Microsoft 365 app to preview your Teams personal tab app running on your physical Android device or Android emulator: 1. Ensure you're using a Google Play [supported Android device](https://support.google.com/googleplay/answer/1727131). 1. Launch the **Play Store** on your Android device.-1. Search for "Office" and select **Office (Microsoft 365)**. +1. Search for a supported host for running Teams apps: + 1. For Microsoft 365 app (formerly Office), search office and select *Microsoft 365 app*. + 1. For Outlook, search outlook and select *Microsoft Outlook*. 1. Select the **Install** button. :::image type="content" source="images/office-android-install.png" alt-text="The screenshot is an example that shows the install button for the Office (Microsoft 365) app in Google Play Store."::: 1. Launch the Microsoft 365 app and sign in with your test tenant credentials. 1. Open your profile **(Me) > Settings** and scroll to the bottom of the menu.-1. Ensure you use Microsoft 365 app version 16.0.15726.20000 or higher for Android. +1. Ensure that you use Microsoft 365 app version 16.0.15726.20000 or later and Outlook app version 4.2247.1 (52247812) or later for Android. ++#### iOS ++You can preview Teams personal tabs running in Outlook and Microsoft 365 app for iOS by installing the prerelease version on the [TestFlight app](https://testflight.apple.com/) on your iOS device. ++1. To access the preview version on TestFlight, please reach out to the product group through your CSAM/Account Manager for an Invitation. +1. Install the TestFlight app from the **App Store** on your testing device of choice. +1. Open your email invitation, accept the email invitation, or follow the public link invitation to install the beta app. +1. Launch the Outlook app and sign in with your test tenant credentials. +1. Open your profile **(Me) > Settings** and scroll to the bottom of the menu. +1. Ensure that you use Microsoft 365 app version 2.72.23030700 or later and Outlook app version 4.2310.0 (18999702) or later for iOS. ## Install Visual Studio Code and Teams Toolkit extension |
| platform | Publish | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/m365-apps/publish.md | ms.localizationpriority: medium # Publish Teams apps for Microsoft 365 -Microsoft Teams supports Microsoft 365-enabled Teams apps for production. You can distribute these apps to users who use the *Targeted Release* (dev preview) versions of Outlook.com and microsoft365.com (formerly office.com), the *Beta Channel* build of Outlook for Windows desktop, and Microsoft 365 Current Channel (dev preview) build of Microsoft 365 app for Android. Distribution options and processes for Microsoft 365-enabled Teams apps are the same as for traditional Teams apps. +Microsoft Teams supports Microsoft 365-enabled Teams apps for production. You can distribute these apps to users who use the *Targeted Release* (dev preview) versions of Outlook.com and microsoft365.com (formerly office.com), the *Beta Channel* build of Outlook for Windows desktop, Outlook for Android, and Microsoft 365 Current Channel (dev preview) build of Microsoft 365 app for Android. Distribution options and processes for Microsoft 365-enabled Teams apps are the same as for traditional Teams apps. After it's published, your app will be discoverable as an installable app from the Outlook and Microsoft 365 app stores, in addition to the Teams store. Your app uses the permissions defined in Teams across Outlook and Microsoft 365. Teams admins can [manage access to Teams apps across Microsoft 365](/microsoftteams/manage-third-party-teams-apps) for users in their organization. |
| platform | Overview Explore | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/overview-explore.md | description: Microsoft Teams platform features for your app on desktop and mobil ms.localizationpriority: high Previously updated : 11/02/2021 Last updated : 04/16/2023 # Explore Teams platform features |
| platform | Overview Solution | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/overview-solution.md | description: Understand how to plan, design, build, extend to Microsoft 365, tes ms.localizationpriority: high Previously updated : 11/02/2021 Last updated : 04/16/2023 # The Teams solution |
| platform | Overview Story | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/overview-story.md | description: Learn how Microsoft Teams apps helps your users in the Teams enviro ms.localizationpriority: high Previously updated : 11/02/2021 Last updated : 04/16/2023 # From ideas to Teams app |
| platform | Overview | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/overview.md | description: Learn about Microsoft Teams, why should you build apps on Teams pla ms.localizationpriority: high Previously updated : 05/24/2021 Last updated : 04/02/2023 # Teams app that fits Here's why Teams is best-suited for your app needs: For example, if your app is a design tool with multiple collaborators, a shared bot that notifies all users helps to build user engagement. +- **Build once, run everywhere** ++ Use the latest app manifest and Teams JavaScript client library versions to enable your personal tab and message extension apps to run in other Microsoft 365 experiences in addition to Teams. You can reach users on platforms such as Outlook and Microsoft 365 app all with the same codebase, broadening the reach of your app and streamlining your development and distribution processes. + + ## Next step > [!div class="nextstepaction"] |
| platform | Bots Conv Channel | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bot-conversations/bots-conv-channel.md | Title: Channel and Group chat conversations with bots description: In this module, learn end-to-end scenario of having a conversation with a bot in a channel in Microsoft Teams ms.localizationpriority: medium Previously updated : 06/25/2019 Last updated : 04/02/2023 # Channel and Group chat conversations with a Microsoft Teams bot |
| platform | Bots Conv Personal | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bot-conversations/bots-conv-personal.md | Title: One-on-one conversations with bots description: In this module, learn end-to-end scenario of having a one-on-one conversation with a bot in Microsoft Teams ms.localizationpriority: medium Previously updated : 05/20/2019 Last updated : 04/02/2023 # Have a personal (one-on-one) conversation with a Microsoft Teams bot |
| platform | Bots Conv Proactive | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bot-conversations/bots-conv-proactive.md | Title: Proactive messaging for bots description: In this module, learn how to use proactive messaging for bots and best practices for proactive messaging in Microsoft Teams ms.localizationpriority: medium Last updated : 04/02/2023 # Proactive messaging for bots |
| platform | Bots Conversations | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bot-conversations/bots-conversations.md | description: In this module, learn to have a conversation with a Microsoft Teams ms.localizationpriority: medium Previously updated : 05/20/2019 Last updated : 04/02/2023 # Have a conversation with a Microsoft Teams bot |
| platform | Bots Cards | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-cards.md | Title: Using cards in bots description: With this learning path, get started with cards and how they're used in bot messages in the Microsoft Teams. ms.localizationpriority: medium Previously updated : 03/29/2018 Last updated : 04/02/2023 # Cards in bot conversations |
| platform | Bots Context | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-context.md | Title: Get context for your Microsoft Teams bot description: In this module, learn how to get context for bots in Microsoft Teams, fetch the team roster and user profile or roster in personal or group chat ms.localizationpriority: medium Previously updated : 05/20/2019 Last updated : 04/02/2023 # Get context for your Microsoft Teams bot |
| platform | Bots Create | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-create.md | Title: Create a bot description: In this module, learn how to create a bots using the Microsoft Bot Framework and ready to work in Microsoft Teams ms.localizationpriority: medium Previously updated : 12/07/2018 Last updated : 04/02/2023 # Create a bot |
| platform | Bots Files | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-files.md | description: Learn how to send and receive files through the bot using Graph API keywords: teams bots files send receive ms.localizationpriority: medium Previously updated : 05/20/2019 Last updated : 04/02/2023 # Send and receive files using bots |
| platform | Bots Menus | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-menus.md | Title: Add a bot menu description: In this module, learn how to add a bot menu in Microsoft Teams and create menus for bots in Microsoft Teams ms.localizationpriority: medium Previously updated : 05/20/2019 Last updated : 04/02/2023 # Add a bot menu in Microsoft Teams |
| platform | Bots Message Format | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-message-format.md | Title: Bot message format description: In this module, learn details of formatting for bot messages ms.localizationpriority: medium Previously updated : 05/20/2019 Last updated : 04/02/2023 # Message formatting for bots |
| platform | Bots Notification Only | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-notification-only.md | Title: Notification-only bots description: In this module, learn what notification-only bots are in Microsoft Teams, app manifest and its best practices and limitations ms.localizationpriority: medium Previously updated : 01/29/2020 Last updated : 04/02/2023 # Notification-only bots in Microsoft Teams |
| platform | Bots Notifications | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-notifications.md | Title: Handle bot events description: In this module, learn how to handle events in bots for Microsoft Teams, Teams member or bot addition, Team member or bot removed and more Previously updated : 05/20/2019 Last updated : 04/02/2023 ms.localizationpriority: medium |
| platform | Bots Overview | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-overview.md | Title: Add bots to Microsoft Teams apps description: In this module, learn how to get started developing bots in Microsoft Teams and what are all the requirements to add a bot in Teams ms.localizationpriority: medium Previously updated : 05/20/2018 Last updated : 04/02/2023 # Add bots to Microsoft Teams apps |
| platform | Bots Test | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-test.md | Title: Test and debug your bot description: In this article, you'll know how to test and debug your bots in Microsoft Teams and Test your bot without uploading to Teams ms.localizationpriority: medium Previously updated : 03/20/2019 Last updated : 04/02/2023 # Test and debug your Microsoft Teams bot |
| platform | Bots Text Formats | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-text-formats.md | Title: Supported text formatting in conversations description: In this module, learn text formatting support in bot conversations and formatting text content in Microsoft Teams ms.localizationpriority: medium Previously updated : 03/29/2018 Last updated : 04/02/2023 # Formatting bot messages |
| platform | Bots With Tabs | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-with-tabs.md | Title: Combine bots with tabs description: In this article, you'll learn how to use tabs and bots together, constructing deep links to tabs in messages from your bot, and teams bots tabs development ms.localizationpriority: medium Previously updated : 03/15/2018 Last updated : 04/02/2023 # Combine bots with tabs |
| platform | Create Extensions | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/messaging-extension-v3/create-extensions.md | Title: Initiate actions with message extensions description: In this module, learn create Action-based message extensions to allow users to trigger external services. ms.localizationpriority: medium Last updated : 04/02/2023 # Initiate actions with message extensions |
| platform | Messaging Extensions Overview | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/messaging-extension-v3/messaging-extensions-overview.md | Title: Develop message extensions description: In this module, learn how to get started with message extensions in Microsoft Teams ms.localizationpriority: medium Last updated : 04/02/2023 # Develop message extensions for Microsoft Teams How would you use message extensions? Here are a few possibilities: ## Types of message extensions -There's primarily two kinds of message extensions you can create for Teams today. The following topics will guide you through the process of creating them: +There's primarily two kinds of message extensions you can create for Teams today. The following topics guide you through the process of creating them: -* [Search based message extensions](~/resources/messaging-extension-v3/search-extensions.md): Query your service for information and insert that into a message. Example: Lookup a work item -* [Action-based message extensions](~/resources/messaging-extension-v3/create-extensions.md): Collect information from the user and post to a 3rd party service. Example: Create a work item +* [Search based message extensions](~/resources/messaging-extension-v3/search-extensions.md): Query your service for information and insert that into a message. Example: Look up a work item +* [Action-based message extensions](~/resources/messaging-extension-v3/create-extensions.md): Collect information from the user and post to a third party service. Example: Create a work item |
| platform | Search Extensions | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/messaging-extension-v3/search-extensions.md | Title: Search with message extensions -description: In this article, you'll learn how to develop search based message extensions +description: In this article, you learn how to develop search based message extensions ms.localizationpriority: medium Previously updated : 07/20/2019 Last updated : 04/02/2023 # Search with message extensions A message extension receives an `onQuery` event when anything happens in the mes If your message extension uses a configuration page, your handler for `onQuery` should first check for any stored configuration information; if the message extension isn't configured, return a `config` response with a link to your configuration page. The response from the configuration page is also handled by `onQuery`. The sole exception is when the configuration page is called by the handler for `onQuerySettingsUrl`; see the following section: -If your message extension requires authentication, check the user state information. If the user isn't signed in, follow the instructions in the [Authentication](#authentication) section later in this topic. +If your message extension requires authentication, check the user state information. If the user isn't signed in, follow the instructions in the [Authentication](#authentication) section later in this article. Next, check whether `initialRun` is set; if so, take appropriate action, such as providing instructions or a list of responses. As an alternative (or in addition) to searching your external service, you can u :::image type="content" source="../../assets/images/compose-extensions/messagingExtensions_LinkUnfurling.png" alt-text="Screenshot shows the example of link unfurling."::: -To enable your message extension to interact with links this way, you'll first need to add the `messageHandlers` array to your app manifest as in the example below: +To enable your message extension to interact with links this way, you first need to add the `messageHandlers` array to your app manifest as in the example: ```json "composeExtensions": [ To enable your message extension to interact with links this way, you'll first n ] ``` -Once you've added the domain to listen on to the app manifest, you'll need to change your bot code to [respond](#respond-to-user-requests) to the below invoke request. +Once you've added the domain to listen on to the app manifest, you need to change your bot code to [respond](#respond-to-user-requests) to the below invoke request. ```json { If your app returns multiple items, only the first will be used. ### Respond to user requests -When the user performs a query, Teams issues a synchronous HTTP request to your service. During this time, your code has 5 seconds to provide an HTTP response to the request. During this time, your service can perform additional lookup, or any other business logic needed to serve the request. +When the user performs a query, Teams issues a synchronous HTTP request to your service. During this time, your code has 5 seconds to provide an HTTP response to the request. During this time, your service can perform another lookup, or any other business logic needed to serve the request. Your service should respond with the results matching the user query. The response must indicate an HTTP status code of `200 OK` and a valid application/json object with the following body: For more information, see [Cards](~/task-modules-and-cards/what-are-cards.md) fo To learn how to use the thumbnail and hero card types, see [Add cards and card actions](~/task-modules-and-cards/cards/cards-actions.md). -For additional documentation regarding the connector card for Microsoft 365 Groups, see [Using connector card for Microsoft 365 Groups](~/task-modules-and-cards/cards/cards-reference.md#connector-card-for-microsoft-365-groups). +For more information regarding the connector card for Microsoft 365 Groups, see [Using connector card for Microsoft 365 Groups](~/task-modules-and-cards/cards/cards-reference.md#connector-card-for-microsoft-365-groups). The result list is displayed in the Microsoft Teams UI with a preview of each item. The preview is generated in one of two ways: * Using the `preview` property within the `attachment` object. The `preview` attachment can only be a Hero or Thumbnail card. * Extracted from the basic `title`, `text`, and `image` properties of the attachment. These are used only if the `preview` property isn't set and these properties are available. -You can display a preview of an Adaptive or connector card for Microsoft 365 Groups in the result list simply by setting its preview property. This isn't necessary if the results are already hero or thumbnail cards. If you use the preview attachment, it must be either a Hero or Thumbnail card. If no preview property is specified, the preview of the card will fail, and nothing will be displayed. +You can display a preview of an Adaptive or connector card for Microsoft 365 Groups in the result list simply by setting its preview property. This isn't necessary if the results are already hero or thumbnail cards. If you use the preview attachment, it must be either a Hero or Thumbnail card. If no preview property is specified, the preview of the card fails, and nothing is displayed. #### Response example When the sign in request completes and redirects back to your page, it should pe 1. Generate a security code. (This can be a random number.) You need to cache this code on your service, along with the credentials obtained through sign in such as, OAuth 2.0 tokens. 2. Call `microsoftTeams.authentication.notifySuccess` and pass the security code. -At this point, the window closes and control is passed to the Teams client. The client can now reissue the original user query, along with the security code in the `state` property. Your code can use the security code to look up the credentials stored earlier to complete the authentication sequence and then complete the user request. +At this point, the window closes and control are passed to the Teams client. The client can now reissue the original user query, along with the security code in the `state` property. Your code can use the security code to look up the credentials stored earlier to complete the authentication sequence and then complete the user request. #### Reissued request example |
| platform | Integrating Web Apps | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/samples/integrating-web-apps.md | description: Learn best practices or considerations for integrating existing web apps with Microsoft Teams. It gives information on API requirements, authentication, and deep-linking of your app with Teams. Previously updated : 08/26/2020 Last updated : 04/02/2023 ms.localizationpriority: medium Title: Considerations for Teams integration Your Teams app must include required and expected collaborative features. To wor |Common app features |Teams platform capabilities | |-|--|-|Embedded webpage, homepage, or webview |[Tabs](../tabs/what-are-tabs.md) | -|Share shortcuts and extensions |[Message extensions](../messaging-extensions/what-are-messaging-extensions.md) | +|Embedded webpage, homepage, or webview |[Tabs](../tabs/what-are-tabs.md)<br/> [Tabs extended across Microsoft 365](../m365-apps/overview.md) | +|Share shortcuts and extensions |[Message extensions](../messaging-extensions/what-are-messaging-extensions.md)<br/>[Message extensions for Outlook](../m365-apps/overview.md) | |Action shortcuts and extensions |[Message extensions](../messaging-extensions/what-are-messaging-extensions.md) | |Chatbots |[Bots](../bots/what-are-bots.md) | |Channel notifications |[Bots](../bots/what-are-bots.md)<br/>[Incoming Webhooks](../webhooks-and-connectors/what-are-webhooks-and-connectors.md)<br/>[connectors for Microsoft 365 Groups](../webhooks-and-connectors/what-are-webhooks-and-connectors.md) | |
| platform | Using Teams Client Library | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/using-teams-client-library.md | The following table lists Teams tabs and dialogs (task modules) capabilities (pu |Capability | Host support | Notes | |--|--|-|-| app | Teams, Outlook, Microsoft 365, Microsoft 365 app for Android | Namespace representing app initialization and lifecycle. | +| app | Teams, Outlook, Outlook app for Android, Microsoft 365, Microsoft 365 app for Android | Namespace representing app initialization and lifecycle. | | appInitialization| | Deprecated. Replaced by `app` namespace. | | appInstallDialog | Teams, Microsoft 365 ||-| authentication | Teams, Outlook, Microsoft 365, Microsoft 365 app for Android | | +| authentication | Teams, Outlook, Outlook app for Android, Microsoft 365, Microsoft 365 app for Android | | | calendar | Outlook (Windows desktop only) || | call | Teams|| | chat |Teams|| The following table lists Teams tabs and dialogs (task modules) capabilities (pu | media |Teams| See notes on [App permissions](#app-permissions).| | menus | Teams || | monetization | Teams ||-| pages | Teams, Outlook, Microsoft 365, Microsoft 365 app for Android | Namespace representing page navigation. See notes on [Deep linking](#deep-linking). | +| pages | Teams, Outlook, Outlook app for Android, Microsoft 365, Microsoft 365 app for Android | Namespace representing page navigation. See notes on [Deep linking](#deep-linking). | | people |Teams|| | profile | || | search | || |
| platform | Teamsfx SDK | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/TeamsFx-SDK.md | description: In this module, learn about TeamsFx SDK, core concepts and code str ms.localizationpriority: medium Previously updated : 11/29/2021 Last updated : 04/16/2023 # TeamsFx SDK |
| platform | Connectors Creating | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/webhooks-and-connectors/how-to/connectors-creating.md | |