| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| platform | Bot Basics | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/bot-basics.md | Title: Bot activity handlers -description: In this article, learn about bot activity handlers, frameworks, Teams activity handlers and bot logic in Microsoft Teams. +description: Learn about Microsoft Teams events and activity handlers for messages, channels, teams, members, mentions, auth, card actions using Microsoft Bot Framework SDK. ms.localizationpriority: medium |
| platform | Bot Features | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/bot-features.md | Title: Bots and SDKs -description: In this article, learn tools and SDKs for building Microsoft Teams bots and Bots with the Microsoft Bot Framework. +description: In this article, learn about tools and Bot Framework SDKs(C#,Python,Java,JavaScript) for Microsoft Teams bots and it's advantages and disadvantages. ms.localizationpriority: medium |
| platform | Channel Messages With Rsc | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/conversations/channel-messages-with-rsc.md | Title: Receive all channel messages with RSC -description: In this module, learn how to receive all channel messages with RSC permissions and how to enable bots to receive all channel messages +description: Enable bots to receive all channel messages without being @mentioned using RSC permissions. Read on webApplicationInfo or authorization section in manifest. ms.localizationpriority: medium |
| platform | Conversation Basics | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/conversations/conversation-basics.md | Title: Conversation basics -description: In this module, learn bot conversations in a channel, personal chat, and a group chat environment in Teams. +description: In this module, learn about bot conversation type in a channel, personal chat, and a group chat scopes in Microsoft Teams. ms.localizationpriority: medium |
| platform | Conversation Messages | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/conversations/conversation-messages.md | Title: Messages in bot conversations -description: Learn the ways to have a conversation with a Teams bot and Teams channel data, notification to your message, picture messages, adaptive cards using Code samples +description: Learn how to send recieve a message, suggested actions, notification, attachments, images, Adaptive Cards, status error code responses for Throttle. ms.localizationpriority: medium |
| platform | Send Proactive Messages | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/conversations/send-proactive-messages.md | The following table provides a simple code sample that incorporates basic conver | Teams Conversation Basics | Demonstrates basics of conversations in Teams, including sending one-to-one proactive messages.| [View](https://github.com/microsoft/BotBuilder-Samples/blob/master/samples/csharp_dotnetcore/57.teams-conversation-bot) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/javascript_nodejs/57.teams-conversation-bot) | [View](https://github.com/microsoft/BotBuilder-Samples/blob/master/samples/python/57.teams-conversation-bot) | | Start new thread in a channel | Demonstrates creating a new thread in a channel. | [View](https://github.com/microsoft/BotBuilder-Samples/blob/master/samples/csharp_dotnetcore/58.teams-start-new-thread-in-channel) | [View](https://github.com/microsoft/BotBuilder-Samples/blob/master/samples/javascript_nodejs/58.teams-start-new-thread-in-channel) | [View](https://github.com/microsoft/BotBuilder-Samples/blob/master/samples/python/58.teams-start-thread-in-channel) | | Proactive installation of app and sending proactive notifications | This sample shows how you can use proactive installation of app for users and send proactive notifications by calling Microsoft Graph APIs. | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-proactive-installation/csharp) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-proactive-installation/nodejs) | |+| Proactive Messaging | This is a sample which shows how to save user's conversation reference information to send proactive reminder message using Bots. | Coming soon | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-proactive-messaging-teamsfx) | - | ### Additional code sample The following table provides a simple code sample that incorporates basic conver ## Step-by-step guide -Follow the [step-by-step guide](../../../sbs-send-proactive.yml), which helps you to send a proactive message from a bot. +Follow the step-by-step guide to [Build notification bot with JavaScript](../../../sbs-gs-notificationbot.yml), which helps you to send a proactive message from a bot. ## Next step Follow the [step-by-step guide](../../../sbs-send-proactive.yml), which helps yo * [Channel and group chat conversations with a bot](~/bots/how-to/conversations/channel-and-group-conversations.md) * [Respond to the task module submit action](~/messaging-extensions/how-to/action-commands/respond-to-task-module-submit.md) * [Send proactive notifications to users](/azure/bot-service/bot-builder-howto-proactive-message)+* [Build your first bot app using JavaScript](../../../sbs-gs-bot.yml) +* [Build notification bot with JavaScript](../../../sbs-gs-notificationbot.yml) |
| platform | Create A Bot Commands Menu | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/create-a-bot-commands-menu.md | +> [!NOTE] +> It's recommended that you'd create a command bot by following the step-by-step guide to [Build command bot with JavaScript](../../sbs-gs-commandbot.yml) using the new generation development tool for Teams. For more information about Teams Toolkit, see [Teams Toolkit Overview for Visual Studio Code](../../toolkit/teams-toolkit-fundamentals.md) and [Teams Toolkit overview for Visual Studio](../../toolkit/teams-toolkit-overview-visual-studio.md). + [!INCLUDE [pre-release-label](~/includes/v4-to-v3-pointer-bots.md)] To define a set of core commands that your bot can respond to, you can add a command menu with a drop-down list of commands for your bot. The list of commands is presented to the users in the compose message area when they are in conversation with your bot. Select a command from the list to insert the command string into the compose message box and select **Send**. |
| platform | What Are Bots | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/what-are-bots.md | Title: Bots in Microsoft Teams -description: With this learning path, get started with conversational bots in Microsoft Teams and it's code samples. +description: In this article, use conversational bots in Microsoft Teams to share files, send proactive nofication, interactive cards, make calls, invoke bot command, IVR. ms.localizationpriority: high # Build bots for Teams +> [!NOTE] +> It's recommended that you'd create your first bot app or notification bot app using the new generation development tool for Teams. For more information, see [Teams Toolkit for Visual Studio Code](../toolkit/teams-toolkit-fundamentals.md) and [Teams Toolkit for Visual Studio](../toolkit/teams-toolkit-overview-visual-studio.md). + A bot is also referred to as a chatbot or conversational bot. It is an app that runs simple and repetitive tasks by users such as customer service or support staff. Everyday use of bots include, bots that provide information about the weather, make dinner reservations, or provide travel information. Interactions with bots can be quick questions and answers or complex conversations. > [!IMPORTANT] You can use the Teams bot APIs to get information for members of a chat or team. |Sample name | Description | C# | Node.js | |-|--|--|--| | Bot daily task reminder| Demonstrate how to schedule a recurring task and get a reminder at a scheduled time. | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-daily-task-reminder/csharp) | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/bot-daily-task-reminder/nodejs) |+| Hello World Bot | This is a simple hello world application with both Bot and Message extension capabilities. | | [View](https://github.com/OfficeDev/TeamsFx-Samples/tree/v1.0.0/hello-world-bot) | +| Adaptive Card Notification | This is a sample which shows how to send notifications with different adaptive cards using Bots. | | [View](https://github.com/OfficeDev/TeamsFx-Samples/tree/v1.0.0/adaptive-card-notification) | +| Incoming Webhook Notification | This is a sample which shows how to send notifications via Incoming Webhook in Microsoft Teams channels. | | [View](https://github.com/OfficeDev/TeamsFx-Samples/tree/v1.0.0/incoming-webhook-notification) | ## See also You can use the Teams bot APIs to get information for members of a chat or team. * [Add authentication to your Teams bot](~/bots/how-to/authentication/add-authentication.md) * [Bot activity handlers](~/bots/bot-basics.md) * [Conversation events in your Teams bot](~/bots/how-to/conversations/subscribe-to-conversation-events.md)+* [Build your first bot app using JavaScript](../sbs-gs-bot.yml) +* [Build notification bot with JavaScript](../sbs-gs-notificationbot.yml) |
| platform | Glossary | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/get-started/glossary.md | Common terms and definitions used in Teams developer documentation. | [Capability](../toolkit/add-capability.md) | A Teams feature you can build into your app for interacting with app users. An app capability is used to extend Teams to fit your app needs. An app may have one or more core capabilities, such as tab, bot, and message extension. <br>**See also**: [Device capability](#d); [Media capability](#m) | | [Chat bot](../bots/how-to/conversations/conversation-basics.md) | A bot is also referred to as a chatbot or conversational bot. It's an app that runs simple and repetitive tasks for users such as customer service or support staff. <br> **See also**: [Conversational bot](#c) | | Channel | A single place for a team to share messages, tools, and files. You can use a channel for teamwork and communication. <br>**See also**: [Conversation](#c) |-| [Client secret](../bots/how-to/authentication/add-authentication.md) | The Client secret/password or a public or private key pair that is Certificate. It isn't required for native apps. <br> **See also**: [Bot](#b) | +| [Client secret](../bots/how-to/authentication/add-authentication.md) | A secret string that the application uses to prove its identity when requesting a token. Also, it can be referred to as application password.| | [Cloud resources](../toolkit/add-resource.md) | A service that is available on cloud through internet that your Teams app can use. It could be storage accounts, web apps, databases, and more. | | [Collaboration app](../concepts/extensibility-points.md) | An app with capabilities for a user to work in a collaborative workspace with other users. <br> **See also**: [Standalone app](#s) | | [Compose Extension](../resources/schem#composeextensions) | A property in app manifest (`composeExtensions`) that refers to message extension capability. It's used when your extension needs to either authenticate or configure to continue. <br>**See also**: [App manifest](#a); [Message extension](#m) | Common terms and definitions used in Teams developer documentation. | Term | Definition | | | | | [Deep linking](../concepts/build-and-test/deep-links.md) | In a Teams app, you can create deep links to information and features within Teams or to help the user navigate to content in your app. |+|[Department of Defense (DoD)](../concepts/app-fundamentals-overview.md#government-community-cloud)| DoD environments deliver compliance with Department of Defense Security Requirements Guidelines, Defense Federal Acquisition Regulations Supplement (DFARS), and International Traffic in Arms Regulations (ITAR).| | [Developer Portal for Teams](../concepts/build-and-test/teams-developer-portal.md) | The primary tool for configuring, distributing, and managing your Microsoft Teams apps. With Developer Portal, you can collaborate with colleagues on your app, set up runtime environments, and much more. | | [Developer Preview](../resources/dev-preview/developer-preview-intro.md) | A public program for developers that provides early access to unreleased features in Microsoft Teams. It lets you explore and test upcoming features for potential inclusion in your Microsoft Teams app. | | Deploy | A process to upload the backend and frontend code for the application. At Deployment, the code for your app is copied to the resources you created during provisioning. <br>**See also**: [Provision](#p) | Common terms and definitions used in Teams developer documentation. | Term | Definition | | | | | [Federated user](../apps-in-teams-meetings/meeting-app-extensibility.md#user-types-in-a-meeting) | A type of user in a Teams app meeting who is external and is invited to the meeting. This user has valid credentials that are federated by authorized Teams partners. They're also called External users. <br>**See also**: [Anonymous user](#a) |+| [First-run Experience](../concepts/design/design-teams-app-ui-templates.md)|A First-run Experience (FRE) is a user's introduction to your product.The FRE helps users to get started with the functions, features, and benefits of the product and influences users' to come back and continue using your product.| ## G | Term | Definition | | | |+|[Government community cloud (GCC)](../concepts/app-fundamentals-overview.md#government-community-cloud)| GCC environment provides compliance with federal requirements for cloud services, including FedRAMP High, Defense Federal Acquisition Regulations Supplement (DFARS), and requirements for criminal justice and federal tax information systems (CJI and FTI data types).| +|[Government community cloud (GCC) High](../concepts/app-fundamentals-overview.md#government-community-cloud)|GCC high environments deliver compliance with Department of Defense (DoD) Security Requirements Guidelines, Defense Federal Acquisition Regulations Supplement (DFARS), and International Traffic in Arms Regulations (ITAR).<br>**See also**: [Department of Defense (DoD)](#d)| | [Graph API](../graph-api/proactive-bots-and-messages/graph-proactive-bots-and-messages.md) | A RESTful web API for Microsoft Graph that enables you to access Microsoft Cloud service resources. <br>**See also**: [Microsoft Graph Explorer](#m) | | [Group chat](../resources/bot-v3/bot-conversations/bots-conversations.md) | A chat feature where a user is able to chat with a bot in a group setting by using @mention to invoke the bot. <br>**See also**: [One-on-one chat](#o); [Chat bot](#c) | |
| platform | V4 To V3 Pointer Bots | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/includes/v4-to-v3-pointer-bots.md | > [!Important] -> The code samples in this section are based on version 4.6 and later versions of the Bot Framework SDK. If you are looking for documentation for earlier versions, see the [bots - v3 SDK](~/resources/bot-v3/bots-overview.md) section in the Resources folder of the documentation. +> The code samples in this section are based on version 4.6 and later versions of the Bot Framework SDK. If you are looking for documentation for earlier versions, see the [bots - v3 SDK](~/resources/bot-v3/bots-overview.md) section in the Legacy SDKs folder of the documentation. |
| platform | Extend M365 Teams Personal Tab | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/m365-apps/extend-m365-teams-personal-tab.md | Provide feedback and report any issues with the Teams Toolkit debugging experien | Todo List | Editable todo list with SSO built with React and Azure Functions. Works only in Teams (use this sample app to try the upgrade process described in this tutorial). | [View](https://github.com/OfficeDev/TeamsFx-Samples/tree/ga/todo-list-with-Azure-backend) | | Todo List (Microsoft 365) | Editable todo list with SSO built with React and Azure Functions. Works in Teams, Outlook, Office. | [View](https://github.com/OfficeDev/TeamsFx-Samples/tree/ga/todo-list-with-Azure-backend-M365)| | Image Editor (Microsoft 365) | Create, edit, open, and save images using Microsoft Graph API. Works in Teams, Outlook, Office. | [View](https://github.com/OfficeDev/m365-extensibility-image-editor) |+| Sample Launch Page (Microsoft 365) | Showcasing SSO authentication and leveraging TeamsJS SDK capabilities as available in different hosts. Works in Teams, Outlook, Office. | [View](https://github.com/OfficeDev/microsoft-teams-library-js/tree/main/apps/sample-app) | ## Next step |
| platform | Create Extensions | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/messaging-extension-v3/create-extensions.md | The following sections describe how to do this: To initiate actions from a message extension, set the `type` parameter to `action`. Below is an example of a manifest with a search and a create command. A single message extension can have up to 10 different commands. This can include both multiple search and multiple action-based commands. + > [!NOTE] + >`justInTimeInstall` functions when you upload an app to the app catalog but fails when you sideload an app. + ### Complete app manifest example ```json Respond to the submit action by inserting a message with an Adaptive Card into t To enable this flow your task module should respond as in the example below, which will present the preview message to the user. ->[!Note] ->The `activityPreview` must contain a `message` activity with exactly 1 adaptive card attachment. +> [!NOTE] +> The `activityPreview` must contain a `message` activity with exactly 1 adaptive card attachment. + ```json { |
| platform | Add Incoming Webhook | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/webhooks-and-connectors/how-to/add-incoming-webhook.md | To remove an Incoming Webhook from a Teams channel, follow these steps: * [Share to Teams from web apps](~/concepts/build-and-test/share-to-teams-from-web-apps.md) * [Integrate web apps](~/samples/integrate-web-apps-overview.md) * [Secure access and data in Azure Logic Apps](/azure/logic-apps/logic-apps-securing-a-logic-app)+* [Build notification bot with JavaScript](../../sbs-gs-notificationbot.yml) +* [Build your first bot app using JavaScript](../../sbs-gs-bot.yml) |
| platform | Add Outgoing Webhook | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/webhooks-and-connectors/how-to/add-outgoing-webhook.md | Follow the [step-by-step guide](../../sbs-outgoing-webhooks.yml) to create Outgo * [Create an Incoming Webhook](~/webhooks-and-connectors/how-to/add-incoming-webhook.md) * [Create an Office 365 Connector](~/webhooks-and-connectors/how-to/connectors-creating.md) * [Create and send messages](~/webhooks-and-connectors/how-to/connectors-using.md)+* [Build notification bot with JavaScript](../../sbs-gs-notificationbot.yml) +* [Build your first bot app using JavaScript](../../sbs-gs-bot.yml) |
| platform | Connectors Creating | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/webhooks-and-connectors/how-to/connectors-creating.md | Follow the [step-by-step guide](../../sbs-teams-connectors.yml) to build and tes * [Create an Office 365 Connector](~/webhooks-and-connectors/how-to/connectors-creating.md) * [How admins can enable or disable connectors](/MicrosoftTeams/office-365-custom-connectors#enable-or-disable-connectors-in-teams) * [How admins can publish custom connectors within their org](/MicrosoftTeams/office-365-custom-connectors)+* [Build notification bot with JavaScript](../../sbs-gs-notificationbot.yml) +* [Build your first bot app using JavaScript](../../sbs-gs-bot.yml) |
| platform | Connectors Using | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/webhooks-and-connectors/how-to/connectors-using.md | These limits are in place to reduce spamming a channel by a connector and ensure * [Rate limiting for Teams bots messages](~/bots/how-to/rate-limit.md) * [Build tabs with Adaptive Cards](~/tabs/how-to/build-adaptive-card-tabs.md) * [Format cards in Microsoft Teams](~/task-modules-and-cards/cards/cards-format.md)+* [Build notification bot with JavaScript](../../sbs-gs-notificationbot.yml) +* [Build your first bot app using JavaScript](../../sbs-gs-bot.yml) |
| platform | What Are Webhooks And Connectors | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/webhooks-and-connectors/what-are-webhooks-and-connectors.md | Connectors allow users to subscribe to receive notifications and messages from t Incoming Webhooks help in posting messages from apps to Teams. If Incoming Webhooks are enabled for a team in any channel, it exposes the HTTPS endpoint, which accepts correctly formatted JSON and inserts the messages into that channel. For example, you can create an Incoming Webhook in your DevOps channel, configure your build, and simultaneously deploy and monitor services to send alerts. +#### Notification bot or incoming webhook - choose the right one! ++Before you start to learn how to build Incoming webhooks, you may also want to know that you can build Notification Bot using Teams Toolkit. Notification Bots can enable more customizable experience to meet different business scenarios. ++Learn more about the differences between Notification Bot and Incoming webhook so that you can choose correct solutions for your scenarios: ++| | Notification bot | Incoming Webhook | +| | | | +| What is it? | A Teams app | A Teams feature | +| Installation required | Yes | No | +| Suitable scenarios | ΓÇó Receive regular notifications and messages periodically, for example, receive daily notification of team tasks. <br> ΓÇó Receive notifications and messages based on real events. For example, once teammates upload files, you receive notifications. | Communicate with external apps and receive notifications and messages from other apps. | +| Scope configuration | ΓÇó Teams channel <br> ΓÇó Group chat <br> ΓÇó Personal chat | Teams channel | +| Message process | A Notification Bot works as a Teams application. You can define your business logic to process data and show data in a customized format. | Webhook is a Teams feature rather than a Teams application, so it only receives and shows data without processing. | +| Retrieve Teams context | Notification Bot can retrieve Teams context such as the channel or user information, messages, etc. | No | +| Send Adaptive Card | Yes | Yes | +| Send a welcome message | Can send a welcome message | No welcome message | +| Trigger Supported | All triggers supported. If you use Teams Toolkit, you can quickly get template projects with following triggers: <br> ΓÇó Time trigger hosted on Azure functions. <br> ΓÇó Restify HTTP trigger hosted on Azure app service <br> ΓÇó HTTP trigger hosted on Azure Functions | All triggers supported | +| Building Tools | ΓÇó [Teams Toolkit Overview for Visual Studio Code](../toolkit/teams-toolkit-fundamentals.md) <br> ΓÇó [Teams Toolkit overview for Visual Studio](../toolkit/teams-toolkit-overview-visual-studio.md) <br> ΓÇó [TeamsFx Library](../toolkit/TeamsFx-CLI.md) <br> ΓÇó [TeamsFx SDK](../toolkit/TeamsFx-SDK.md) | No tools required | +| Cloud resource required | Azure Bot Framework | No resources required | +| Tutorial | [Build notification bot with JavaScript](../sbs-gs-notificationbot.yml) | NA | + ### Office 365 Connectors Office 365 Connectors allow you to create a custom configuration page for your Incoming Webhook and package them as part of a Teams app. You send messages primarily using Office 365 Connector cards and have the ability to add a limited set of card actions to them. For example, a weather connector that allows users to select a location and a time of day, to receive updates about tomorrow's weather. They are configured on a channel level but are installed at a team level. Actionable messages allow users to take action without leaving their email clien * [Create an Incoming Webhook](~/webhooks-and-connectors/how-to/add-incoming-webhook.md) * [Create an Office 365 Connector](~/webhooks-and-connectors/how-to/connectors-creating.md) * [Create and send messages](~/webhooks-and-connectors/how-to/connectors-using.md)+* [Build notification bot with JavaScript](../sbs-gs-notificationbot.yml) +* [Build your first bot app using JavaScript](../sbs-gs-bot.yml) |