Room Controls for Zoom Rooms

The Room Controls feature allows you to control third-party, IP-capable equipment so that the equipment can be controlled by the user through the Zoom Room controller. Admins can create a configuration profile to add outgoing IP control messages from Zoom Room.

This article covers: 

Prerequisites for using Room Controls 

Third-party devices controllable by LAN or WLAN

USB-Serial Adapters

How to enable Room Controls

Before you can upload a JSON configuration profile, the setting will need to be enabled for a Zoom Room.

  1. Sign in to the Zoom web portal.
  2. Click Room Management, then select Zoom Rooms.
  3. Click Edit to the right of the Zoom Room name.
  4. Under Devices, toggle Enable Room Controls to on (blue). 
  5. Click Create Profile.
  6. Enter the JSON configuration for this room. 

How to write a Room Controls profile

Getting Started

Before writing a Room Controls Profile, some working knowledge of JSON is needed. The key items to note are that JSON is a key:value pair-based system and that syntax is important to correctly lay out the file. For additional information on the basics of JSON, consult an online intro course.

In any coding language, some courtesy should be extended to the next person that handles your file. While there is no specific requirement around this for Room Controls, it is recommended. To leave a record of the author, version, or other history, the 'about' object can be used and placed above 'adapters'. This is not parsed by Room Controls, but will persist in the portal.  An example of how this could be leveraged is below.

"about": {
"type": "Medium Conference A",
"version": "v1.2.4",
"design_ref": "\\files\MediumConfA",
"created": "Mon, 21 Oct 2020 16:35:52 GMT"


Setting up the adapters connects Room Controls to devices. This section is the primary section for configuration. Individual devices inside the nested JSON format should follow a similar format (this example is nested to parallel the code example below):

"adapters": [
"model": "iTachIP2SL",
"ip": "[IP_ADDRESS]",
"uuid": "GlobalCache_[UNIT_MAC_ADDRESS]",
"ports": [
"id": "sl_sharp_tv",
"name": "Sharp Display",
"settings": {
"baud_rate": "38400",
"flow_control": "FLOW_NONE",
"parity": "PARITY_NO"
"methods": [
"id": "power",
"name": "Power",
"command": "POWR000%\\x0D",
"params": [
"id": "displayOn",
"name": "On",
"value": "0001"
"id": "displayOff",
"name": "Off",
"value": "0000"
"type": "actions"

Below 'methods', an additional section can be used: "response_filter". The Response Filter is a beacon that allows the Response Filters defined below to understand which connection to listen for. There are no functions defined in this area. How a Response Filter fits into other sections will be covered inside of those sections.


Styles control the visual styling of your interface elements. The adjustments aren't extremely extensive, so it isn't very hard to learn. 

There are many icons available in the interface. They span everything from air conditioners to speakerphones. The icons below are the current list, but this list is regularly expanding.

air conditionericon_air_conditioner
cable TVicon_cable_tv 
ceiling micicon_ceiling_mic
DVD Playericon_dvd_player 
Xbox/PS4 Systemicon_game_console 
rack equipmenticon_rack_equipment  
satellite dishicon_satellite_dish  

There are three primary modifiers within styles: icons (as we discussed above), Main Methods, and Visibility. 

Icons are the visualizations of the system. You can use them either to mark a device or to replace the text tied to a button. In the below example, we've defined a device called 'example'.

"adapters": [
"model": "ExternalControlSystem",
"ip": "tcp://[USER_IP_ADDRESS]:[USER_PORT]",
"ports": [
"id": "example",
"name": "Example Device",
"methods": [

Once 'example' is defined as a device, we can use this ID inside of styles.  For example, setting the main icon for our example device to be a light is easily done. 

"styles": [

Zoom also supports Material Design Icons (MDI) which can be found on Google's official MDI site.

To specify one of these icons, follow this format:


Please note that that this should be in all lower case. Use an underscore (_) instead of a space in the icon name. If the icon is unable to be downloaded, the default icon will be displayed.

You may also notice that within a single line, we've also defined the Main Method for the device.  The Main Method pulls the referenced command that you've defined into the title bar of the device giving it a prominent billing like so:


We've defined the power command as the main method, and so it is shown in the upper bar separate from the other commands.

The third style type is Visibility. Visibility allows the programmer to define a function, but hide that function from the User's Interface completely.  It can be defined just as easily:


Following the format of "device.command.invisible=true" allows this command to be completely hidden from the Rooms User.  


Rules are the automation engine of Room Controls. This is the area where things that happen on their own are defined. For example, if I wanted my display to only be active when a meeting is active, I could leverage "meeting_started" and "meeting_ended" (stock Zoom events) to make this occur.  

"rules": {
"meeting_started": [
"meeting_ended": [

This example can be used to reduce power consumption for your system.

If one command per rule isn't enough, these commands can easily be stacked. While they technically fire sequentially, they process quickly enough that we'll consider these events simultaneous. In my above example "camera.power.wake" is added beneath "display.power.on" to activate my camera when my display wakes.

Note: The available stock Zoom commands inside of rules have been expanded as of Zoom Rooms version 5.13.0. Meeting start/end events also now apply to 3rd-party interop meetings, including Microsoft Teams Direct Guest Join Meetings.  Other events do not apply to 3rd-party interop meetings in this release.

MeetingMeeting Startedmeeting_started 
MeetingMeeting Endedmeeting_ended 
MeetingIncoming Meeting Invite Startzr_meeting_ring_started 
MeetingIncoming Meeting Invite Endzr_meeting_ring_ended 
PhoneIncoming Phone Call Startzr_phone_ring_started

Any type of phone interaction (Zoom Phone, Audio Plan, 3rd Party PBX) will trigger this command

PhoneIncoming Phone Call Endzr_phone_ring_ended

All phone ring types must be inactive to trigger this event

PhonePhone Call Startedzr_phone_call_started

PSTN Invites within an active meeting will not trigger this event

PhonePhone Call Endedzr_phone_call_ended


In-Meeting - VideoVideo On (Camera Mute Off)video_started 
In-Meeting - VideoVideo Off (Camera Mute On)video_stopped 
In-Meeting - AudioMic On
(Mic Unmuted)
In-Meeting - AudioMic Off
(Mic Muted)
In-Meeting - ContentWireless Sharing Startedzr_share_startedApplies to direct share, whiteboard camera share, camera share, zoom apps sharing, and Apple Airplay (for multiple simultaneous shares, only the first command is sent). Digital Signage will not trigger these events.
In-Meeting - ContentWireless Sharing Endedzr_share_endedThis command is sent when the last of multiple shares ends.  Digital Signage will not trigger these events.
In-Meeting - ContentHDMI Sharing Startedzr_hdmi_share_startedDigital Signage will not trigger these events.
In-Meeting - ContentHDMI Sharing Stoppedzr_hdmi_share_endedDigital Signage will not trigger these events.
In-Meeting - RecordingRecording Startedzr_recording_started 
In-Meeting - RecordingRecording Stoppedzr_recording_ended 
ElevationMeeting elevationzr_elevate_to_meetingThis event triggers when a Zoom Room engaged in a telephony or screen-sharing session elevates the session to a video meeting.
PairingUser Paired to ZRzr_user_pairedEach user will trigger a generalized pairing event.
PairingUser Unpaired from ZRzr_user_unpairedEach user will trigger a generalized unpairing event.
Digital Signage
Digital SignageDigital Signage Beginszr_digital_signage_started 
Digital SignageDigital Signage is dismissedzr_digital_signage_ended 
WhiteboardWhiteboarding openedzr_whiteboard_startedApplies to Classic Whiteboard, New Whiteboard, and in-meeting whiteboards
WhiteboardWhiteboarding closedzr_whiteboard_endedApplies to Classic Whiteboard, New Whiteboard, and in-meeting whiteboards
Operation TimeOperation Time Beginsoperation_time_started 
Operation TimeOperation Time Endsoperation_time_ended 
People DetectionPeople Detectedzr_people_detectedOnly applicable to hardware layer people detection
People DetectionNo People Detectedzr_people_not_detectedOnly applicable to hardware layer people detection
Voice CommandsVoice Commands are enabledzr_voice_command_on 
Voice CommandsVoice Commands are disabledzr_voice_command_off 
Zoom AppsZoom App is openedzr_zoom_app_openedOpening any app will trigger this event, even if an app is already open in the meeting.
Zoom AppsZoom App is closedzr_zoom_app_closedClosing any app will trigger this event, even if another app is still active in the meeting.

Note: Operating Hours for Operation Time events are set in the Zoom Rooms settings page. 

It is also simple to add your own for Response Filters. Within the rules section, you can also use the Trigger Events discussed below to drive your own automation with outside inputs.


In this example, our "user_customized_event1" is turning our controlled light off. This could be driven by an input from a button or maybe a motion sensor going inactive or maybe even a third-party system like a booking system sending the room an update that no users checked in for the meeting. How you can use this feature is primarily limited by your imagination.


New in Zoom Rooms 5.13.0, the Scenes function allows Room Controls devotees to finally add Macros (multiple stacked commands on a single button) to their user experiences.  This can be helpful for scene recall or dependant devices such as lowering a projector screen as well as powering the projector on.

Like Rules or Adapters, Scenes is a top-tier section in the JSON file.  Today, a maximum of 20 scenes can be configured.  Within those scenes, a maximum of 50 independent commands are supported.

Once configured, these new scene buttons are available at the top of the room controls window.

To configure scenes, you can reference the code sample below. 

Before copying this content, please be aware that '//text' sections are notes for your reference and cannot be included in the final JSON file.

"id":"scene_1", //required
"name":"Turn on all lights", //optional, shown if name and icon are empty
"icon":"icon_light", //optional, see icon list
"commands": [ //required
"id":"scene 2",
"name":"Turn off all lights"
"commands": [

Response Filters

Response Filters are a powerful advancement in Room Controls functionality. These filters read messages coming back from defined devices and instantaneously scan for a phrase to match. When this phrase (or expression) is identified on that connection, the Rules Trigger Event (described above) fires.

Each Response Filter is comprised of three elements:

How to use Room Controls

On the Zoom Rooms controller, simply tap the Room Controls icon to access these added functions. 

When not in a meeting, the Room Controls icon can be found in the main menus.

During a meeting, tapping the icon at the top right of the controller window will display the same Room Controls.


Troubleshooting is an important part in any custom configuration. While Room Controls can be simple, it is also flexible enough to be complex when needed. The below sections should help to resolve possible roadblocks.

Room Control Errors

Error CodeDescription
No_Config_ErrorJSON Profile is not loaded in web portal
Json_Syntax_ErrorJSON Profile contains a syntax error
Json_Config_ErrorJSON Profile contains a configuration error
IP_ErrorThere is an issue connecting to a specified IP
IP_Is_PublicPublic IPs are not allowed at this time
DeviceID_ErrorOne or more Device IDs are incorrectly set
MethodID_ErrorOne or more methods are incorrectly defined
ParamID_ErrorOne or more parameters are incorrectly defined
IP2SL_Settings_ErrorSerial Port incorrectly configured on GC IP2SL
Empty_Device_ErrorOne or more devices are called without being defined in the JSON Profile
UnknownAn unknown error has occurred

Sample Files

These files have been compiled from various sources and should be used as a starting point only. Some modification is likely required to fit your application.