Requirements

Before Beginning

Ensure you have the following:

1. A Zoom Rooms Compute and Zoom Room Controller that have been tested with the Q-SYS Room Control Application for Zoom Rooms
   1. Awareness | Zoom Rooms Tested Third-Party Controllers
2. A Q-SYS Core processor that is connected to the same network as the Zoom Room Compute and Controller device
   1. Verify that Q-Sys Designer software is on version 9.10.1 or higher
   2. The Q-SYS Control for Zoom Rooms App employs web-based technology to transmit the UCI to the Zoom Room Controller. It requires an internet connection to access the website https://control-zr.qsys.com and must have the capability to resolve this URL.
3. Access to Zoom Rooms administrator account
   1. An administrator account with Marketplace role and edit permissions is required to add apps from the Zoom App Marketplace.
   2. An administrator has enabled Zoom Apps on the account.
      1. Log in to the Zoom Web Portal and go to Account Management -> Account Settings -> Zoom Apps and enable Zoom Apps Quick Launch Button.
      2. More info from Zoom click here.

Initial Zoom Rooms and Q-Sys Configuration

Complete each step before continuing down the page:

1. Create and install a certificate on a Q-SYS Core to enable secure connections for Zoom and Google Third-Party controls, OR prepare to utilize an alternative connection method, such as the IP address or domain name of the core
   1. How To | Create a Certificate for Third-Party Controls on UC Platforms (required method for iOS devices)
   2. Awareness | Zoom Rooms Third-Party Controls Alternate Connection Methods
2. Create your UCI for Zoom Room Room Controls. We strongly recommend utilizing the Zoom CSS Design found in Q-Sys Asset Manager
   1. How To | Utilize the Zoom CSS Design from Asset Manager
3. Create a UCI link from your Q-Sys Core, this information will be entered in your Zoom Rooms Admin Portal
   1. How To | Create a UCI Link for Zoom Rooms Third-Party Controls

Procedure

1. Sign in to the Zoom App Marketplace as an admin or owner.
2. Search for the Q-SYS Room Control App to add users on your account or click here.
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. 

9. Select the proper Zoom Room that you want to configure 
10. Click the Room Settings text at the top center of the screen. 

11. Select the Devices tab on the left side of the screen, and scroll down until you see Enable Room Controls.

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

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

15. In the “Auth Token” field paste the token that you received when creating a UCI Link. Then Paste the UCI Link URL you copied when creating a UCI Link into the Web UI URL field (This should contain the IP address, or the Fully Qualified Domain Name, of the Q-SYS Core). 
    1. Review if needed: How To | Create a UCI Link for Zoom Rooms Third-Party Controls
16. Paste the IP address, or 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). After clicking the Plus icon, the IP address or domain name of the core will appear below this field
    1. Example:

17. Check the box that says “Allow Unverified Connections”. This box can remain unchecked if you have uploaded the proper Security Certificate. 
18. In the Web UI click the Save button. 
19. It may take a few minutes for the settings to initiate in the Zoom App. Reboot or Relaunch the Zoom Room Controller device to fetch the configuration.
20. You should now be able to view the Q-SYS UCI control on your Zoom Room controller by pressing the Room Controls icon.