Updates from: 06/29/2022 01:28:59
Service Microsoft Docs article Related commit history on GitHub Change details
platform Designing Apps In Meetings https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/apps-in-teams-meetings/design/designing-apps-in-meetings.md
Title: Designing your meeting extension
-description: Learn how to design apps in Teams meetings and get the Microsoft Teams UI Kit, in-meeting tab, use cases, responsive behavior, shared meeting stage, theme, and navigation.
+description: Learn how to design meeting extensions for your apps in Teams meetings. Use the UI templates in the Microsoft Teams UI Kit to help you design your meeting tab.
ms.localizationpriority: medium
In the meeting details, users can select **Add a tab +** to open the app flyout
#### Mobile
-Once app has been added (for example, on desktop), users can access the app in a meeting by selecting **More** :::image type="icon" source="../../assets/icons/teams-client-more.png":::.
+Once app is added (for example, on desktop), users can access the app in a meeting by selecting **More** :::image type="icon" source="../../assets/icons/teams-client-more.png":::.
:::image type="content" source="../../assets/images/apps-in-meetings/mobile-add-during-meeting.png" alt-text="Example shows how to add a meeting extension during a meeting on mobile." border="false":::
platform Meeting App Extensibility https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/apps-in-teams-meetings/meeting-app-extensibility.md
To add tabs to an existing meeting:
1. In your calendar, select a meeting to which you want to add a tab. 1. Select the **Details** tab and select <img src="~/assets/images/apps-in-meetings/plusbutton.png" alt="Plus button" width="30"/>. The tab gallery appears.
- :::image type="content" source="~/assets/images/apps-in-meetings/Pre-Meeting-002.png" alt-text="Pre-meeting app experience":::
+ :::image type="content" source="~/assets/images/apps-in-meetings/Pre-Meeting-002.png" alt-text="Pre-meeting app experience.":::
1. In the tab gallery, select the app that you want to add and follow the steps as required. The app is installed as a tab.
To add tabs to an existing meeting:
# [Desktop](#tab/desktop) # [Mobile](#tab/mobile)
To use tabs during a meeting:
# [Desktop](#tab/desktop) # [Mobile](#tab/mobile)
The following image displays the **Contoso** tab with results of poll and feedba
# [Desktop](#tab/desktop) # [Mobile](#tab/mobile)
The Teams unified meetings apps allow you to design your app based on participan
## Participant roles in a meeting The default participant settings are determined by an organization's IT administrator. The following are the participant roles in a meeting:
platform Teams Together Mode https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/apps-in-teams-meetings/teams-together-mode.md
In custom Together Mode scenes, the scene is an artifact. The scene is created b
The following process gives an overview to create a scene only app: A scene only app is still an app in Teams. The Scene studio handles the app package creation in the background. Multiple scenes in a single app package appear as a flat list to the users.
To build a scene using the Scene studio, follow these steps:
1. Select **Add images** to add the image into the environment:
- ![Add images into environment](../assets/images/apps-in-meetings/addimages.png)
+ :::image type="content" source="../assets/images/apps-in-meetings/addimages.png" alt-text="Add images into environment.":::
>[!NOTE] >You can download the [SampleScene.zip](https://github.com/MicrosoftDocs/msteams-docs/tree/master/msteams-platform/apps-in-teams-meetings/SampleScene.zip) and [SampleApp.zip](https://github.com/MicrosoftDocs/msteams-docs/tree/master/msteams-platform/apps-in-teams-meetings/SampleApp.zip) files with the images.
To build a scene using the Scene studio, follow these steps:
1. Select **Meeting Organizer** or **Presenter** role for the participant. In a meeting, one participant must be assigned the role of a meeting organizer:
- ![Assign spot](../assets/images/apps-in-meetings/assign-spot.png)
+ :::image type="content" source="../assets/images/apps-in-meetings/assign-spot.png" alt-text="Assign a spot to the participant.":::
1. Select **Save** and select **View in Teams** to quickly test your scene in Teams.
platform Add Power Virtual Agents Bot To Teams https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/add-power-virtual-agents-bot-to-teams.md
The set-up process for adding your Power Virtual Agents chat bot to Teams is com
* [Power Virtual Agents portal](https://powervirtualagents.microsoft.com) * [Publish your Power Virtual Agents bot](/power-virtual-agents/publication-fundamentals-publish-channels) * [Security and compliance in Microsoft Teams](/MicrosoftTeams/security-compliance-overview)
+* [Human resources Power Virtual Agents bot](/power-virtual-agents/teams/fundamentals-get-started-teams)
platform Add Authentication https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/authentication/add-authentication.md
To create client secret:
1. Next to **Microsoft App ID**, select **Manage**.
- ![Manage Bot](~/assets/images/adaptive-cards/manage-bot-label.png)
+ :::image type="content" source="~/assets/images/manage-bot-label.png" alt-text="manage bot":::
1. In the **Client secrets** section, select **New client secret**.**Add a client secret** window appears.
platform Channel And Group Conversations https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/conversations/channel-and-group-conversations.md
Follow the [step-by-step guide](../../../sbs-teams-conversation-bot.yml), to cre
## See also
-[Get Teams context](~/bots/how-to/get-teams-context.md)
+* [Get Teams context](~/bots/how-to/get-teams-context.md)
+* [Create private channel on behalf of user](/graph/api/channel-post#example-2-create-private-channel-on-behalf-of-user)
+* [Connect a bot to Web Chat channel](/azure/bot-service/bot-service-channel-connect-webchat)
+
platform Rate Limit https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/bots/how-to/rate-limit.md
Title: Optimize your bot with rate limiting in Teams
-description: Learn about handling rate limit for bots with Per bot per thread limit and per limit for all bots using Code examples
+ Title: Rate limiting for bots
+description: Learn about handling rate limit for bots with per bot per thread limit and per limit for all bots with code examples
ms.localizationpriority: medium
platform Prepare Your O365 Tenant https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/build-and-test/prepare-your-o365-tenant.md
For complete information on how these settings interact, see [manage custom app
## See also
-[Add test data to your Microsoft 365 test tenant](~/concepts/build-and-test/test-data.md)
+* [Add test data to your Microsoft 365 test tenant](~/concepts/build-and-test/test-data.md)
+* [Microsoft 365 Multi-Geo](/microsoft-365/enterprise/microsoft-365-multi-geo?view=o365-worldwide&preserve-view=true)
platform Include Saas Offer https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/deploy-and-publish/appsource/prepare/include-saas-offer.md
For comprehensive guidance, see [how to plan a SaaS offer for the Microsoft comm
When planning how to monetize your Teams app, here are some things to consider:
-* Decide on your subscription model. A transactable SaaS offer can include multiple subscription plans. Public subscription plans available to anyone are most common, but you may also want to target specific customers with deals only for them. For more information, see [private offers in the Microsoft commercial marketplace](/azure/marketplace/private-offers).
+* Decide on your subscription model. A transactable SaaS offer can include multiple subscription plans. Public subscription plans available to anyone are most common, but you may also want to target specific customers with deals only for them. For more information, see [private plans in the Microsoft commercial marketplace](/azure/marketplace/private-plans).
* Read about the [*Sell through Microsoft* listing option](/azure/marketplace/plan-saas-offer#listing-options) for your SaaS offer, which is required if you want users to purchase subscription plans for your app directly through the Teams store. * Learn how [Azure Active Directory single sign-on (SSO)](/azure/marketplace/azure-ad-saas) helps your customers purchase and manage subscriptions. (Microsoft Azure Active Directory (Azure AD) SSO is required for Teams apps with SaaS offers.) * Understand that you're responsible for managing and paying for the infrastructure required to support your customers' use of your SaaS offer.
platform Enable App Customization https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/design/enable-app-customization.md
To enhance Teams app experience, you can hide an app from users by default until
To hide the app, in the app manifest file, set the `defaultBlockUntilAdminAction` property to `true`. When the property is set to `true`, in Teams admin center > **Manage apps**, **Blocked by publisher** appears in app's **Status**:
-![Manage apps blocked by publisher](../../assets/images/apps-in-meetings/manageappsblockedapps.png)
The admin gets a request to take action before a user can access the app. Under **Manage apps**, the admins can select **Allow** to allow the app with **Blocked by publisher** status:
platform Plan Responsive Tabs For Teams Mobile https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/design/plan-responsive-tabs-for-teams-mobile.md
You can show the following information:
* Data visuals, maps, and infographics. * Charts, graphs, and tables.
-![Dashboarding and data visualization apps consumption](../../assets/images/app-fundamentals/dashboarding-and-data-visualization-apps-consumption.png)
Quick actions:
In the second stage, the users can work on the existing charts and visuals from
* Filter data. * Create bookmarks.
-![Dashboarding and data visualization apps quick actions](../../assets/images/app-fundamentals/dashboarding-and-data-visualization-apps-quick-actions.png)
Enablement:
You can provide following access to users:
* Insert data items to create visualizations. * Share visualizations in a channel or group chat.
-![Dashboarding and data visualization apps enablement](../../assets/images/app-fundamentals/dashboarding-and-data-visualization-apps-enablement.png)
<br>
Consumption:
In the first stage, your app can show the list of tasks to the user in a vertical stack. If there are multiple categories of tasks, such as **Proposed**, **Active**, and **Closed** then provide filters for showing grouped tasks or as headers to see the grouped tasks.
-![Task boarding apps consumption](../../assets/images/app-fundamentals/taskboarding-apps-consumption.png)
Quick actions:
In the second stage, you can provide the following app access to users:
* Move the tasks into different categories. * Share relevant tasks in chats and channels through emails and activity feed.
-![Task boarding apps quick actions](../../assets/images/app-fundamentals/taskboarding-apps-quick-actions.png)
Enablement:
In the third stage, you can enable users' experience with the following activiti
* Add and modify different categories, such as **Proposed**, **Active**, and **Closed**. * Configure the tasks for comments, attachments, and other complex features.
-![Task boarding apps enablement](../../assets/images/app-fundamentals/taskboarding-apps-enablement.png)
+ <br> </details>
In the first stage, you can consider desktop experience to show the content and
* Zoom in or out. * Current stage or progress of a pending document.
-![Coauthoring and whiteboarding apps consumption](../../assets/images/app-fundamentals/coauthoring-and-whiteboarding-apps-consumption.png)
Quick Actions:
In the second stage, you can introduce the following actions:
> [!TIP] > You expose actions, which can be shown easily on the small screens.
-![Coauthoring and whiteboarding apps quick actions](../../assets/images/app-fundamentals/coauthoring-and-whiteboarding-apps-quick-actions.png)
Enablement:
In the third stage, provide complete experience to your users. You can enable us
* Delete, undo, and redo operations. * Access camera and microphone using JS SDK APIs. For more information on device capabilities, see [device capabilities overview](../device-capabilities/device-capabilities-overview.md).
-![Coauthoring and whiteboarding apps enablement](../../assets/images/app-fundamentals/coauthoring-and-whiteboarding-apps-enablement.png)
<br>
platform Import External Messages To Teams https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/graph-api/import-messages/import-external-messages-to-teams.md
The following table provides the content scope:
## See also
-[Microsoft Graph and Teams integration](/graph/teams-concept-overview)
+* [Microsoft Graph and Teams integration](/graph/teams-concept-overview)
+* [Export content with the Microsoft Teams Export APIs](/microsoftteams/export-teams-content)
platform Resource Specific Consent https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/graph-api/rsc/resource-specific-consent.md
The following table provides resource-specific permissions for a chat:
| Calls.AccessMedia.Chat | Access media streams in calls associated with this chat or meeting. | | Calls.JoinGroupCalls.Chat | Join calls associated with this chat or meeting. | | TeamsActivity.Send.Chat | Create new notifications in the activity feeds of the users in this chat. |
+| OnlineMeetingTranscript.Read.Chat | Read the transcripts of the meeting associated with this chat. |
For more details, see [chat resource-specific consent permissions](/graph/permissions-reference#chat-resource-specific-consent-permissions).
platform Bots Files https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/resources/bot-v3/bots-files.md
private static Attachment CreateFileConsentAttachment()
return att; } ```+
+## See also
+
+[Working with files in Microsoft Graph](/graph/api/resources/onedrive)
platform App Templates https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/samples/app-templates.md
Title: App templates for Microsoft Teams description: Learn how to use app templates for Microsoft Teams platform with detailed instructions for deploying and installing an app.
+keywords: Microsoft Teams templates samples demo
ms.localizationpriority: medium
Using the co-worker appreciation template in Teams, users can recognize their co
[Get it on GitHub](https://github.com/OfficeDev/microsoft-teams-apps-coworker-appreciation)
-![Overall](../assets/images/coworker-appreciation-1.png)
## FAQ Plus
platform Tab Sso Graph Api https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-graph-api.md
You can ask for consent using the Auth API. Another approach for getting Graph s
- [OAuth 2.0 On-Behalf-Of flow](/azure/active-directory/develop/v2-oauth2-on-behalf-of-flow) - [Get access for MS Graph](/graph/auth-v2-user) - [Token cache serialization in MSAL.NET](/azure/active-directory/develop/msal-net-token-cache-serialization?tabs=aspnet)
+- [Microsoft Teams MSAL2 provider](/graph/toolkit/providers/teams-msal2)
platform Tab Sso Manifest https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/authentication/tab-sso-manifest.md
To preview your tab app in Teams:
1. Select **Upload a custom app** to sideload the tab app to Teams.
- :::image type="content" source="../../../assets/images/authentication/teams-sso-tabs/sideload-tab-app.png" alt-text="Sideload tab app into Teams":::
- 1. Select your app package zip file, and then select **Add**. The tab app is sideloaded and the dialog appears to inform you of the additional permissions that may be required.
platform Conversational Tabs https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/conversational-tabs.md
microsoftTeams.conversations.openConversation({ΓÇ£subEntityIdΓÇ¥:ΓÇ¥task-1ΓÇ¥,
The following image shows the conversation panel:
-![Conversational sub-entities - start conversation](~/assets/images/tabs/conversational-subentities/start-conversation.png)
If the user starts a conversation, it's important to listen for the callback of that event to retrieve and save the **conversationId**:
After a conversation starts, subsequent calls to `openConversation()` require, t
The following image shows the conversation panel with the appropriate conversation:
-![Conversational sub-entities - continue conversation](~/assets/images/tabs/conversational-subentities/continue-conversation.png)
## Enhance a conversation
platform Tabs Link Unfurling https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/tabs-link-unfurling.md
Title: Tabs link unfurling and Stage View
-description: Learn how to unfurl a link, open the Stage View and pin a tab with Teams app. Learn invoking it using Adaptive card using code example and sample.
+description: Learn how to unfurl a link, open the Stage View and pin a tab with Microsoft Teams app. Learn about stage view and invoking it using Adaptive card using code example and sample.
ms.localizationpriority: medium
Following is the process to invoke Stage View:
* The bot responds with a `200` code. > [!NOTE]
-> On Teams mobile clients, invoking Stage View for apps distributed through the [your Microsoft Teams app](../concepts/deploy-and-publish/apps-publish-overview.md) and not having a moblie-optimized experience opens the default web browser of the device. The browser opens the URL specified in the `websiteUrl` parameter of the `TabInfo` object.
+> On Teams mobile clients, invoking Stage View for apps distributed through the [Teams store](/platform/concepts/deploy-and-publish/apps-publish-overview.md) and not having a moblie-optimized experience opens the default web browser of the device. The browser opens the URL specified in the `websiteUrl` parameter of the `TabInfo` object.
## Invoke Stage View through deep link
platform Teams Toolkit Fundamentals https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/teams-toolkit-fundamentals.md
Teams Toolkit brings all tools needed for building a Teams app in one place.
Teams Toolkit automates manual work and provides great integration of Teams and Azure resources. The following image shows Teams Toolkit user journey: The main milestones of this journey are:
During or after the development, ensure to provision, deploy, and publish Teams
### Provision in the cloud
-It integrates with Azure resource manager that enables you to provision Azure resources, which your application needs for code approach.
+It integrates with Azure Resource Manager that enables you to provision Azure resources, which your application needs for code approach.
### Deploy to the cloud