Updates from: 09/02/2022 02:44:12
Service Microsoft Docs article Related commit history on GitHub Change details
platform Bot Features https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/bot-features.md
You can create a bot that works in Microsoft Teams with one of the following tools or capabilities: * [Microsoft Bot Framework SDK](#bots-with-the-microsoft-bot-framework)
+* [Azure Active Directory](~/bots/how-to/authentication/auth-aad-sso-bots.md#develop-an-sso-teams-bot)
+* [Developer Portal](~/concepts/build-and-test/manage-your-apps-in-developer-portal.md#configure)
* [Power Virtual Agents](#bots-with-power-virtual-agents) * [Virtual Assistant](~/samples/virtual-assistant.md) * [Webhooks and connectors](#bots-with-webhooks-and-connectors)
platform Add Authentication https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/authentication/add-authentication.md
Title: Add authentication to your Teams bot
-description: Learn how to add OAuth authentication to a bot in Teams using Azure Active Directory. Learn how to create, deploy, and integrate authentication-enabled bots.
+description: Learn how to enable authentication using third-party OAuth provider to a bot app in Teams using Azure AD.
ms.localizationpriority: medium
platform Auth Aad Sso Bots https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/authentication/auth-aad-sso-bots.md
Title: Single sign-on support for bots
-description: Learn how to get a user token and a bot developer can use a sign-in card or the Azure bot service with the OAuth card support.
+description: Enable Single sign-on (SSO) using Azure AD configuration and OAuth card support for Teams bot apps.
ms.localizationpriority: medium
platform Auth Flow Bot https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/authentication/auth-flow-bot.md
Title: Microsoft Teams Authentication flow for bots
-description: In this module, learn how to do Authentication flow for bots in Microsoft Teams and its Code sample.
+description: Enable authentication for Microsoft Teams bot app with third-party OAuth provider using code samples.
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
The following code provides an example of RSC permissions:
// When rsc is enabled the method will be called even when bot is addressed without being @mentioned protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken) {
- await turnContext.SendActivityAsync(MessageFactory.Text("Using RSC the bot can recieve messages across channels in team without being @mentioned."));
+ await turnContext.SendActivityAsync(MessageFactory.Text("Using RSC the bot can receive messages across channels in team without being @mentioned."));
} ```
protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivi
// Handle when a message is addressed to the bot. // When rsc is enabled the method will be called even when bot is addressed without being @mentioned this.onMessage(async (context, next) => {
- await context.sendActivity(MessageFactory.text("Using RSC the bot can recieve messages across channles in team without being @mentioned."))
+ await context.sendActivity(MessageFactory.text("Using RSC the bot can receive messages across channles in team without being @mentioned."))
await next(); }); ```
platform Conversation Messages https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/conversations/conversation-messages.md
async def on_members_added_activity(
> [!NOTE]
-> Message splitting occurs when a text message and an attachment are sent in the same activity payload. This activity is split into separate activities by Microsoft Teams, one with just a text message and the other with an attachment. As the activity is split, you do not receive the message ID in response, which is used to [update or delete](~/bots/how-to/update-and-delete-bot-messages.md) the message proactively. It is recommended to send separate activities instead of depending on message splitting.
+>
+>* Message splitting occurs when a text message and an attachment are sent in the same activity payload. This activity is split into separate activities by Microsoft Teams, one with just a text message and the other with an attachment. As the activity is split, you do not receive the message ID in response, which is used to [update or delete](~/bots/how-to/update-and-delete-bot-messages.md) the message proactively. It is recommended to send separate activities instead of depending on message splitting.
+>* Messages sent can be localized to provide personalization. For more information, see [Localize your app](../../../concepts/build-and-test/apps-localization.md).
Messages sent between users and bots include internal channel data within the message. This data allows the bot to communicate properly on that channel. The Bot Builder SDK allows you to modify the message structure.
Following are the status codes and their error code and message values:
## Code sample
-|Sample name | Description | .NETCore | Node.js | Python |
-|-|--|--|-|--|
-| Teams conversation bot | Messaging and conversation event handling. |[View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/57.teams-conversation-bot)|[View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/javascript_nodejs/57.teams-conversation-bot)| [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/python/57.teams-conversation-bot) |
+| Sample name | Description | Node.js | .NETCore | Python | .NET |
+|-|--|--|-|--|--|
+| Teams conversation bot | Messaging and conversation event handling. | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/javascript_nodejs/57.teams-conversation-bot) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/57.teams-conversation-bot) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/python/57.teams-conversation-bot) | NA |
+| Teams app localization | Teams app localization using bot and tab. | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/app-localization/nodejs) | NA | NA | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/app-localization/csharp) |
## Next step
Following are the status codes and their error code and message values:
* [Subscribe to conversation events](~/bots/how-to/conversations/subscribe-to-conversation-events.md) * [Send and receive files through the bot](~/bots/how-to/bots-filesv4.md) * [Send tenant ID and conversation ID to the request headers of the bot](~/bots/how-to/conversations/request-headers-of-the-bot.md)
+* [Localize your app](../../../concepts/build-and-test/apps-localization.md)
platform Send Proactive Messages https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/conversations/send-proactive-messages.md
See the following video to learn how to send proactive message from bots:
<br>
-> [!VIDEO <https://www.microsoft.com/en-us/videoplayer/embed/RE4NHyk>]
+> [!VIDEO https://www.microsoft.com/en-us/videoplayer/embed/RE4NHyk]
<br> ### Understand who blocked, muted, or uninstalled a bot
platform Get Teams Context https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/get-teams-context.md
Response body
> [!div class="nextstepaction"] > [Send and receive files through the bot](~/bots/how-to/bots-filesv4.md)+
+## See also
+
+[Localize your app](../../concepts/build-and-test/apps-localization.md)
platform Authentication https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/authentication/authentication.md
Title: Authenticating app users
-description: In this module, learn authentication in Teams and how to use it in the apps, web based authentication flow and OAuthPrompt flow for conversational bots
+description: Learn about authentication methods that you can enable in Teams app, such as Single sign-on (SSO) and using third-party OAuth providers.
ms.localizationpriority: medium
platform Resource Specific Consent https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/graph-api/rsc/resource-specific-consent.md
You can enable or disable RSC for chats using Graph API. The property `isChatRes
![Graph RSC team configuration](../../assets/images/rsc/graph-rsc-chat-configuration.png)
-> The default value of the property **isChatResourceSpecificConsentEnabled** is based on whether [user consent settings](/azure/active-directory/manage-apps/configure-user-consent?tabs=azure-portal) is turned on or off in the tenant when RSC for chats is first used. This can be the first time a) retrieving [**teamsAppSettings**](/graph/api/teamsappsettings-get) or b) installing a Teams app with resource-specific permissions in a chat/meeting.
+> The default value of the property **isChatResourceSpecificConsentEnabled** is based on whether [user consent settings](/azure/active-directory/manage-apps/configure-user-consent?tabs=azure-portal) is turned on or off in the tenant when RSC for chats is first used. This can be the first time a) retrieving [**teamsAppSettings**](/graph/api/teamsappsettings-get) or b) installing a Teams app with resource-specific permissions in a chat/meeting.
## Register your app with Microsoft identity platform using the Azure AD portal
platform Teams Bot Samples https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/includes/bots/teams-bot-samples.md
Title: Teams bot samples
-description: With this learning module, learn about Teams samples for Bot Framework, which includes working samples demonstartaing the functionality.
+description: With this learning module, learn about Teams samples for Bot Framework, which includes working samples demonstrating the functionality.
localization_priority: Normal
For complete working samples demonstrating the functionality, see the following
|Teams file upload | Exchanging files with a bot in a one-to-one conversation. | [View](https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/csharp_dotnetcore/56.teams-file-upload) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/javascript_nodejs/56.teams-file-upload) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/python/56.teams-file-upload) | | Task module | Retrieving a task module and values from cards in it for a message extension. | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/54.teams-task-module) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/javascript_nodejs/54.teams-task-module) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/python/54.teams-task-module) | | Start new thread in a channel | Creating a new thread in a channel. | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/csharp_dotnetcore/58.teams-start-new-thread-in-channel) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/javascript_nodejs/58.teams-start-new-thread-in-channel) | [View](https://github.com/microsoft/BotBuilder-Samples/tree/main/samples/python/58.teams-start-thread-in-channel) |
+| Teams app localization | Teams app localization using bot and tab. | [View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/app-localization/csharp) |[View](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/app-localization/nodejs) | NA |
platform Define Action Command https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/messaging-extensions/how-to/action-commands/define-action-command.md
To add the action command to the app manifest, you must add a new `composeExtens
You can create an action command using **Developer Portal**.
-# [App Studio](#tab/AS)
- > [!NOTE] > The prerequisite to create an action command is that you have already created a message extension. For information on how to create a message extension, see [create a message extension](~/messaging-extensions/how-to/create-messaging-extension.md).
platform Add Authentication https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/messaging-extensions/how-to/add-authentication.md
Title: Add authentication to your message extension
-description: In this article, you'll learn how to add authentication to a messaging extension using code examples and sample
+description: Enable authentication in Teams message extension app using third-party OAuth provider with Azure AD configuration and code sample.
ms.localizationpriority: medium
platform Enable SSO Auth Me https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/messaging-extensions/how-to/enable-SSO-auth-me.md
Title: SSO support for your message extensions
-description: In this article, you'll learn how to enable Single sign-on (SSO) support for your messaging extensions with Code samples.
+description: Enable Single sign-on (SSO) in your Teams message extension app using Azure AD and code sample.
ms.localizationpriority: medium
platform Auth Flow Tab https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/auth-flow-tab.md
Title: Enable authentication using third-party OAuth provider
-description: In this article, learn Teams authentication flow in tabs, third party OAuth provider, OAuth by Azure AD, and auth code samples.
+description: Learn about Teams authentication flow in tabs using third party OAuth provider with Azure AD configuration and code samples.
ms.localizationpriority: high
platform Auth Oauth Provider https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/auth-oauth-provider.md
Title: Use external OAuth providers
-description: In this module, learn how to do authentication using external OAuth providers and how to add it to external browser
+description: Authenticate your app users using external OAuth providers and learn how to add it to external browser.
ms.localizationpriority: high
platform Auth Silent Aad https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/auth-silent-aad.md
Title: Silent authentication
-description: In this module, learn how to do silent authentication, Single-sign-on, and Azure AD for tabs and how it works
+description: Configure your tab app with Azure AD for tabs and how it works.
ms.localizationpriority: medium
platform Tab Sso Code https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-code.md
Title: Code configuration for enabling SSO for tabs
-description: Describes code configuration for enabling SSO for tabs
+description: Update code in your tab app for requesting and receiving access token using app user's Teams identity for enabling Single sign-on (SSO).
ms.localizationpriority: high keywords: teams authentication tabs Microsoft Azure Active Directory (Azure AD) Graph API
platform Tab Sso Graph Api https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-graph-api.md
Title: Extend tab app with Microsoft Graph permissions
-description: Describes configuring API permissions with Microsoft Graph
+description: Configure additional permissions and scopes with Microsoft Graph for enabling Single sign-on (SSO).
ms.localizationpriority: high keywords: teams authentication tabs Microsoft Azure Active Directory (Azure AD) Graph API Delegated permission access token scope
platform Tab Sso Manifest https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-manifest.md
Title: Update manifest for enabling SSO for tabs
-description: Describes updating manifest for enabling SSO for tabs
+description: Update Teams manifest for enabling Single sign-on (SSO) for tabs and sideload it into Teams client for testing SSO authentication.
ms.localizationpriority: high keywords: teams authentication tabs Microsoft Azure Active Directory (Azure AD) Graph API
platform Tab Sso Overview https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-overview.md
Title: Overview to authentication for tabs using SSO in Teams with Azure AD
-description: Overview to SSO authentication in Teams and how to use it in tabs
+description: Learn about Single sign-on (SSO) authentication in Teams and how to enable it in tabs.
ms.localizationpriority: high keywords: teams authentication tabs Microsoft Azure Active Directory (Azure AD) SSO access token app manifest
platform Tab Sso Register Aad https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-register-aad.md
Title: Register your tab app with Azure AD
-description: Describes registering your tab app with Azure AD
+description: Configure Single sign-on (SSO) with Azure AD by configuring App ID URI, scope for access token, and pre-authorize trusted clients.
ms.localizationpriority: high keywords: teams authentication tabs Microsoft Azure Active Directory (Azure AD) access token SSO tenancy scope
platform Tab Sso Troubleshooting https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-troubleshooting.md
Title: Troubleshooting authentication for tabs using SSO in Teams
-description: Troubleshooting SSO authentication in Teams and how to use it in tabs
+description: Troubleshoot Single sign-on (SSO) authentication issues in Teams and how to use it in tab app.
ms.localizationpriority: high keywords: teams authentication tabs Microsoft Azure Active Directory (Azure AD) SSO errors questions
platform Cards Actions https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/task-modules-and-cards/cards/cards-actions.md
Cards used by bots and message extensions in Teams support the following activit
`openUrl` action type specifies a URL to launch in the default browser. > [!NOTE]
-> Your bot does not receive any notice on which button was selected.
+>
+> * Your bot doesn't receive any notice on which button was selected.
+> * Machine names with numbers aren't supported in URL.
With `openUrl`, you can create an action with the following properties:
platform Cards Format https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/task-modules-and-cards/cards/cards-format.md
The following image is an example of masking information in Adaptive Cards:
You can use the `msteams` property to expand the width of an Adaptive Card and make use of additional canvas space. The next section provides information on how to use the property.
+> [!NOTE]
+> Test your full width Adaptive Card in narrow form factors such as mobile and meeting side panels to ensure that content is not truncated.
+ #### Construct full width cards To make a full width Adaptive Card, the `width` object in `msteams` property in the card content must be set to `Full`.
platform Cards Reference https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/task-modules-and-cards/cards/cards-reference.md
The following table provides the features that support Adaptive Cards:
> * Teams platform supports v1.3 or earlier of Adaptive Card features for other capabilities, such as cards sent by user (search based message extensions and link unfurling), tabs, and task modules. > * Positive or destructive action styling is not supported in Adaptive Cards on the Teams platform. > * Media elements are currently not supported in Adaptive Card on the Teams platform.
+> * Test your full width Adaptive Card in narrow form factors such as mobile and meeting side panels to ensure that content is not truncated.
### Example of Adaptive Card