Zoom Meetings Setup Guide

This article will guide you through how to configure Maptician to integrate with Zoom Meetings.

+ More

Table of Contents

Before You Begin Create Zoom Meetings Permissions Create Zoom App ↳Option A: Use Only the Required Scopes ↳Option B: Enable All Available Granular Scopes Enable Zoom in Maptician Step 1: Configure Zoom Integration in Maptician Confirm the Zoom connection works in Maptician Step 2: (Optional) Configure additional Zoom settings in Maptician Step 3: Creating a Zoom Meeting in Maptician Configure Default Zoom Meeting Options

Before You Begin

You will need the following:

Zoom account with Admin access
Account Admin access to your Maptician environment. This only applies if you are configuring the integration on your own without assistance from Maptician

Create Zoom Meetings Permissions

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

Create Zoom App

Sign in to Zoom.
Browse to https://marketplace.zoom.us/develop/create
Choose the Server-to-Server OAuth app and click Create.
Enter a name for the app, such as “Maptician Zoom Integration”, and click Create.
In the App Credentials section, copy and save the Account ID, Client ID, and Client Secret. These will need to be added to Maptician in a later step. Click Continue.

In the Information section, enter a Company Name, Developer Name, and Email (Zoom requires this information to be entered) and click Continue.

💡 TIP

For the Developer Name, we recommend using a generic name that puts your company’s name with a description of the integration (e.g., “[Your Company Name] Zoom Integration”) rather than the name of a person.,

For the Email, use a shared or service account within your organization’s domain (e.g., zoom-integration@[yourcompany].com). This ensures that Zoom notifications (such as meeting cancellations) are tied to a neutral integration account instead of showing a specific employee’s identity.

In the Feature section, click Continue. The tokens do not need to be recorded.

In the Scopes section:
1. Click the Add Scopes button.
2. In the search box type Meeting and then select the Meeting Product option.
3. Click on the Select All dropdown, and click on Select All (Admin)
4. Optionally, select any additional available scopes that are needed for your integration (see Option B below).
5. Select Done.

ℹ️ NOTE

Zoom now offers a large list of granular scopes. You can enable only the scopes required for Maptician or you can enable all available scopes if you prefer the broadest coverage to avoid any loss of functionality. Below are the two options you can choose from.

↳Option A: Use Only the Required Scopes

These are the scopes originally required by Maptician:

meeting:write:registrant:admin: Add a registrant to a meeting (meeting)
meeting:write:open_app:admin: Add an open app to a meeting (meeting)
meeting:write:batch_registrants:admin: Add registrants to a meeting (meeting)
meeting:write:meeting:admin: Create a meeting for a user (meeting)
meeting:write:template:admin: Create a meeting template from an existing meeting (meeting)
meeting:write:poll:admin: Create a poll for a meeting (meeting)
meeting:write:invite_links:admin: Create invite links for a meeting (meeting)
meeting:write:batch_polls:admin: Create polls for a meeting (meeting)
meeting:delete:meeting:admin: Delete a meeting (meeting)
meeting:delete:poll:admin: Delete a meeting poll (meeting)
meeting:delete:survey:admin: Delete a meeting survey (meeting)
meeting:delete:live_meeting_chat_message:admin: Delete a message in a live meeting (meeting)
meeting:delete:open_app:admin: Remove a meeting open app (meeting)
meeting:delete:registrant:admin: Remove a meeting registrant (meeting)
meeting:update:meeting:admin: Update a meeting (meeting)
meeting:update:registrant_status:admin: Update a meeting registrant status (meeting)
meeting:update:in_meeting_controls:admin: Update a meeting in meeting control (meeting)
meeting:update:livestream:admin: Update a meeting livestream information (meeting)
meeting:update:livestream_status:admin: Update a meeting livestream status (meeting)
meeting:update:poll:admin: Update a meeting poll (meeting)
meeting:update:registration_question:admin: Update a meeting registration question (meeting)
meeting:update:status:admin: Update a meeting status (meeting)
meeting:update:survey:admin: Update a meeting survey (meeting)
meeting:update:live_meeting_chat_message:admin: Update a message in a live meeting (meeting)
meeting:read:meeting:admin: View a meeting (meeting)
sip_phone:write:sip_phone:admin: Create a Sip Phone on Zoom (sip phone)
sip_phone:delete:sip_phone:admin: Delete a Sip Phone on Zoom (sip phone)
sip_phone:update:sip_phone:admin: Edit a Sip Phone on Zoom (sip phone)
sip_phone:read:list_sip_phones:admin: List all Sip Phones (sip phone)
meeting:write:sip_dialing:admin: Get a meeting SIP URI with passcode (meeting)
webinar:write:sip_dialing:admin: Get a webinar SIP URI with passcode (webinar)

↳Option B: Enable All Available Granular Scopes

If you want the broadest possible coverage you can select every permission within your custom Zoom application for Maptician. This includes every permission from Option A and every granular permission listed below. You can do this quickly by choosing the “Select All (Admin)” option in the Zoom scope selector (seen in screenshot below).

IMPORTANT: Zoom manages and maintains the full set of available scopes and may update or change them at any time. New scopes may be added and existing scopes may be adjusted or removed. Because of this the list below may not always match the current scope set shown in your Zoom configuration.

For additional details on Zoom’s Granular API settings you can review their documentation here: Integrations - Granular scopes

All Granular Scopes

Archiving

archiving:read:list_archived_files:admin: Get an account archived meeting or webinar files (archiving)
archiving:read:archived_files:admin: Return a specific meeting instance archived files (archiving)

Device Management

device:write:zdm_device:admin: Add device (device)
device:write:zpa_device:admin: Assign device (device)
device:read:user_setting:admin: Get user ZPA device list and profile setting (device)
device:read:list_zpa_versions:admin: List ZPA versions (device)
device:write:vendor_device:admin: Manage vendor device (device)
device:write:vendor_import_result:admin: Manage vendor device import result (device)
device:update:zdm_device_assignment:admin: View Zoom Device Management devices (device)
device:delete:zpa_device:admin: Delete ZPA device (device)
device:delete:zdm_device:admin: Delete device (device)
device:read:command:admin: Device command (device)
device:write:group:admin: Device group change (device)
device:read:import_device:admin: Import device (device)
device:read:list_zdm_devices:admin: List devices (device)
device:read:list_groups:admin: List groups (device)
device:read:zdm_device:admin: Read device (device)
device:update:zdm_device:admin: Update device (device)
device:write:zpa_os_app:admin: Upgrade device (device)

Meeting Reading Scopes

meeting:read:token:admin: View a meeting closed caption token caption URL (meeting)
meeting:read:past_qa:admin: List Q and A of a specific meeting (meeting)
meeting:read:risk_alert:admin: View a meeting at risk (meeting)
meeting:read:live_streaming_token:admin: View a meeting live streaming join token (meeting)
meeting:read:local_archiving_token:admin: View a meeting local archiving join token (meeting)
meeting:read:local_recording_token:admin: View a meeting local recording join token (meeting)
meeting:read:participant_callout:admin: View a meeting participant callout (meeting)
meeting:read:participant_feedback:admin: View a meeting participant feedback (meeting)
meeting:read:alert:admin: View a meeting alert (meeting)
meeting:read:chat_message:admin: View a meeting chat message (meeting)
meeting:read:device:admin: View a meeting device test result (meeting)
meeting:read:invitation:admin: View a meeting invitation (meeting)
meeting:read:livestream:admin: View a meeting livestream information (meeting)
meeting:read:participant:admin: View a meeting participant (meeting)
meeting:read:participant_sharing:admin: View a meeting participant sharing detail (meeting)
meeting:read:poll:admin: View a meeting poll (meeting)
meeting:read:list_polls:admin: View a meeting polls (meeting)
meeting:read:registrant:admin: View a meeting registrant (meeting)
meeting:read:list_registrants:admin: View a meeting registrants (meeting)
meeting:read:list_registration_questions:admin: View a meeting registration questions (meeting)
meeting:read:list_summaries:admin: View a meeting summaries (meeting)
meeting:read:summary:admin: View a meeting summary (meeting)
meeting:read:survey:admin: View a meeting survey (meeting)
meeting:read:past_meeting:admin: View a past meeting (meeting)
meeting:read:list_past_instances:admin: View a past meeting instances (meeting)
meeting:read:list_past_participants:admin: View a past meeting participants (meeting)
meeting:read:list_poll_results:admin: View a past meeting polls (meeting)
meeting:read:list_templates:admin: View a user meeting templates (meeting)
meeting:read:list_meetings:admin: View a user meetings (meeting)
meeting:read:list_upcoming_meetings:admin: View a user upcoming meetings (meeting)
meeting:read:ai_companion:admin: View all user meetings (meeting)

Meeting Management and Write Scopes

meeting:delete:summary:admin: View and manage all user meeting summaries (meeting)
meeting:update:participant_rtms_app_status:admin: View and manage all user meetings (meeting)

PAC

pac:read:list_pac_accounts:admin: View a user PAC accounts (pac)

Tracking Fields

tracking_field:write:tracking_field:admin: Create a tracking field (tracking field)
tracking_field:delete:tracking_field:admin: Delete a tracking field (tracking field)
tracking_field:update:tracking_field:admin: Update a tracking field (tracking field)
tracking_field:read:tracking_field:admin: View a tracking field (tracking field)
tracking_field:read:list_tracking_fields:admin: View tracking fields (tracking field)

TSP

tsp:write:tsp_account:admin: Add a TSP account to a user (tsp)
tsp:delete:tsp_account:admin: Delete a user TSP account (tsp)
tsp:read:tsp:admin: Get an account TSP information (tsp)
tsp:update:tsp_account:admin: Update a user TSP account (tsp)
tsp:update:tsp_settings:admin: Update a user TSP global dial in URL (tsp)
tsp:update:tsp:admin: Update an account TSP information (tsp)
tsp:read:tsp_account:admin: View a user TSP account (tsp)
tsp:read:list_tsp_accounts:admin: View a user TSP accounts (tsp)

Webinar Write and Management

webinar:write:registrant:admin: Add a registrant to a webinar (webinar)
webinar:write:panelist:admin: Add panelists to a webinar (webinar)
webinar:write:batch_registrants:admin: Add registrants to a webinar (webinar)
webinar:write:poll:admin: Create a poll for a webinar (webinar)
webinar:write:webinar:admin: Create a webinar for a user (webinar)
webinar:write:template:admin: Create a webinar template from an existing webinar (webinar)
webinar:write:branding_name_tag:admin: Create a webinar branding name tag (webinar)
webinar:write:invite_links:admin: Create invite links for webinars (webinar)
webinar:delete:live_webinar_chat_message:admin: Delete a message in a live webinar (webinar)
webinar:delete:webinar:admin: Delete a webinar (webinar)
webinar:delete:branding_virtual_background:admin: Delete a webinar branding virtual background (webinar)
webinar:delete:branding_name_tag:admin: Delete a webinar branding name tag (webinar)
webinar:delete:branding_wallpaper:admin: Delete a webinar branding wallpaper (webinar)
webinar:delete:poll:admin: Delete a webinar poll (webinar)
webinar:delete:survey:admin: Delete a webinar survey (webinar)

Webinar Reading

webinar:read:token:admin: Get a webinar closed caption token caption URL (webinar)
webinar:read:branding:admin: Get webinar session branding (webinar)
webinar:delete:panelist:admin: Remove a webinar panelist (webinar)
webinar:delete:registrant:admin: Remove a webinar registrant (webinar)
webinar:update:branding_virtual_background:admin: Set a webinar default branding virtual background (webinar)
webinar:update:webinar:admin: Update a webinar (webinar)
webinar:update:registrant_status:admin: Update a webinar registrant status (webinar)
webinar:update:branding_name_tag:admin: Update a webinar branding name tag (webinar)
webinar:update:livestream:admin: Update a webinar livestream information (webinar)
webinar:update:livestream_status:admin: Update a webinar livestream status (webinar)
webinar:update:poll:admin: Update a webinar poll (webinar)
webinar:update:registration_question:admin: Update a webinar registration questions (webinar)
webinar:update:status:admin: Update a webinar status (webinar)
webinar:update:survey:admin: Update a webinar survey (webinar)
webinar:write:branding_virtual_background:admin: Upload a webinar branding virtual background (webinar)
webinar:write:branding_wallpaper:admin: Upload a webinar branding wallpaper (webinar)

Webinar Past Data and Insights

webinar:read:past_qa:admin: View a past webinar Q and A (webinar)
webinar:read:list_absentees:admin: View a past webinar absentees (webinar)
webinar:read:list_past_instances:admin: View a past webinar instances (webinar)
webinar:read:list_past_participants:admin: View a past webinar participants (webinar)
webinar:read:list_past_polls:admin: View a past webinar polls (webinar)

Webinar Lists and Details

webinar:read:list_templates:admin: View a user webinar templates (webinar)
webinar:read:list_webinars:admin: View a user webinars (webinar)
webinar:read:webinar:admin: View a webinar (webinar)
webinar:read:live_streaming_token:admin: View a webinar live streaming join token (webinar)
webinar:read:local_archiving_token:admin: View a webinar local archiving join token (webinar)
webinar:read:local_recording_token:admin: View a webinar local recording join token (webinar)
webinar:read:participant_feedback:admin: View a webinar participant feedback (webinar)
webinar:read:alert:admin: View a webinar alert (webinar)
webinar:read:chat_message:admin: View a webinar chat message (webinar)
webinar:read:livestream:admin: View a webinar livestream information (webinar)
webinar:read:list_panelists:admin: View a webinar panelists (webinar)
webinar:read:participant:admin: View a webinar participant (webinar)
webinar:read:participant_sharing:admin: View a webinar participant sharing detail (webinar)
webinar:read:poll:admin: View a webinar poll (webinar)
webinar:read:list_polls:admin: View a webinar polls (webinar)
webinar:read:registrant:admin: View a webinar registrant (webinar)
webinar:read:list_registrants:admin: View a webinar registrants (webinar)
webinar:read:list_registration_questions:admin: View a webinar registration questions (webinar)
webinar:read:survey:admin: View a webinar survey (webinar)
webinar:read:list_tracking_sources:admin: View a webinar tracking sources (webinar)
webinar:read:jointoken_3rd_recording:admin: View a webinar join token for third party recording (webinar)
webinar:write:resource_document:admin: Write webinar resource document (webinar)

In the Scopes section, you will be displayed a list of Meeting Scopes that you added in the previous step. Click the Continue button to activate the app.
In the Activation section, click on Activate your app. If activation is successful, it will display a confirmation message that Your app is activated on the account.

Enable Zoom in Maptician

Step 1: Configure Zoom Integration in Maptician

As an Account Admin, click the settings button (gear icon) in the top-right corner of the screen.
Go to Environment > Zoom Integration.
Enter your Zoom Account ID, Client ID, and Client Secret that you previously created in Step 3 under Getting Started above.
Select the Enable Zoom Integration checkbox to enable the setting.
Click Save Changes

Confirm the Zoom connection works in Maptician

Click the Check Connection button to validate your environment's connection to the Zoom API is configured correctly.

Step 2: (Optional) Configure additional Zoom settings in Maptician

Go to Environment > Zoom Settings.
- Send Zoom cancellation emails to Zoom meeting organizer when meetings are cancelled: Enable this setting to have Zoom send its standard cancellation notification email to the meeting organizer any time a Zoom meeting created via the integration is cancelled. If disabled, Zoom will not send a cancellation email to the organizer.
- Include SIP join information in Zoom meeting email/calendar details: Enable this setting to include Zoom’s SIP join details in the meeting invite content (email/calendar body). This is useful for SIP/H.323 room systems or SIP-based conference devices that join meetings via SIP URIs.
- Include one-tap mobile numbers in Zoom meeting email/calendar details:Enable this setting to add one-tap dial options to the invite content so mobile users can tap a phone number and automatically dial in with the meeting ID (and passcode, if applicable), instead of manually entering them.
  - Primary Dial-in Countries (comma-separated): Comma-separated list of ISO 3166-1 alpha-2 country codes (example: US,CA).
  - Primary Dial-In Type:Optionally restrict the primary dial-in numbers shown in the invite to a specific type:
        •    No Preferences – Zoom can include any available dial-in numbers
        •    Toll – Show toll dial-in numbers only
        •    Toll-free – Show toll-free dial-in numbers only
  - Max Primary Dial-In Numbers: Set the maximum number of “primary” dial-in phone numbers to include in the invite’s dial-in/one-tap section (for example, 3). Additional available numbers (if any) may be omitted from the invite content to keep it concise.

Step 3: Creating a Zoom Meeting in Maptician

Open a room calendar from within one of your maps.
Select a date and time for the reservation.
Toggle on the Create Zoom Meeting option.
- Clicking the settings icon will open up the available Zoom options that can be set prior to creating the reservation.
Click Reserve Room.

The reservation email users receive should contain a Zoom meeting invite (example shown below) where the full join link URL should be in the format of https://us50web.zoom.us/j/<meeting_id>?pwd=<HashedPasscode>.

Configure Default Zoom Meeting Options

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

Open a room calendar from within one of your maps
Select a date and time for the reservation
Toggle on the “Create Zoom Meeting” option
Click the settings cog icon
Configured the meeting options as you desire
Click the “Save as Default” button
After saving your default settings, refresh your page and start a new reservation to confirm the options are set correctly.