Before You Begin

You will need the following:

• Access to your Microsoft Entra (formerly Azure AD) tenant with the ability to add and grant new API permissions.
• An active Maptician Account Admin user with access to your environment. This requirement applies only if you are configuring the integration yourself without Maptician assistance.

Create Teams Meetings Permissions

Non-admin user Permission Groups require the Reservation group permission “Group members can create online meetings (Teams/Zoom)” to be enabled, so they can add a Teams meeting when creating a reservation in Maptician.​

Configure API Permissions for Teams in Entra

From the Microsoft Entra ID home screen:

1. In the left navigation menu, under Manage, select App registrations.
2. In the App registrations list, find and select your existing app (usually named “Maptician Graph API” or similar).
3. Once in the app, go to API permissions in the left menu.
4. Click Add a permission.
5. Select Microsoft Graph.
6. Choose Application permissions.
7. Add the following permission:
   • OnlineMeetings.ReadWrite.All: allows the app to read and create online meetings as an application in your organization.
8. Click Add permissions.
9. After the permission has been added, you will want to click Grant admin consent for [Your Organization] and then confirm it.

Enable Microsoft Teams in Maptician

Step 1: Configure Teams Integration in your Maptician Environment​

1. As an Account Admin, click the settings button (gear icon) in the top-right corner of the screen.
2. Go to Environment > MSFT Teams Integration.
3. Select the Enable Teams Integration checkbox to enable the setting.
4. OPTIONAL: Enable any of the additional Teams Meeting Settings:
   • 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.
   • 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 Save Changes.

Confirm the Graph API connection works in Maptician

Click the Check Connection button to validate your environment's connection to Entra ID, and the API permissions are configured correctly on the Graph API.

Step 2:  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.​

# -----------------------------
# Variables
# -----------------------------
$AppId = "APP_ID" # Replace this with the Application (Client) ID from your Entra ID Maptician Graph API App Registration
$PolicyName = "MapticianTeamsIntegrationPolicy"
# Policy Approach:
  # 1 = Create (or update) policy and assign it globally (all users)
  # 2 = Add $AppId to an existing policy only (no assignment changes)
  # 3 = Create (or update) policy and assign it to a specific group ($GroupName)
  # Notes:
  #   - Option 2 requires that $PolicyName already exists.
  #   - Option 3 requires a valid $GroupName.
$PolicyApproach = 1
$GroupName = "Global" # Only used when $PolicyApproach = 3; replace with the target group name.
# -----------------------------

 Identity :Global
 AppIds :{d945f3c4-...} 
 Description: Integration Policy for Maptician with Teams Meetings

 Identity :Tag:MapticianTeamsIntegrationPolicy
 AppIds: {d945f3c4-...}
 Description :Integration Policy for Maptician with Teams Meetings

 Identity    : Global 
 AppIds      : {} 
 Description :

Step 3: 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.​
   • Clicking the settings icon will open up the available Teams options that can be set prior to creating the reservation. 
4. Click Reserve Room.​

The reservation email users receive should contain a Teams meeting invite (example shown below) where the full join link URL should be in the format of https://teams.microsoft.com/meet/<meeting_id>?p=<HashedPasscode>.

Configure Default Teams Meeting Options

Now that you have your Teams integration set up, you are 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 as 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.