diff --git a/msteams-platform/assets/images/overview/teams-apps-types.png b/msteams-platform/assets/images/overview/teams-apps-types.png new file mode 100644 index 00000000000..ec3ef5a6c55 Binary files /dev/null and b/msteams-platform/assets/images/overview/teams-apps-types.png differ diff --git a/msteams-platform/get-started/get-started-overview.md b/msteams-platform/get-started/get-started-overview.md index 74ca08f3916..ed19e40b895 100644 --- a/msteams-platform/get-started/get-started-overview.md +++ b/msteams-platform/get-started/get-started-overview.md @@ -1,67 +1,93 @@ --- title: Get Started - Overview -description: Learn how to create your first Microsoft Teams app based on language and development environments, understand app capabilities, and SDKs. +description: Learn about Microsoft Teams app capabilities. ms.localizationpriority: high -ms.date: 02/06/2025 +ms.date: 11/28/2025 ms.topic: reference --- # Apps in Teams -Get started with building apps for Microsoft Teams and beyond! +Teams apps are custom solutions designed to enhance collaboration and productivity within Microsoft Teams. They use the platform’s extensibility to deliver interactive experiences directly inside chats, channels, and meetings. -Use GitHub Codespaces or walk through the step-by-step guide to build a basic, real-world Teams app. This module introduces you to common tools, fundamental concepts, and more advanced functionalities. +:::image type="content" source="../assets/images/overview/teams-apps-types.png" alt-text="Image shows types of Teams app." border="false"::: -Here's an idea of what you'll learn +Build apps for Teams platform and cross-hub agent scenarios to connect with enterprise data, coordinate multi-agent workflows, while keeping interactions secure. Whether you’re creating a Teams-first solution or expanding across Microsoft 365, Teams apps give you a flexible, powerful way to deliver real impact within the Microsoft ecosystem. -* Get started quickly with Microsoft 365 Agents Toolkit (previously known as Teams Toolkit). -* Build tab, scenario-based apps, and message extension with GitHub Codespaces or step-by-step guide. -* Learn about tutorials and code samples available for building your Teams app. -* Learn about various tools and SDKs available for building your Teams app. +Teams platform provides a wide range of app features, including bots, tabs, and message extensions. Explore agents for Teams that take advantage of these capabilities and beyond. -## Build your first Teams app +> [!div class="nextstepaction"] +> [Get started with building agents in Teams](../agents-in-teams/overview.md) -In this section, learn how to build a Teams app with different capabilities, such as tab, scenario-based bot app, and message extension. +Here's an idea of what you'll learn in this article: -1. Select the type of Teams app that you want to build: +- The types of apps and agents that you can build for Teams: + - Try building a tab, bot, and message extension app using step-by-step guides. + - Learn about tutorials and code samples available for building your Teams app. +- Learn about various tools and SDKs available for building Teams app capabilities. - * **Build a basic Teams tab app**: Get started with building a Teams app with a basic tab app. +## Why build apps for Microsoft Teams? - * **Build a scenario-based Teams bot app**: Build a Teams app that is suitable for a particular scenario or use-case. For example, a notification bot is suitable for sending notifications but not to chat. +Teams app capabilities enable collaborative workspaces with apps for Microsoft Teams platform. You can bring people, data, and workflows together in one place. With over 320 million users, Teams isn’t just for chats and meetings. It’s a hub to simplify processes and keep key information readily accessible. Develop custom apps or integrate existing solutions into Teams to: - * **Build message extension Teams app**: Build a search-based message extension Teams app. +- **Boost productivity**: Bring all your essential tools, data, and business processes in one place. It enables app users to switch quickly between apps and achieve more. +- **Enhance collaboration**: Enable teams to communicate, share insights, and work together whether through bots, tabs, message extensions, or meeting apps. +- **Personalize experiences**: Tailor solutions to your organization’s unique needs, from simple task lists to complex project management or helpdesk apps. +- **Automate and streamline**: Use apps to handle repetitive tasks, approvals, and notifications, optimizing app user’s time. +- **Reach users everywhere**: Teams apps work across desktop, web, and mobile. It ensures your solutions are accessible to app users. -2. Choose your path to build your selected app. +Teams app capabilities help organizations modernize communication and foster engagement. The platform delivers seamless, secure, and relevant experiences. - * **GitHub Codespaces**: Allows you to run, test, and debug your app in a development environment without the need for any extra setup. - * **Step-by-step guide**: Allows you to create a Teams app from the ground up including setting up your development environment. +## What capabilities can you build in Teams? - :::image type="content" border="false" source="../assets/images/get-started/codescpaces-vs-manual.png" alt-text="Your choices to build a Teams app with codespaces and step-by-step guide."lightbox="../assets/images/get-started/codescpaces-vs-manual.png"::: +Teams platform supports the following app types: -## Next step +- **Tabs**: -If you want to build a basic tab app, select the following: + Tabs are web experiences (hosted pages) that run inside Teams. Use them for dashboards, forms, or full fidelity web apps embedded in a chat, channel, or meeting. You can also extend tabs to Outlook and Microsoft 365. -> [!div class="nextstepaction"] -> [Build your basic tab app](build-basic-tab-app.md) +- **Bots**: -If a bot is what you're interested in, select the following: + In Teams, bots evolved into agents, which are AI-enhanced, conversational apps that respond in 1:1, group, channel, or meeting contexts. Bot apps answer questions, summarize discussions, automate tasks, and participate in meetings such as sending agenda updates or capturing action items. -> [!div class="nextstepaction"] -> [Start building a bot](build-notification-bot.md) +- **Message extensions**: -If you want to build a message extension app, select the following: + Message extensions bring search and action commands to the compose box and contextual menus. They call into your service and return cards that users can insert into a message, or launch dialogs to complete short workflows. -> [!div class="nextstepaction"] -> [Build message extension](build-message-extension.md) +- **Meeting apps**: -If you want to build a declarative agent, select the following: + Meeting apps add configurable tabs and bot capabilities to the meeting surface. You can react to meeting lifecycle events (start to end), notify participants, and provide in-meeting UI for notes, tasks, and workflows. -> [!div class="nextstepaction"] -> [Build declarative agent](/microsoft-365-copilot/extensibility/build-declarative-agents?tabs=ttk) +## SDKs and tools + +Here's a list of SDKs and tools that you can use to build app capabilities: + +- Teams SDK (previously known as Teams AI library) + + The Teams SDK offers streamlined client APIs of TeamsJS v2 capabilities for tabs and meeting surfaces, plus language SDKs for building conversational agents (with streaming, Adaptive Cards, dialogs, and more). + +- Microsoft 365 Agents SDK (multi hub, pro code agents) + + The Microsoft 365 Agents SDK lets you build agents and apps that you can publish to Microsoft 365 Copilot and other endpoints and that can interoperate with Teams. It's designed for agents that work across hubs and collaborate with other agents (Agents to Agents (A2A)) and tools (Model Context Protocol (MCP)). + +- Microsoft 365 Agents Toolkit (developer workflow and scaffolding) + + The Microsoft 365 Agents Toolkit (evolution of Teams Toolkit) provides VS Code and CLI templates, local debugging, resource provisioning, and testing against Teams or Copilot. The toolkit is a quick way to scaffold tabs, message extensions, and agents, then deploy using Azure defaults. + +## Build your first Teams app + +In this section, learn how to build a Teams app with different capabilities, such as bot, tab, and message extension. Select the type of Teams app that you want to build: + +- [Build a Teams bot app](build-notification-bot.md) +- [Build a basic Teams tab app](build-basic-tab-app.md) +- [Build message extension Teams app](build-message-extension.md) + +After you build the basic app capabilities, [explore tutorials and code samples](tool-options-and-code-samples.md). + +Get started with building apps for Microsoft Teams and beyond! ## See also -* [Microsoft Teams samples](https://github.com/OfficeDev/Microsoft-Teams-Samples#microsoft-teams-samples) -* [Git and GitHub resources](/contribute/additional-resources) -* [Teams app tutorials and code samples](tool-options-and-code-samples.md) +- [Microsoft Teams samples](https://github.com/OfficeDev/Microsoft-Teams-Samples#microsoft-teams-samples) +- [Git and GitHub resources](/contribute/additional-resources) +- [Teams app tutorials and code samples](tool-options-and-code-samples.md)