How To | Enable Third-Party Controls in Zoom Rooms

Learn how to enable third-party controls in Zoom Rooms with this comprehensive guide.

Updated at January 23rd, 2024

Your engagement helps us create the content you need. Click here to review this article.



Requirements


Physical Components

  • Zoom Room Compute and supported Zoom Room Controller
  • Q-SYS Core processor connected to the same network as the Zoom Room compute device
  • Ensure that the Q-SYS Core and Zoom Room Compute are connected to the same network

Software Components

  • Q-SYS Designer Software v9.10 or higher

Procedure


Use the following help articles for setup of Third-Party controls on the Zoom Rooms touch panel.  These items must be completed prior to the instructions below and are required.

  1. How To | Create a Certificate for Third-Party Controls on UC Platforms
  2. How To | Utilize the Zoom CSS Design from Asset Manager
  3. How To | Create a UCI Link for Zoom Rooms Third-Party Controls

Setting up Third-Party Controls in the Zoom Admin Dashboard

  1. Sign in to the Zoom App Marketplace as an admin or owner.
  2. Search for the Q-SYS Room Control App to add for users on your account.
  3. To the right of the app name, click Add.
    The app authorization page is displayed, providing details on required app permissions.
  4. At the top of the page under the As an admin, add __ for section, choose one of the following options:
    1. All users: Add this app for all users on your account.
    2. Users: Search for and select one or more users on your account to add this app for.
    3. Myself: Add this app for only yourself.
  5. (Optional) Deselect the Send email notifications to users I’ve added checkbox to prevent Zoom from sending an email notification to the users you are adding the app for. By default, this option is selected.
  6. Click Allow to authorize the app for the selected user(s).
    Once added, users will see a notification in the desktop client and potentially receive an email notification from Zoom.
  7. Once the Q-SYS Room Control App is added use a account that manages or has access to your Zoom Room devices. 
  8. Click on Room Management > Zoom Rooms. 

  1. Select the proper Zoom Room to configure 
  2. Click the Room Settings text at the top center of the screen. 

  1. Scroll down until you see Enable Room Controls.

 

  1. Enable the Room Controls and under the added apps section select the Q-SYS Room Control App. 

  1. Select the Configure App text on the Q-SYS Room Control App. 
  2. In the Popup window select Authorization Bearer Token as the Authorization method.

  1. In the Auth Token field paste the token that you received when creating a UCI Link. 
  2. Paste the UCI Link URL you copied in step 1into the Web UI URL field (This should contain the fully qualified domain name not the IP of the Q-SYS Core). 
  3. Paste the FQDN (Fully Qualified Domain Name) of the Q-SYS Core in the Additional Allowed Domains field of the Web UI and click the Plus icon. (This must match the UCI URL FQDN and be all lowercase) 

  1. The Allow Unverified Connections can remain unchecked as long as you have uploaded the proper Security Certificate. 
  2. In the Web UI click the Save button. 
  3. It may take a few minutes for the settings to initiate in the Zoom App. A Reboot or Relaunch of the Zoom Room Controller device to fetch the configuration.
  4. You should now be able to view the Q-SYS UCI control on your Zoom Room controller by pressing the Room Controls icon.