Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
54 commits
Select commit Hold shift + click to select a range
ec23da5
Update get-started-overview.md
v-shalinirob Nov 19, 2025
223eb34
Update get-started-overview.md
v-shalinirob Nov 19, 2025
d998f5c
Update get-started-overview.md
v-shalinirob Nov 19, 2025
fec3a58
Update get-started-overview.md
v-shalinirob Nov 19, 2025
f4c2613
Updates
v-shalinirob Nov 19, 2025
6312a92
Update get-started-overview.md
v-shalinirob Nov 19, 2025
ac6b4ec
Merge branch 'main' into app-in-teams-overview
v-shalinirob Nov 20, 2025
c2ebf5a
Update get-started-overview.md
v-shalinirob Nov 20, 2025
e2e6a81
Update get-started-overview.md
v-shalinirob Nov 20, 2025
201c796
Update get-started-overview.md
v-shalinirob Nov 20, 2025
5b44faa
Update get-started-overview.md
v-shalinirob Nov 20, 2025
4e1da73
Update get-started-overview.md
v-shalinirob Nov 20, 2025
626b5b9
Update get-started-overview.md
v-shalinirob Nov 20, 2025
9d7174f
Update get-started-overview.md
v-shalinirob Nov 20, 2025
d2e4c2b
Update get-started-overview.md
v-shalinirob Nov 20, 2025
df07f7c
Update get-started-overview.md
v-shalinirob Nov 20, 2025
fae3ad7
Update get-started-overview.md
v-shalinirob Nov 20, 2025
8b0ded1
Update get-started-overview.md
v-shalinirob Nov 20, 2025
b4f7ac7
Update get-started-overview.md
v-shalinirob Nov 20, 2025
1674675
Update get-started-overview.md
v-shalinirob Nov 20, 2025
407d6b2
Updates
v-shalinirob Nov 20, 2025
cb015e1
Merge branch 'main' into app-in-teams-overview
v-shalinirob Nov 24, 2025
bed0ab8
Update teams-apps-types.png
v-shalinirob Nov 24, 2025
a7a234c
Update get-started-overview.md
v-shalinirob Nov 24, 2025
3a33a76
Update teams-apps-types.png
v-shalinirob Nov 24, 2025
fc983e0
Update get-started-overview.md
v-shalinirob Nov 24, 2025
1b60ae4
Image test
v-shalinirob Nov 24, 2025
f84080d
Update get-started-overview.md
v-shalinirob Nov 24, 2025
e656ae0
Image test
v-shalinirob Nov 24, 2025
fab3eb1
Update get-started-overview.md
v-shalinirob Nov 24, 2025
c8cc316
Image WIP
v-shalinirob Nov 24, 2025
8297470
Update teams-apps-types.png
v-shalinirob Nov 26, 2025
84945ed
Update teams-apps-types.png
v-shalinirob Nov 26, 2025
e81cc99
Update get-started-overview.md
v-shalinirob Nov 26, 2025
960c5cb
Update get-started-overview.md
v-shalinirob Nov 26, 2025
822b55f
Update get-started-overview.md
v-shalinirob Nov 26, 2025
b57c823
Merge branch 'main' into app-in-teams-overview
v-shalinirob Nov 27, 2025
c318ac6
Merge branch 'main' into app-in-teams-overview
v-shalinirob Nov 28, 2025
88a5c06
Update get-started-overview.md
v-shalinirob Nov 28, 2025
1a39aa7
Update get-started-overview.md
v-shalinirob Nov 28, 2025
00eab06
Update get-started-overview.md
v-shalinirob Nov 28, 2025
60a3b61
Update get-started-overview.md
v-shalinirob Nov 28, 2025
e0fcae3
Update get-started-overview.md
v-shalinirob Nov 28, 2025
3c6754c
Update get-started-overview.md
v-shalinirob Nov 28, 2025
e0b6525
Update get-started-overview.md
v-shalinirob Nov 28, 2025
93d7253
Update get-started-overview.md
v-shalinirob Nov 28, 2025
75fb151
Update get-started-overview.md
v-shalinirob Nov 28, 2025
f074870
Update get-started-overview.md
v-shalinirob Nov 28, 2025
3d68310
Update get-started-overview.md
v-shalinirob Nov 28, 2025
5ccdf59
Update get-started-overview.md
v-shalinirob Nov 28, 2025
e7a622f
Update get-started-overview.md
v-shalinirob Nov 28, 2025
ff6ca01
Merge branch 'main' into app-in-teams-overview
v-shalinirob Dec 3, 2025
e2704a9
Update get-started-overview.md
v-shalinirob Dec 3, 2025
6fa0dca
Update get-started-overview.md
v-shalinirob Dec 3, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
96 changes: 61 additions & 35 deletions msteams-platform/get-started/get-started-overview.md
Original file line number Diff line number Diff line change
@@ -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)