ROOMZ
The ROOMZ app integrates ROOMZ sensors with the Eliona platform to provide real-time data about workspace occupancy.
Last updated
The ROOMZ app integrates ROOMZ sensors with the Eliona platform to provide real-time data about workspace occupancy.
Last updated
This guide provides instructions for installing, configuring, and using the ROOMZ app to collect data from ROOMZ sensors.
Install the ROOMZ app from the Eliona App Store.
Register the app in ROOMZ, then configure the ROOMZ app through the Eliona settings interface.
The ROOMZ app uses an experimental , which is not generally available yet. Contact ROOMZ support to activate data sending and get webhook secret. The webhook endpoint for your Eliona instance is: https://{your-eliona-instance}/apps-public/roomz/webhook.
As the Webhook enpoint has to be exposed to the Internet, all incoming data are verified using ROOMZ signature. To verify this, ROOMZ has to provide a Webhook secret, a public key to verify the signature.
Configure the app in Eliona by navigating to Apps > ROOMZ > Settings, which opens the app's . Use the POST method to set up the configuration. Each configuration requires the following parameters:
secret
Webhook secret provided by ROOMZ.
enable
Flag to enable or disable this configuration.
projectIDs
List of Eliona project IDs for data collection.
Example configuration JSON:
Once configured, the app listens for data updates from ROOMZ. Each time there is a presence status change (someone enters or leaves a space), the app receives a message from ROOMZ and writes the data to Eliona.
The app automatically creates all assets for the spaces being monitored - If the app receives data from a sensor for the first time, it creates a new asset under the "ROOMZ root" asset. The asset is named by the space ID (the only information provided by the ROOMZ API) but can be renamed and relocated by the user.
The user who created or last updated the app's configuration will be notified of newly created assets.