Domotz is currently a Pilot integration available to selected tenants. If you do not see the Domotz card in Settings > Integrations, contact support@msportal.ai.
What Gets Synchronized
Organizations and Collectors
Domotz organizations, API-enabled collectors, their status, and company mappings
Networks and VLANs
Site networks, VLAN counts, ISP details, WAN addresses, uptime, and internet-speed results
Managed and Discovered Devices
Managed inventory, online state, and devices Domotz has discovered on the network
Monitoring and Alerts
TCP and SNMP sensor state, IP conflicts, packet loss, and active alerts
Prerequisites
- A Domotz account with Public API access
- A Domotz API key with Full Access
- At least one Collector with API access enabled
- MSPortal permission to manage integrations
- MSPortal companies to receive your Domotz organization and collector mappings
Part 1: Create a Domotz API Key
1
Open the Domotz Portal
Sign in to the Domotz Portal and open its API access settings.
2
Create a Full Access API key
Create an API key with Full Access, then copy both the key and its assigned API server URL.
Each API key is tied to a regional server, for example
https://api-us-east-1-cell-1.domotz.com/public-api/v1. Use the exact URL shown with your key.3
Confirm Collector API access
Make sure at least one Collector in the Domotz account has API access enabled. Collectors without API access cannot be synchronized.
Part 2: Connect and Map Domotz
1
Open the Domotz setup wizard
Go to Settings > Integrations, find Domotz, and open its setup page.
2
Test the connection
On Connect, enter the API server URL and API key, then click Test connection.A successful test shows how many collectors the API returned. Review any warnings about disabled Collector API access, unavailable optional capabilities, or API quota usage.
3
Create the integration
Click Create integration, then click Next. MSPortal stores the API key in its secure credential vault and starts the initial discovery.
4
Map companies
On Map, link each Domotz organization to the matching MSPortal company. A Collector that does not belong to a Domotz organization appears as an Orphan Collector and can be mapped independently.Save the mappings before continuing. MSPortal queues a synchronization for the mapped data.
5
Map sites
On Map sites, link each mapped Collector to an existing MSPortal location. Use the location picker in the Site column.A Collector must be mapped to a company before it can be linked to one of that company’s locations. This step is optional.
6
Review data coverage
On Review, check company and Collector mapping, Collector availability, managed and discovered devices, networks and VLANs, inventory field coverage, monitoring variables, active alerts, and API usage.Counts update while the initial synchronization runs. Click Complete setup when you are finished; synchronization can continue in the background.
Review Network Health
Open Devices, then select the Networks tab. The tab appears when your tenant has a Domotz connection and follows the company scope selected in MSPortal’s top bar. The table shows one row per mapped Collector:Find and Investigate a Site
1
Set the company scope
Use the company selector in the top bar to show all permitted companies or narrow the page to one company.
2
Filter or sort the table
Search by site or ISP, filter by company, location, or issue state, and sort the supported columns. Use the column selector to show only the fields you need.
3
Review issues
A healthy site shows Healthy. When a site has issues, point to or focus the issue badge to see the breakdown of IP conflicts, failing TCP sensors, active alerts, and packet-loss findings.
4
Open the site's devices
Click the value under Devices online to open Devices filtered to the linked location and company. If the site is not linked to a location, MSPortal filters by company only.
Link a Site to a Location
Users who can manage Devices can update site links directly from the Networks table.1
Start editing the location
In the site’s Location cell, click Edit.
2
Choose the location
Search the locations belonging to the mapped company and select the correct one. The table updates after the link is saved.
Add Domotz Network Health to a Report
In the Report Builder, add the Domotz Network Health block from the integration blocks. The block summarizes Collector availability, managed-device state, networks and VLANs, monitoring issues, and internet-speed results for the report’s company scope. When editing the block, you can choose whether to include discovered-device counts, active Domotz alerts, and internet-speed results.The reporting block requires a Domotz connection and permission to read Devices.
Manage the Connection
- To update credentials, reopen Domotz under Settings > Integrations, enter the new API server URL and key, click Retest connection, then Save connection
- To change company mappings, reopen the Map step
- To change site links, use Map sites or edit the Location column under Devices > Networks
- To disconnect, use the delete action in the wizard and confirm. This removes the integration and its stored credentials
- Users without integration management permission can review the connection but cannot test or change credentials
Troubleshooting
Related Resources
Devices
Review and manage synchronized devices
Reporting
Build client-facing reports with integration data
Companies and Locations
Create and manage company locations
Integrations Overview
Explore all available integrations