Before You Begin

You will need the following:

• Admin/Organization-level access to an active Webex account with the ability to approve Service Apps.
• An active Maptician Account Admin user who has access to your Maptician environment. This only applies if you are configuring the integration on your own without assistance from Maptician.

What scope level access does the Maptician Service App require?

• spark:kms: This scope is a required permission and one that is automatically added by Webex.
• meeting:admin_schedule_write: Create, manage, or cancel meetings of all Webex users of your organization
• meeting:admin_schedule_read: Retrieve meetings of all Webex users of your organization
• meeting:admin_preferences_read: Retrieve Webex meeting preferences of all Webex users of your organization

Please see Webex's API Overview documentation for additional details about the scope levels being used. 

Create Custom Maptician Service App in Webex

1. Preferably, have an Organization Admin navigate to Webex Developer > My Apps and log in: https://developer.webex.com/my-apps
2. Click the Create a New App button
3. Select the Create a Service App button
4. Complete the following required fields:
   • App name: Enter a name such as Maptician Webex Integration
   • Icon: The image file must be exactly 512px by 512px in .jpeg or .png format.
     • Here is a downloadable Maptician logo if needed.
   • Description: Enter a description of the application. 
     • Example: 
   • Contact Email: Add an email that can be used for your company's internal contact information.
   • Scopes: Enable the following access levels required for the custom Maptician service app.
     • meeting:admin_schedule_write: Create, manage, or cancel meetings of all Webex users of your organization
     • meeting:admin_schedule_read: Retrieve meetings of all Webex users of your organization
     • meeting:admin_preferences_read: Retrieve Webex meeting preferences of all Webex users of your organization

5. Click Add Service App at the bottom of the page
6. Once the app has been created, copy and store the following values in a safe place for later use:
   • Service App ID
   • Client ID
   • Client Secret
   • Bearer token: This value can be found by selecting the profile avatar in the upper-right corner.

7. Optional: If you are a non-Organizational Admin creating this custom Service Application, click the Request admin authorization button at the top of the screen

Webex Admin Service App Approval

The following steps will have to be performed by an organizational admin from the Webex Control Hub.

1. Navigate to the admin Webex Control Hub at https:/​/​admin.webex.com, and log in
2. Open the Apps section and click Service Apps
3. Using the search field, search for the custom app using the Service App ID.
4. Select the row where the app appears, and a right-side drawer should appear
5. Enable the Authorized setting so it's toggled on
   • You may notice that an additional scope access level has been added, called spark:kms. This scope is a required permission and one that is automatically added by Webex.

6. Now open the Account > Info section in the Control Hub
7. Copy the Organization ID value

Using Webex in Maptician

Step 1: Configure Webex Credentials 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 > Webex Integration.
3. Select the Enable Webex Integration checkbox to enable the setting.
4. Fill out the remaining form fields:
   • Service App ID
   • Client ID
   • Client Secret
   • Org ID
5. Click Save Changes.

6. Once the save is successful, click the Connect Webex button.
7. Paste in your Bearer token/Personal Access Token (PAT) and click Connect.
8. This may take a few seconds to connect, but once connected, a status message should appear above the group of buttons with "Webex Integration Active".

Step 2: (Optional) Set Default Webex Meeting Options

Now that you have your Webex Service App set up, you can configure your environment's default Webex meeting options by clicking the Open Webex Global Config button so that when users are creating a reservation and adding a Webex meeting, these are the default settings.

After configuring the desired default global Webex meeting options, don't forget to click the Set button.

Step 3: Create a Webex 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 Webex Meeting option​
4. Click Reserve Room

The reservation email you receive should have a Webex Meeting invite (example shown below):