Using the Zoom EMS app with 25Live

Zoom’s Event Management System (EMS) creates Zoom meetings and integrates with other apps in the Zoom marketplace based on third-party event management systems. These marketplace apps process the meetings using the data configured in the tracking fields.

Requirements for using Zoom’s Event Management System 

• Account owner or admin privileges
• LTI Pro has been installed and configured if integrating with LMS

How to add the Zoom EMS app

1. Sign in to the Zoom Marketplace.
2. At the top of the screen, in the search bar, type Zoom EMS and click the enter key. 
3. Click on the Zoom EMS app.
4. Click Add.
5. Confirm the permissions the app requires, then click Allow.

Once the app has been authorized, the Event Management Configuration page will be displayed. 

How to configure the Zoom EMS App with 25Live

Custom attributes needed for configuration

The following custom attributes will need to be created within 25live before integrating with the Zoom EMS app.

The following Event Custom attributes will need to be configured and utilized when scheduling events:

• zm_auto_recording (Boolean type)
• zm_lti_webhook_meeting_domain (String type)*
• zm_lti_webhook_meeting_context_id (String type)*

Note: These attributes are only necessary if importing meetings into LTI Pro. 

The following Location Custom attributes will need to be configured and utilized when scheduling events:

• zm_alternative_hosts (String type)

Integrate 25Live within the Zoom EMS app

1. Navigate to the Zoom EMS app.
2. Scroll to the bottom of the page and click Configure App.
3. In the Settings tab, enter the following information:
   • Username: Enter your 25Live username. 
   • Password: Enter your 25Live password.
   • Organization: Enter the name of your organization.
   Note: A service account is recommended.
4. Under Space Custom Attributes, click [plus symbol].
5. Enter the following information for the attribute:
       

   Name	ID	Type	Required
   zm_alternative_hosts	Enter the Id generated in 25Live	Meeting Option	Enabled

    
6. Under Event Custom Attributes, click [plus symbol].
7. Enter the following information for an attribute, then click [plus symbol] to add the next:       

   Name	ID	Type	Required
   zm_auto_recording	Enter the Id generated in 25Live	Meeting Option	Enabled
   zm_lti_webhook_meeting_domain	Enter the Id generated in 25Live	Tracking Field
   zm_lti_webhook_meeting_context_id	Enter the Id generated in 25Live	Tracking Field

    
8. Click Save.
   You will automatically be redirected to the Messages tab. Events will be displayed with info from the integration app with 25Live.
9. Refresh the page until an event is displayed saying “Configuration setup complete”.
10. Click the Settings tab and verify it says Auto-sync job is created for your account. 

The auto-sync job will be triggered every 30 minutes to convert events created in 25Live to Zoom meetings. However, to sync events manually, at the bottom of the page click Sync.

How to use 25Live with Zoom EMS Integration

Create an event within 25Live

1. Log into 25Live with the account used to connect the Zoom EMS app in the previous steps.
2. Navigate to the Create Event page.
3. Enter the following information:
   • Event Name: Enter the name for the event.
   • Event Type: Select Meeting.
   • Primary Organization: Select your organization.
4. Under Date and Time, enter the start and end time for the event. 
5. (Optional) If creating a recurring event, under Additional time, click Repeating Pattern.
6. Under Pattern Picker, click the repeating schedule type.
   Note: The Zoom EMS integration only supports Daily, Weekly, or Monthly schedules.
7. Under Locations, search and select your desired location.
   Note: For the Zoom EMS integration, the location will need to have been configured with the zm_alternative_hosts attribute.
8. Under Custom Attributes, click Add a Custom Attribute. 
9. In the dropdown, select zm_auto_recording, and set the attribute to Yes or No.
10. (Optional) If integrating with LTI Pro:
11. Click Add a Custom Attribute.
12. In the dropdown, select zm_lti_webhook_meeting_context_id, and enter the context ID for your LTI Pro instance.
13. Click Add a Custom Attribute.
14. In the dropdown, select zm_lti_webhook_meeting_domain, and enter the domain for LTI Pro instance. 
15. Under Contact Roles, for Scheduler select the user who will be hosting the meeting.
    Note: The Scheduler’s emails should be the same email address utilized for their Zoom use profile.
16. Click Save.

Retrieve Context ID for LTI Pro

Note: These steps are only necessary if utilizing the LTI Pro app.

LTI 1.1

1. Log into your LMS.
2. Within your browser open the dev tools.
3. Navigate to the Network tab.
4. Search and click on rich. 
5. Click the Payload tab.
6. Copy and save the context_id. 

LTI 1.3

1. Log into your LMS.
2. Within your browser open the dev tools.
3. Navigate to the Network tab.
4. Search and click on complete. 
5. Click the Payload tab.
6. Copy and save the id_token.
7. Decode it using JWT.IO
8. Search for “claim/context” and copy the id (ex. "db131ef97bd5f98753e5eba61611a784922424a3")

How to uninstall the Zoom EMS app

1. Sign in to the Zoom Marketplace.
2. At the top of the screen, in the search bar, type Zoom EMS and click the enter key. 
3. Click on the Zoom EMS app.
4. Under Manage, click Remove App.
5. When prompted, click Remove.