Configure Teams app settings

Applies to: Teams Service Administrator, Exchange Online admin

The Viva Insights app is automatically installed in Teams once the admin enables the app on managed apps. As a Teams Service Administrator, you can pin and manage access for the Microsoft Viva Insights app in Microsoft Teams for all the users or for specific groups in your organization through custom policies.

Prerequisites

Before people in your organization can use the Viva Insights app, they need to have:

• Access to Microsoft Teams.
• An Exchange Online account.

Limit access to the app

To limit who can access the app, follow these steps:

1. Confirm users have a Viva Insights service plan.

2. On the Viva Insights admin page, select Viva Insights.

3. Under Viva Insights in Microsoft 365, select Manage availability in the Teams admin center.

   

4. Confirm that Viva Insights is turned on for your organization on the Manage apps page.

5. Create a custom app permission policy and assign it to those users. For details, see Manage app permission policies in Teams.

Pin the app

In Teams, you can pin the Viva Insights app in the left app bar for all users in your organization. Learn how to pin apps in Use app setup policies to pin and auto-install apps for users.

Users can follow these steps to Discover and pin the Viva Insights app.

Configure meeting effectiveness surveys

As the admin, you can configure the meeting effectiveness surveys for your organization at the user or tenant level. You can enable or disable the survey for a specific user or multiple users with PowerShell, or you can set the default state for all users in your tenant as opted in or opted out in the Microsoft 365 admin center.

Prerequisites

Confirm the following before configuring access:

• Admin role - You need to have an Exchange Online admin role to configure users for meeting effectiveness surveys in the Microsoft 365 admin center. To configure individual users through PowerShell, you need to have an Exchange Online admin or an Insights admin role.
• Understand data privacy - See the Privacy guide to understand how privacy is built into meeting effectiveness surveys and to learn what you can configure to address your organization's specific privacy requirements.

Tenant-level configuration

As the admin, use the following steps to change the setting for meeting effectiveness surveys at the tenant level. This setting is enabled by default, so that all users will receive the surveys. Users can opt out individually from within their Viva Insights app settings.

To configure the default state for a tenant

1. On the Viva Insights admin page, select Viva Insights.

2. Under Viva Insights in Microsoft 365, select Manage settings for Viva Insights.

3. In the resulting pane, select or deselect the checkbox for Meeting effectiveness surveys, and then select Save changes. If you deselect the checkbox, no user in your organization will receive the surveys, including those who previously were receiving them. However, individuals can explicitly opt in again within their Viva Insights app.

   

User-level configuration

As the admin, you can use the Exchange Online PowerShell V2 module to set access for one user or for multiple users for meeting effectiveness surveys.

To configure survey sampling rate

As the admin, you can configure the percentage of meetings that get surveyed. The default sampling rate is 15%. You can configure this sampling rate to any value between 10% and 70% through the Set-DefaultTenantMyAnalyticsFeatureConfig PowerShell cmdlet. Run the following command and change the -SamplingRate value, which is set at 0.2 in this example:

Set-DefaultTenantMyAnalyticsFeatureConfig -Feature Meeting-Effectiveness-Survey-Sampling-Rate -SamplingRate 0.2

Check a user's access

To check whether a user has access to features in Microsoft Viva Insights in Microsoft Teams, follow the directions in Get-VivaInsightsSettings.

Set access for one user

To enable or disable meeting effectiveness surveys for a specific user, use the Exchange Online PowerShell V2 module and the following command line, where you replace [email protected] with your applicable username and organization:

Set-VivaInsightsSettings -Identity [email protected] -Enabled $false -Feature MeetingEffectivenessSurvey

• If you set the Enabled parameter to $false, the meeting effectiveness surveys will be Off for that user. The user won't be able to override this setting or opt in to the meeting effectiveness surveys. In other words, you're completely disabling the feature.
• If you set the Enabled parameter to $true, the meeting effectiveness surveys will be On for that user. Users can then opt out from meeting effectiveness surveys. If no action occurs, this setting applies by default.

Set access for multiple users

You can also enable or disable meeting effectiveness surveys for multiple users with a PowerShell script that iterates through the specified users, changing the value one user at a time.

Use the following script to:

• Create a .csv file with all users that were processed with their current status.
• List the user principal name for each user.
• Set the specified Enabled parameter for each user.

1. Create an input .csv text file that contains the Identity of the users you want to configure. For example:

   Identity
   [email protected]
   [email protected]
   [email protected]
   

2. Specify the location of the input .csv file, the output .csv file, and the value of Enabled to $true or $false for each user:

   $inFileName="<path and file name of the input .csv file that contains the users, for example: C:\admin\Users2Opt-in.csv>"
   $outFileName="<path and file name of the output .csv file that records the results, for example: C:\admin\Users2Opt-in-Done.csv>"
   $meetingEffectivenessSurveysMode = $true
   
   $users=Import-Csv $inFileName
   ForEach ($user in $users)
   {
   $user.identity
   $upn=$user.identity
   Set-VivaInsightsSettings –Identity $upn -Enabled $meetingEffectivenessSurveysMode -Feature MeetingEffectivenessSurvey
   }
   

3. Run the resulting commands at the Exchange Online PowerShell V2 module command prompt.

Notification scenarios

People see different notifications and settings in their Viva Insights app in Teams or on the web, depending on which settings scenario you picked above.

Scenario 1: You didn't change the default setting in the Microsoft admin center, and the meeting effectiveness survey feature is on for all people in your organization.

The first time people in your organization use the Viva Insights app, they get a notification about meeting effectiveness surveys. On their Settings > Effective meetings page, the toggle for Meeting effectiveness surveys is switched on. If people want to opt out of the survey, they can switch the toggle off.

Scenario 2: In the Microsoft admin center, you set the meeting effectiveness survey feature to default-off.

The first time people in your organization use the Viva Insights app, they get a notification asking whether they want to start using meeting effectiveness surveys. On their Settings > Effective meetings page, the toggle for Meeting effectiveness surveys is switched off. If people want to start using the surveys, they can switch the settings toggle on, or select Get started on the first-use notification.

Scenario 3: You used a PowerShell cmdlet to disable access to the meeting effectiveness survey feature.

People in your organization don't receive any notifications about meeting effectiveness surveys. When they go to their Settings > Effective meetings page in the Viva Insights app in Teams or on the web, they don't see a toggle to turn on or off the feature.

Next steps

Applies to: Insights Administrator