Updates from: 09/15/2021 03:21:47
Service Microsoft Docs article Related commit history on GitHub Change details
platform Enable App Customization https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/concepts/design/enable-app-customization.md
Title: Customize your Teams app
+ Title: Enable your app to be customized
description: Understand how Teams admins can customize your app for their org. ms.localizationpriority: medium -
-# Customize your Teams app
-
-## Enable your Microsoft Teams app to be customized
+# Enable your Microsoft Teams app to be customized
You can allow customers to customize some aspects of your Microsoft Teams app in the Teams admin center. This feature is supported only for apps published to the Teams store. Sideloaded apps and apps published for an org can't be customized.
Some possible examples of this feature include:
* Changing the app's accent color to match an org's brand. * Updating the app name from *Contoso* to *Contoso Agent*, which is the name users in the org will see. (Note: Users adding a connector to a chat or a channel will still see the original app name, *Contoso*.)
-You can enable this feature in the [Developer Portal for Teams](https://dev.teams.microsoft.com/home). This feature configures `configurableProperties`, which isn't available in versions before 1.10 of the Teams app manifest.
+You can enable this feature in the [Developer Portal for Teams](https://dev.teams.microsoft.com/home). This configures `configurableProperties`, which isn't available in versions prior to 1.10 of the Teams app manifest.
-### Test your app
+## Test your app
You can't test this feature during development. App customization isn't supported when sideloading or publishing to an org's app catalog.
-### User considerations
+## User considerations
Provide guidelines for customers (specifically Teams admins) who want to customize your app. For more information, see [customize apps in Teams](/MicrosoftTeams/customize-apps).
-## Hide Teams app until admin approves
-
-To enhance Teams app experience, you can hide an app from users by default until admin allows to unhide the app. For example, Contoso Electronics has created a help desk app for Teams. To enable appropriate functioning of the app, Contoso ElectronicsΓÇÖ wants the customers to first set up specific properties of the app. The app is hidden by default and is available to users only after the admin allows it.
-
-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:
-
-![Manage apps](../../assets/images/apps-in-meetings/manageapp.png)
-
-If by default, you don't want the app to be hidden, you can update the `defaultBlockUntilAdminAction` property to `false`. When the new version of the app is approved, by default the app will be allowed as long as the admin hasn't taken explicit action to block it.
- ## See also
-[Customize apps in the Teams admin center](/MicrosoftTeams/customize-apps)
+* [Customize apps in the Teams admin center](/MicrosoftTeams/customize-apps)
platform Personal Apps https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/concepts/design/personal-apps.md
Use one of the following Teams templates and components to help design your pers
## Use a personal app (bot)
-Personal apps can include a bot for one-on-one conversations and private notifications (for instance, when a colleague posts a comment on on artboard). Users interact with the bot in a tab you specify.
+Personal apps can include a bot for one-on-one conversations and private notifications (for instance, when a colleague posts a comment on artboard). Users interact with the bot in a tab you specify.
### Anatomy: Personal app (bot)
platform First App Blazor https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/get-started/first-app-blazor.md
Deployment consists of two steps:
:::image type="content" source="../assets/images/teams-toolkit-v2/blazor-vs2019-publish1.png" alt-text="Select the Publish operation on the project":::
-1. In the **Publish** window, select **Azure** and selct **Next**.
+1. In the **Publish** window, select **Azure** and select **Next**.
:::image type="content" source="../assets/images/teams-toolkit-v2/blazor-vs2019-publish2.png" alt-text="Select Azure as the publishing target":::
platform First App React https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/get-started/first-app-react.md
Use the Teams Toolkit to create your first project:
:::image type="content" source="../assets/images/teams-toolkit-v2/create-new-project-intro.png" alt-text="Wizard start for Create New Project":::
-1. In the **Select capabilities** section, varify that **Tab** is selected and select **OK**.
+1. In the **Select capabilities** section, verify that **Tab** is selected and select **OK**.
:::image type="content" source="../assets/images/teams-toolkit-v2/create-project-capabilities.png" alt-text="Screenshot showing how to add capabilities to your new app.":::
platform First Message Extension https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/get-started/first-message-extension.md
To build and run your app locally:
1. Select **Add** to add the app to your account. After the app is loaded, you can try to use the sample functionality:
- You can launch the message extension from three dots in the composeing area and try search npm packages from the search bar.
+ You can launch the message extension from three dots in the composing area and try search npm packages from the search bar.
:::image type="content" source="../assets/images/teams-toolkit-v2/search-message-extension.png" alt-text="Your Search-based messaging extension in action":::
platform Get Started Dotnet App Studio https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/get-started/get-started-dotnet-app-studio.md
git clone https://github.com/OfficeDev/Microsoft-Teams-Samples.git
## Build and run the sample
-You can build and run the smaple after it is cloned.
+You can build and run the sample after it is cloned.
**To build and run the cloned sample**
You can now test the bot in Teams.
* [Tutorials Overview](code-samples.md) * [Create a conversational bot app](first-app-bot.md) * [Create a messaging extension](first-message-extension.md)
-* [Code Samples](https://github.com/OfficeDev/Microsoft-Teams-Samples)
+* [Code Samples](https://github.com/OfficeDev/Microsoft-Teams-Samples)
platform Get Started Use App Studio https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/includes/get-started/get-started-use-app-studio.md
### Use App Studio to update the app package > [!TIP]
-> **Try the Developer Portal**: App Studio will soon be depricated. Configure, distribute, and manage your Teams apps with the new [Developer Portal](https://dev.teams.microsoft.com/).
+> **Try the Developer Portal**: App Studio has evolved. Configure, distribute, and manage your Teams apps with the new [Developer Portal](https://dev.teams.microsoft.com/).
App Studio is a Teams app that you can install from the Teams store. It simplifies the creation and registration of an app.
platform Manifest Schema https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/resources/schema/manifest-schema.md
You can define any of the following properties:
* `developerUrl`: The HTTPS URL of the developer's website. * `privacyUrl`: The HTTPS URL of the developer's privacy policy. * `termsOfUseUrl`: The HTTPS URL of the developer's terms of use.-
-## defaultBlockUntilAdminAction
-
-When `defaultBlockUntilAdminAction` property is set to true, the app is hidden from users by default until Admin allows it.
-
-|Name| Type| Maximum size | Required | Description|
-||||||
-|`type`|boolean|32 characters|Γ£ö|Can be **true** or **false**.|
-|`description`|string|128 characters||The description that appears to users to indicate the purpose of this property.|
-|`default`|||Γ£ö|Default is **false**.|
-
-## publisherDocsUrl
-
-|Name| Type| Maximum size | Required | Description|
-||||||
-|`$ref`|||Γ£ö|The URL to the page that provides additional app information for the admins.|
-|`description`|string|128 characters||The description that appears to users to indicate the purpose of this property.|
platform Whats New https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/whats-new.md
Microsoft Teams platform features that are available to all app developers.
| **Date** | **Notes** | **Changed topics** | | -- | | | |09/08/2021|Meeting stage is now available in GA.|[Enable and configure your apps for Teams meetings](apps-in-teams-meetings/enable-and-configure-your-app-for-teams-meetings.md)|
-|09/06/2021| Hide Teams app until Admin allows to unhide the app. | [Hide Teams app until admin approves](concepts/design/enable-app-customization.md#hide-teams-app-until-admin-approves) |
|08/30/2021| Custom Together Mode scenes feature combines participants into a single virtual scene and places their video streams in pre-determined seats. | [Custom Together Mode scenes](~/apps-in-teams-meetings/teams-together-mode.md) | |08/25/2021| Introduced step-by-step guide to create a Teams bot with Single sign-on (SSO). | [Step-by-step guide to create Teams bot with SSO](sbs-bots-with-sso.yml) | |08/19/2021| Installation update event received when you install a bot to a conversation thread. | [Installation update event](bots/how-to/conversations/subscribe-to-conversation-events.md#installation-update-event) |