Zoom Integration

Prev Next

This article covers how to set up the ControlUp for Desktops Zoom integration for Unified Communications Monitoring.

Prerequisites

To set up the integration with ControlUp, you need Admin permissions on your company Zoom account.

Zoom API access and rate limits

Some Zoom account types may not support the required API access. It is also possible that you can exceed your API rate limit if you have a lot of Zoom meetings. Learn more about Zoom API rate limits for different Zoom account plans.

Step 1 - Create the application in Zoom

  1. Sign in to the Zoom Marketplace with an account that has developer access.

  2. In the Zoom Marketplace, click Build App.

    Build App button on the Zoom App Marketplace.

  3. Select Server-to-Server OAuth and click Create.

    Selecting Server to Servier OAuth App.

  4. Enter a name for the app and click Create. You can choose any name you like.

Step 2 - Copy application credentials to ControlUp

After you create the application, the App Credentials tab contains three credentials. You must copy these values and paste them into ControlUp.Account ID, Client ID, and Client Secret values in App Credentials page.

  1. In ControlUp, go to Unified Communications > Configuration.

2. In the Zoom section, fill in the Account ID, Client ID, and Client Secret Value fields by copying the pasting the values from Zoom. Do not click Configure.Add Account ID, Client ID, and Client Secret Value to ControlUp Zoom settings

Step 3 - Configure event subscriptions in Zoom

  1. In the Zoom app configuration page, go to the Information tab and fill in all of the fields.

    Zoom app configuration Information page.

  2. Go to the Feature tab and enable the Events Subscriptions toggle.

    Enable the Event Subscriptions toggle.

  3. Click Add Event Subscription.

    Click the Add Event Subscription button.

  4. Copy the Webhook URL from the Zoom integration setup page in ControlUp and paste it into the Event notification endpoint URL field.

    Webhook URL in ControlUp Zoom settings.

    Event notification endpoint URL field in Zoom app configuration.

  5. Enter a forward slash ( / ) after the Webhook URL that you just pasted into the Event notification endpoint URL field.

  6. Copy the Secret Token and paste it after the forward slash ( / ) you entered into the Event notification endpoint URL field.

    Secret Token field in Zoom app configuration.

  7. Click Validate to ensure that you entered the URL correctly.

    Validate button in Zoom app configuration.

  8. Click Add Events.

    Add Events button in Zoom app configuration.

  9. Add the End Meeting event from the Meeting tab.

    End Meeting selected from the Meeting event type category.

  10. Click Save to save your Event Subscription settings.

Step 4 - Configure scopes/permissions in Zoom

  1. In the Zoom app configuration page, go to the Scopes tab and click Add Scopes.

    Add Scopes button in the Scopes section of the Zoom app configuration.

  2. Select the following scopes:

    • dashboard:read:list_meeting_participants:admin

    • dashboard:read:post_meeting_feedback:admin

    • dashboard:read:list_meetings:admin

    • dashboard:read:list_meeting_participants_qos:admin

    • dashboard:read:meeting:admin

      The final list of scopes should look like this:

      scopes defined above added to the Zoom app configuration.

Note for Zoom classic scopes

The permissions listed above are for Zoom Granular Scopes. If you have an existing integration, you might be using Zoom Classic Scopes. If you are using Classic Scopes, add the following scopes:



  • In the Meeting tab, select View all user meetings

  • In the Dashboard tab, select allscoped except View sub account's Dashboard data

Step 5 - Complete the integration

  1. In the Zoom app configuration page, go to the Activation tab and click Activate your app.

    Activate your app button in the Activation section of Zoom app configuration.

  2. In ControlUp, click Configure to complete the integration setup.

    Configure button in the Zoom configuration in ControlUp.