Skip to main content

Key workflows

Onboard a new site's hardware​

  1. Gateways → Add Gateway; choose the type (UniFi/generic, igloohome or pod-controller) and fill connection and credentials.

  2. Set Site/Zone, Organization ID and per-gateway alert recipients if needed.

  3. Click Test & Save — the Adapter verifies the connection before saving.

  4. From the gateway card menu, run Discover devices and onboard the devices found.

  5. In Devices, set each device's friendly name, group and criticality tier (Critical devices trigger offline alerts).

Connect a device to ZenEdge​

  1. System → Adapter API keys → Generate New Key (copy it; it is shown once).

  2. Open the device (Details) → ZenEdge integration panel and copy the Device Base URL.

  3. In ZenEdge, open the physical space → Devices tab → Add Device; paste the Device Base URL and the Adapter API key, then onboard.

  4. Optionally test /ping and /status from the Adapter.

Set up a Web MRD and connect it to ZenEdge​

Pre-condition: the ZenCore meeting space is already mapped to the ZenEdge physical space, and you have an Adapter API key.

  1. MRD-Web → Create MRD-Web; add display name, group, place and meeting space label.

  2. In ZenCore, open the meeting space → Physical Space tab and copy the Space ID.

  3. In the Adapter, open the screen → Overview → ZenEdge link section. Paste the Space ID into ZenEdge physical space ID, click Save, then click Provision.

  4. Open the screen's Integration tab and copy the Device Base URL.

  5. In ZenEdge, open the same physical space → Devices tab → Add Device. Paste the Device Base URL, paste the Adapter API key below it, and confirm.

  6. The Web MRD is now connected to the ZenEdge physical space and shows the meeting space's status.

  7. Media: upload the room image (SIDE / BG / FULL IMAGE) and sponsor logo.

  8. Configuration: set booking URL, display toggles and capabilities (virtual lock, booking).

  9. Copy Device URL and open it on the room screen; check the Status tab for the heartbeat (last seen within ~90 s).

Troubleshoot an offline gateway or device​

  1. Read the error on the gateway card (e.g. HTTP 402 trial ended, network timeout).

  2. Use Ping gateway or Run diagnostic from the card menu, or System → Run Diagnostics for all devices.

  3. Check the Event Log filtered by gateway for device.online / alert.device_offline.email_sent events.

  4. On the device page, review Health & uptime and Recent activity.

  5. For a Web MRD that stopped updating: check its Status tab, click Re-provision on Overview, then reload the Device URL on the screen.