Enable the OnePlan and Microsoft Teams Integration

  • Updated

This article explains how to enable the OnePlan integration with Microsoft Teams. 

This integration allows you to set up connected Teams and/or Channels for your entire OnePlan group, or individual Plans. You can create new Teams or Channels for each Plan, or connect to existing Teams or Channels. 

To successfully enable this integration, you need to be a OnePlan administrator, and be a Microsoft tenant administrator (to enable integrations). 

Enable the OnePlan and Teams Integration

  1. Go to the Admin pages > Microsoft Teams.
  2. Click Enable Permissions.
  3. Click Accept to enable OnePlan for Teams.
  4. Again, go to the Admin pages > Microsoft Teams.
  5. Next to "Enable teams integration", click Click Here. Allow the Teams integration events to install. Once installed, you are ready to configure how you want to connect OnePlan with Teams. Banner (22).gif

What Permissions Are Granted to OnePlan?

When a Microsoft tenant administrator clicks Enable Permissions for Microsoft Teams, several Microsoft Graph permissions are granted to the OnePlan Enterprise Application within Microsoft Entra ID. These permissions allow the built-in Microsoft Teams integration to function properly.

The following Microsoft Graph permissions are granted:

  • Read and write all groups – Allows OnePlan to access and manage Microsoft 365 groups associated with Teams.

  • Read the names and descriptions of teams – Allows OnePlan to display and reference available Teams.

  • View users’ basic profile – Allows OnePlan to identify users when interacting with Teams-related functionality.

  • Maintain access to data you have given it access to – Allows the application to retain previously granted access without requiring users to re-authenticate frequently.

These permissions are granted in addition to the existing Windows Azure Directory permissions already provided to OnePlan, which include:

  • Sign in and read user profile

  • Read all users’ basic profiles

Together, these permissions enable the OnePlan Enterprise Application to securely interact with Microsoft Teams so users can access Teams functionality directly within OnePlan.

Microsoft Teams Entra Permissions .png

Team Creation Options Details

After enabling the Teams integration, a new set of configuration options will appear. 

  • Auto Create: Check this box to automatically create a new Team in Microsoft Teams every time a Plan is created. This setting only creates Plan-level Teams, and only applies to Plans created after checking the check box. 
  • Allow Creating Team: Check this checkbox to allow users manually to create Teams for Plans within Microsoft Teams. 
  • Allow Existing Team: Check this checkbox to allow users to link plans in OnePlan to existing Teams or Channels. Checking this checkbox also allows you to create new Channels within an existing Team and/or connect to existing Channels within an existing Team. 
    • Allow Creating Channel: Check this checkbox to allow users to manually create new Channels for their Plans within an existing Team. There is a 200 Channel limit per Team. 
    • Allow Existing Channel: Check this checkbox to allow users to connect their Plans to an existing Channel within an existing Team. There is a 200 Channel limit per Team. 
  • Auto Create Filter: Create a filter to determine when new Teams are created on Plan creation. You can use any available Plan-level field to create the filter. 

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.