Requirements

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
   1. Awareness | Zoom Rooms Third-Party Controls Alternate Connection Methods
2. How To | Utilize the Zoom CSS Design from Asset Manager
3. How To | Create a UCI Link for Zoom Rooms Third-Party Controls

Physical Components

• Zoom Room Compute and supported Zoom Room Controller
  • Awareness | Zoom Rooms Tested Third-Party Controllers
• Q-SYS Core processor connected to the same network as the Zoom Room Compute and Controller device
  • 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.

Software Components

• Q-SYS Designer Software v9.10.1 or higher

Zoom Components

• An administrator account with Marketplace role and edit permissions is required to add apps from the Zoom App Marketplace.
• An administrator has enabled Zoom Apps on the account.
  • Log in to the Zoom Web Portal and go to Account Management -> Account Settings -> Zoom Apps and enable Zoom Apps Quick Launch Button.
  • More info from Zoom click here.

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 for 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 to configure 
10. Click the Room Settings text at the top center of the screen. 

11. 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. 
16. Paste the UCI Link URL you copied when creating a UCI Link into the Web UI URL field (This should contain the fully qualified domain name or IP of the Q-SYS Core). 
17. 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) 

18. The Allow Unverified Connections can remain unchecked as long as you have uploaded the proper Security Certificate. 
19. In the Web UI click the Save button. 
20. 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.
21. You should now be able to view the Q-SYS UCI control on your Zoom Room controller by pressing the Room Controls icon.