Note: Starting January 18, 2021, new accounts provisioned with Cloud Room Connector licenses will automatically have access to the new enhanced API Room Connector for SIP/H.323 devices. If your account was provisioned a CRC license after January 18, use our enhanced room provisioning and management instructions.
If you have an existing Cisco or Tandberg room system in place, you can integrate its native calendaring system using the Zoom One-Tap Cisco Connector. This lets you start a scheduled Zoom meeting directly from your existing hardware. You can also start an instant meeting if the room is configured with a Personal Meeting ID, or use the room to join Zoom meetings that are not on the calendar.
- A Zoom account with a Cloud Room Connector license
- A Cisco or Tandberg system that is powered on and has all components connected, including a cable to your network and a connection to a TV screen. The system must be running TC 5.0.2 or higher or CE software to support OBTP (One Button To Push). - Learn more about supported devices and firmware
- Network access to Cloud Room Connector
- Calendar setup with Google or Exchange/O365
API Connector requirements
- A Windows PC, Server, or Virtual Machine (for installing and running the Zoom API Connector software locally
- 2 core processor
- 8 GB of Ram
- 20 GB of storage
Note: The above device requirements, support up to 200 endpoints
Associate the Zoom Connector with your network
- From your browser, sign into Zoom, and click Cisco/Polycom Rooms.
Note that if you do not already have a Cloud Room Connector license, this page provides instructions on how to purchase it.
- Click the API Connectors tab, then click Add API Connector.
- Enter the network information in the popup dialog.
By default, the range covers all possible networks that your system might be using. You can limit this to the actual network and subnet information used with your Cisco system.
Note: If you need to use multiple connectors, make sure that the network values that you specify for each connector do not overlap.
- Click Save.
The new connector, with an automatically generated Connector ID, displays in the list of API Connectors. The Connector ID, which is copied to your clipboard when it is generated, will be used in the procedure to install the Zoom API Connector software.
Install the Zoom API Connector software
The Zoom API Connector installer opens a wizard, where you enter the Connector ID (created in the previous procedure) associated with the Zoom cloud. Note that the API Connector software runs on a Windows Server or Virtual Machine.
- Sign in to the Zoom web portal.
- Click Room Management > Cisco/Polycom Rooms.
- Click the API Connectors tab, then click the Install action for the connector.
This downloads the installer for the Zoom API Connector ready for installation and copies the Connector ID to the local clipboard for your convenience.
- If the ZoomAPIConnector.msi file was downloaded using a different computer than the one your are installing on, move the file to the installation computer.
- Double-click ZoomAPIConnector.msi to open the wizard and begin the installation process.
- Use the wizard pages to accept the license agreement and specify an installation location, then click Next.
- Enter the Connector ID in the Customize this installation page of the wizard.
This is the value that was automatically generated in the procedure to associate the Zoom Connector to the network.
- Click Next, then click Install to install the Zoom API Connector software.
- After the installation is complete, click Finish to exit the wizard.
The Zoom API Connector is now associated with the network that includes the Cisco room system. The Zoom API Connector application only needs to be installed one time, regardless of how many Cisco room systems you need to configure.
Note: You must keep the Zoom API Configuration software running on a Windows Server, a Virtual Machine, or for short term testing, a Windows workstation. However, we recommend that once testing is complete, moving the API connector to a permanently running/powered on Windows environment for production.
Provision the Cisco system and calendar with Zoom cloud settings
Use the Room Connector API to populate the provisioning settings for the Cisco room system and connect it with a calendar that is accessible to the Zoom cloud.
- Sign in to the Zoom web portal.
- Click Room Management > Cisco/Polycom Rooms.
- Click the Rooms tab, and then click Add Room.
The Edit dialog displays.
- Enter the following information:
- Name - Enter the name that will be displayed on the Rooms tab of the Calendar Integration page. Note that the name of the Edit dialog changes as you type in this field.
- Type - Choose Cisco SX/MX/DX/C/EX (TC or CE Firmware)
- Serial Number - Enter the serial number for the system.
- Device Username - Enter the username if your device does not use the default value of admin.
- Device Password - Enter a password that will be used to access the Zoom integration in your Cisco system. This is typically a short numeric string, since some systems require that you enter it using a remote control
- IP Address - Enter the IP address displayed on the TV screen when the Cisco system is ready for integration with Zoom.
- Calendars - Enter at least one calendar address (either Exchange, Office 365, or Google) of the room where the Cisco system is located.
- Registration Password - The Registration Password authenticates the automatically generated Registration Username. Enter a custom password with a minimum of 6 characters, or leave this field blank to automatically generate a strong password.
- Alternative Room Connector - Change this value if you are using a Virtual Room Connector.
- Room Meeting ID - If your Cisco room system has been registered as a Zoom Room, it has an assigned Personal Meeting ID, which can be used to start instant meetings. Obtain this value on the Edit page for the room. Log into the Zoom portal as an administrator and click Zoom Rooms. Click the name of the room, then click the Edit button.
- Enable Join a Meeting - Enable this option if you want the Cisco system to have the ability to join Zoom meetings that are not on the calendar. To join a meeting, use the remote control or touch panel to enter the Meeting ID.
- SIP Call Control - The default value is Enabled, not registered.
- H.323 Gatekeeper - Leave this toggle switched to Disabled unless the system encounters a problem and must use the H.323 protocol.
- Time Zone - Choose the timezone in which the room is located.
- Alternative Time Server - Specify the value of a local time server if you need to override the default time server.
- Call Rate - Choose the highest value supported by any bandwidth constraints in your system. The default value is 1920 (HD Dual Stream). Lower values can impact video quality.
The values that you entered are used to provision the Cisco system with services and settings, including calendaring, SIP or H.323 service, and other system settings optimized for use with Zoom meetings.
Note that it might take several seconds before the values saved in the Rooms tab populate the Calendar Credentials tab.
For a Google calendar:
- Click the Approve action.
- Click Allow in the dialog that shows the actions that Zoom will use for calendar management.
For an Outlook or Exchange calendar:
- Click the Edit action to open the dialog.
- Choose the Type (either ews for Exchange or o365 for Outlook).
- Enter the Username and Password for the account.
- Click Save.
After calendar access has been approved, the Cisco system is provisioned for Zoom meetings that are on the associated calendar. Any Zoom meetings that you start or join from your Cisco room system display on the TV screen, using the integrated camera for video, and the integrated speakers and microphones for audio during the meeting.
Additional options are available for controlling the information that displays from the calendar. To change or remove information from the screen of your Cisco system:
- On the Calendar Credentials tab, click the Edit button in the Action column for the calendar.
- Scroll to the bottom of the dialog and change any of the following settings:
- Hide Topic
Toggle this option to Hide if you want to prevent the meeting topic from being displayed on the Cisco screen. If you leave this toggled to Default, the meeting topic from the calendar displays, if it is available.
- Hide Agenda
Toggle this option to Hide if you want to prevent the meeting description from being displayed on the Cisco screen. If you leave this toggled to Default, the meeting description from the calendar displays, if it is available.
- Default Topic
The topic that displays on your Cisco screen for meetings in the room’s calendar that are not Zoom meetings, if the meeting topic is not available in the calendar. If you do not change this value, the topic that displays is Reserved.
- Default Topic (Zoom)
The topic that displays on your Cisco screen for a Zoom meeting if the meeting topic is not available in the calendar. If you do not change this value, the topic that displays is Zoom Meeting.
Manage Cisco room settings
Use the actions on the Rooms tab to Edit or Delete configuration settings.
If the Management column shows that the room is active, you can click that entry to display the Admin UI option. The Admin UI passthrough option is provided as a convenience and is not supported on all models / software versions.
Choose Admin UI to display the administrator console for the room.