Before you Start

Before starting there are a few things you will need:​

• Admin access to your Microsoft Entra ID (Azure) environment.​
• Account Admin access to your Maptician environment.  This only applies if you are configuring the integration on your own without assistance from Maptician.​
• IMPORTANT! - Non-admin user Permission Groups require the Reservation permission “Group members can create online meetings (Teams/Zoom)” to be enabled to have the ability to create a Teams meeting in Maptician.​

Getting Started

Step 1: Add the Required Azure Graph API Permission​

1. ​In Microsoft Entra ID (Azure) browse to the App registrations and open your Maptician Graph API application.​
2. Add the following API Permission: OnlineMeetings.ReadWrite.All​
3. Grant admin consent to this new API permission

Step 2: Configure Teams Integration in your Maptician Environment​

1. Go to the settings cog in the upper right corner of the screen.​
2. In the Maptician Settings panel, select the Environment tab and then the MSFT Teams Integration tab.​
3. In the Microsoft Teams Integration panel, select the Enable Teams Integration setting.​
4. OPTIONAL: Enable any of the additional Teams Meeting Settings
   1. Use organization's default Teams lobby bypass policy: Enable this setting if you want your Teams meetings to follow the lobby bypass policy configured in your Teams Admin Center. If left unchecked, you can set the Lobby Bypass setting by following the Configure Default Teams Meeting Options part of this article.
   2. Enable Teams Meeting by Default for Reservations: Turn on this setting to automatically enable the Create Teams Meeting option for any new reservation being created.
5. Click the green SAVE CHANGES button.​

Clicking the blue CHECK CONNECTION button will validate your environment's connection to Microsoft Entra ID (Azure).

Step 3:  Run the Maptician Teams Integration PowerShell Script​

Download the Maptician Teams PowerShell Script and follow the directions below.

• If you have issues downloading this file, please contact your Maptician technical contact.​

# Define Variables
$AppId = "YOUR_APP_ID" # Replace with the actual Application (Client) ID from
Maptician or Azure AD App Registration
$PolicyName = "MapticianTeamsIntegrationPolicy"
$PolicyApproach = 1 # Select 1 for Global, 2 for Adding to Existing Policy, 3 for Assigning to a Group. Refer to comments in switch cases below for more details
$GroupName = "YourGroupName" # If $PolicyApproach is 3, replace this with the actual Group Name to which the policy should be assigned.

 Identity :Global
 AppIds :{d945f3c4-b6d4-4fdb-864a-bbb931ae9eca} 
 Description: Integration Policy for Maptician with Teams Meetings

 Identity :Tag:MapticianTeamsIntegrationPolicy
 AppIds: {d945f3c4-b6d4-4fdb-864a-bbb931ae9eca}
 Description :Integration Policy for Maptician with Teams Meetings

 Identity    : Global 
 AppIds      : {} 
 Description :

Step 4:  Creating a Teams Meeting in Maptician​

1. Open a room calendar from within one of your maps.​
2. Select a date and time for the reservation.​
3. Toggle on the “Create Teams Meeting” option.​
4. Click Reserve Room.  The reservation email you receive should contain a Teams meeting invite (example shown below).​

Configure Default Teams Meeting Options

Now that you have your Teams integration set up, you are now able to configure your environment's default Teams meeting options. Follow the steps below to set this up:

1. ​Open a room calendar from within one of your maps
2. Select a date and time for the reservation​
3. Toggle on the “Create Teams Meeting” option​
4. Click the settings cog icon
5. Configured the meeting options how you desire
   1. If the Use organization's default Teams lobby bypass policy environment setting is disabled, you will have the ability to set your desired Lobby Bypass Scope here.
6. Click the “Save as Default” button
7. After saving your default settings, refresh your page and start a new reservation to confirm the options are set correctly.