Updates from: 09/28/2024 01:11:37
Service Microsoft Docs article Related commit history on GitHub Change details
platform Monetize Overview https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/deploy-and-publish/appsource/prepare/monetize-overview.md
Microsoft Teams Store provides features that enable you to monetize your apps an
## Choose a pricing model
- :::column:::
- :::image type="content" source="../../../../assets/images/saas-offer/pricing-charge-price.png" alt-text="Charge a price for your app":::
- :::column-end:::
- :::column span="2":::
+* **Include a SaaS offer with your app**:
-**Include a SaaS offer with your app**
+ With a transactable Software-as-a-Service (SaaS) offer, you can monetize your Teams app by selling subscription plans directly from your Teams Store listing.
-With a transactable [Software-as-a-Service (SaaS) offer](~/concepts/deploy-and-publish/appsource/prepare/include-saas-offer.md), you can monetize your Teams app by selling subscription plans directly from your Teams Store listing.
+ For more information, see [include a SaaS offer with your Teams app](include-saas-offer.md).
- :::column-end:::
+* **Free trials**:
- :::column:::
- :::image type="content" source="../../../../assets/images/saas-offer/pricing-free-trial.png" alt-text="Free trials":::
- :::column-end:::
- :::column span="2":::
+ You can offer a free trial version of your app to get more customers to try it. To entice customers to buy the full version, you can limit the features in the trial version (for example, only including limited number of responses for a week) or specify a time period for the trial.
-**Free trials**
+* **In-app purchases**:
-You can offer a free trial version of your app to get more customers to try it. To entice customers to buy the full version, you can limit the features in the trial version (for example, only including limited number of responses for a week) or specify a time period for the trial.
+ Whether you charge a price for your app or offer it for free, you can use in-app purchases in your app to provide an ongoing revenue stream. Use in-app purchases to let customers upgrade from a free to a paid version of your app.
- :::column-end:::
- :::column:::
- ![In-app purchases](~/assets/images/saas-offer/pricing-in-app-purchases.png)
- :::column-end:::
- :::column span="2":::
+ For more information, see [in-app purchases](in-app-purchase-flow.md).
-**In-app purchases**
+* **Test preview for monetized app**:
-Whether you charge a price for your app or offer it for free, you can use in-app purchases in your app to provide an ongoing revenue stream. Use in-app purchases to let customers upgrade from a free to a paid version of your app.
+ With a transactable Software as a Service (SaaS) offer, you can test the end-to-end purchase experience for your monetized apps in Teams before you publish.
-[Use in-app purchases](~/concepts/deploy-and-publish/appsource/prepare/in-app-purchase-flow.md)
+ For more information, see [test preview for monetized apps](Test-preview-for-monetized-apps.md).
- :::column-end:::
- :::column:::
- :::image type="content" source="../../../../assets/images/apps-in-meetings/test-preview-monetize-app-image.png" alt-text="Test preview SaaS offer":::
- :::column-end:::
- :::column span="2":::
+* **Set up Microsoft license management**:
-**Test preview for monetized app**
+ If you choose to use Microsoft license management to manage a SaaS license purchased in Teams, you can easily assign, unassign, use, and track SaaS licenses from the Teams Store.
-With a transactable Software as a Service (SaaS) offer, you can test the end-to-end purchase experience for your monetized apps in Teams before you publish.
-
-[Test preview for monetized apps](Test-preview-for-monetized-apps.md)
-
- :::column-end:::
-
- :::column:::
- :::image type="content" source="../../../../assets/images/apps-in-meetings/test-preview-monetize-app-image.png" alt-text="Manage license for third party apps":::
- :::column-end:::
- :::column span="2":::
-
-**Set up Microsoft license management**
-
-If you choose to use Microsoft license management to manage a SaaS license purchased in Teams, you can easily assign, unassign, use, and track SaaS licenses from the Teams Store.
-
-[Set up Microsoft license management](manage-third-party-apps-license.md).
-
+ For more information, see [set up Microsoft license management](manage-third-party-apps-license.md).
## See also
platform Review Copilot Validation Guidelines https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/deploy-and-publish/appsource/prepare/review-copilot-validation-guidelines.md
You must ensure to meet the following guidelines for Copilot agents:
| Microsoft 365 Copilot and Bing | `edgeservices.bing.com`, `www.bing.com`, `copilot.microsoft.com` | | Microsoft 365 app | `*.microsoft365.com`, `*.office.com` | | Outlook | `outlook.office.com`, `outlook.office365.com`, `outlook-sdf.office.com`, `outlook-sdf.office365.com` |
+ | Office.com | `Office.com/copilot` <br> `Office.com/chat` |
+ | Microsoft365.com | `Microsoft365.com/copilot` <br> `Microsoft365.com/chat` |
+ | M365.cloud.microsoft | `M365.cloud.microsoft/chat` <br> `M365.cloud.microsoft/copilot` |
+ | Copilot.cloud.microsoft | `Copilot.cloud.microsoft` |
1. **Upgrade Teams JS version to the 2.22.0 build** [*Must fix*]
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 RSC permissions for a user and their applicable dat
| `MeetingParticipantReaction.Read.User` | Read the user's reactions while participating in a meeting. |Supported |NA | | `OutgoingVideoStream.Write.User` | Modify the user's outgoing video. |Supported |NA | | `TeamsActivity.Send.User` | Send activity notifications to the user. |NA |Supported |
+| `TeamsAppInstallation.Read.User` | Read the apps that are installed in the user's personal scope. | NA | Supported |
## Next step
platform Content Security Policy Headers https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/includes/tabs/content-security-policy-headers.md
| Teams | `teams.microsoft.com`, `*.teams.microsoft.com` | | Microsoft 365 app | `*.microsoft365.com`, `*.office.com`, | | Outlook | `outlook.office.com`, `outlook.office365.com`, `outlook-sdf.office.com`, `outlook-sdf.office365.com` |+
platform Build Bot Based Plugin https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/messaging-extensions/build-bot-based-plugin.md
To create a bot-based search message extension plugin using Teams Toolkit CLI, f
1. Enter the following command: ```
- npm install -g @microsoft/teamsfx-cli@beta
+ npm install -g @microsoft/teamsapp-cli
```
-1. Enter `teamsfx new` in the terminal.
+1. Enter `teamsapp new` in the terminal.
1. Select **Message Extension**. Use the arrow keys to switch between options.
To create a bot-based search message extension plugin using Teams Toolkit CLI, f
1. Go to the folder path where your project is created and enter the following command to provision your app in Azure: ```
- teamsfx provision --env dev
+ teamsapp provision --env dev
``` Teams Toolkit CLI opens a browser window and requests you to sign in to your Microsoft Account.
To create a bot-based search message extension plugin using Teams Toolkit CLI, f
1. In the command prompt window, enter the following command to preview your app in Teams: ```
- teamsfx preview --env dev
+ teamsapp preview --env dev
``` A new browser window with Teams web client opens. You can add your app to Teams.
platform Create Api Message Extension https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/messaging-extensions/create-api-message-extension.md
To create an API-based message extension using Teams Toolkit CLI, follow these s
1. Enter the following command: ```
- npm install -g @microsoft/teamsfx-cli@beta
+ npm install -g @microsoft/teamsapp-cli
```
-1. Type `teamsfx new` in the terminal
+1. Type `teamsapp new` in the terminal
1. Select **Message Extension**.
To create an API-based message extension using Teams Toolkit CLI, follow these s
1. Go to the folder path where your project is created and enter the following command to provision your app in Azure:
- ```teamsfx provision --env dev```
+ ```teamsapp provision --env dev```
Teams Toolkit CLI opens a browser window and requests you to sign in to your Microsoft Account. 1. Sign in to your Microsoft account. Teams Toolkit CLI executes validation and provisions your app on Azure.
To create an API-based message extension using Teams Toolkit CLI, follow these s
1. In the command prompt window, enter the following command to preview your app in Teams:
- ```Preview the app: teamsfx preview --env dev```
+ ```Preview the app: teamsapp preview --env dev```
A new browser window with Teams web client opens. You can add your app to Teams.
platform What Are Messaging Extensions https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/messaging-extensions/what-are-messaging-extensions.md
The following table helps you select a message extension type to get started:
**Select an option to start building a message extension:** :::row:::
- :::column:::
- :::image type="content" source="../assets/images/Copilot/build-message-extension-API-tile.png" alt-text="Screenshot shows the OpenAPI icon tile." link="api-based-overview.md" border="false":::
+ :::column span="4":::
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; :::image type="content" source="../assets/images/Copilot/build-message-extension-api-tile.png" alt-text="Screenshot shows the OpenAPI icon tile." link="api-based-overview.md" border="false":::
:::column-end:::
- :::column:::
- :::image type="content" source="../assets/images/Copilot/build-message-extension-bot-tile.png" alt-text="Screenshot shows the Bot Framework tile." link="build-bot-based-message-extension.md" border="false":::
+ :::column span="4":::
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;:::image type="content" source="../assets/images/Copilot/build-message-extension-bot-tile.png" alt-text="Screenshot shows the Bot Framework tile." link="build-bot-based-message-extension.md" border="false":::
:::column-end::: :::row-end:::
platform Using Teams Client Library https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/tabs/how-to/using-teams-client-library.md
async function example() {
> [!TIP] > When you use [Teams Toolkit to update to TeamsJS v.2.0](#updating-to-teamsjs-version-20), the required updates are flagged for you with `TODO` comments in your client code.
+Cross-cloud communication through SDK is restricted for security reasons; hence, Teams operated by 21Vianet domain isn't included in `validOrigins`. To enable an app to function in Teams operated by 21Vianet, specify the Teams operated by 21Vianet domain during the SDK initialization in your app deployment, using the [validMessageOrigins](/javascript/api/@microsoft/teams-js/app) parameter.
+
+```js
+import { app } from '@microsoft/teams-js';
+app.initialize(["https://teams.microsoftonline.cn"]);
+```
+ ### APIs organized into capabilities A *capability* is a logical grouping (via namespace) of APIs that provide similar functionality. You can think of Microsoft Teams, Outlook, and Microsoft 365 app, as hosts to your tab app. A host supports a given capability if it supports all the APIs defined within that capability. A host can't partially implement a capability. Capabilities can be feature- or content-based, such as *authentication*, or *dialog*. There are also capabilities for application types such as *pages*, and other groupings.
platform Build Environments https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/build-environments.md
Last updated 11/29/2021
Microsoft Teams Toolkit supports different build environments for creating apps. It helps to integrate Azure Functions capabilities and cloud services in the Microsoft Teams app that you've built. ## Build environments
platform Build Environments Vs https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/toolkit-v4/build-environments-vs.md
Last updated 11/29/2021
Microsoft Teams Toolkit supports different build environments for creating apps. It helps to integrate Microsoft Azure Functions capabilities and cloud services in the Microsoft Teams app that you've built. - ## Build environments Teams Toolkit in Microsoft Visual Studio offers a set of environments to build your Teams app in C# using Blazor framework. ### Create your Teams app using C# and Blazor
-Teams Toolkit in Visual Studio allows you to create a Teams app using C# using the Blazor framework. You can create tab app, bot app, and message extension app in a C# build environment.
+Use Teams Toolkit in Visual Studio to create a Teams app using C# using the Blazor framework. You can create tab app, bot app, and message extension app in a C# build environment.
## Support for Azure Functions
platform Add Incoming Webhook https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/webhooks-and-connectors/how-to/add-incoming-webhook.md
To add an Incoming Webhook to a Teams channel, follow these steps:
:::image type="content" source="../../assets/images/manage-channel-new-teams.png" alt-text="Screenshot shows the Manage channel option under More options for Teams 2.1.":::
+ For members who aren't admins of the channel, the **Manage channel** option is available under the **Open channel details** option in the upper-right corner of a channel.
+
+ :::image type="content" source="../../assets/images/Connectors/manage-channel-non-admin-user.png" alt-text="Screenshot of the Manage channel option for non-admin users." lightbox="../../assets/images/Connectors/manage-channel.png":::
+ 1. Select **Edit**. :::image type="content" source="../../assets/images/edit-connector-new-teams.png" alt-text="Screenshot shows the edit option under Connectors option to add an Incoming Webhook.":::