Integrations

Integrations connect HubNext to external systems. Right now the Fizix Mate connector is available: it receives sensor events (alarms, diagnoses, device connection) and stores them in a feed.

Where to find it

Management → Integrations. Manager and above can see it; the Settings tab is available to Head and above only. The section shows cards of the connectors your system administrator has opened for you. If it is empty, no access has been granted yet. Click a card to open the connector: Events and Settings tabs.

How to connect Fizix Mate

1. Open the connector, Settings tab, and click Create URL: the Webhook URL appears. Click Copy.
2. Click Generate next to Secret Key, then next to API key. The value is shown only once, so copy it right away.
3. In Fizix Mate open the webhook settings and enter the URL in Endpoint and the keys in API Key and Secret Key. Enable the notification types you need.
4. Click Test in Mate and open the Events tab in HubNext: the test event should appear in the feed.

If you click Regenerate, the previous value stops working and must be replaced in Mate.

Events

The Events tab is the connector's event feed, newest first. Columns: Event (alarm, diagnosis or device connection), Device, Event type (for example vibration or temperature), State (normal, monitor, warning, danger), Connection (online or offline). Filters: Event, State, Device, period. Click a row to open the event: main fields, all event data, the raw JSON and other events of the same alarm (start, stage change, close). Event time is shown in UTC. The Download .md button exports the current selection (up to 1000 events) or, inside an event, that event — handy for an AI tool or a report.

The Organization column and filter show which Fizix organization the event came from.

Events report

The Report tab (next to Events) shows statistics grouped by Organization and Device: how many events in total and how many of each kind, by Event (alarm, diagnosis, connection) and by State (normal, watch, warning, danger). The period is Week (default, last 7 days), Month (last 30 days) or Period with the From date and To date you choose; you can limit the report to one organization. An organization row holds the totals of all its devices.

Fizix API: names instead of codes

The second connector of the integration is Fizix API. It pulls organization, system and device names from Mate, so events show more than codes.

1. Open the Fizix API connector, Settings tab. Fill in API URL, API email, API password, API key (issued by Fizix support) and click Save.
2. Click Synchronize. Organizations, systems and devices are loaded. Mate allows 50 requests per key per day, one synchronization uses 3, and you cannot repeat it more than once a minute.
3. See the result on the Directory tab. After synchronization the feed shows the system under the device code, and the event card shows system, organization, device model and measurement point.

If synchronization fails, the reason is shown under the button (wrong credentials, limit, no connection). The previous data stays on error.

Publishing the monitoring portal by link

The Equipment monitoring page (Fizix portal) can be shown to people who do not have a HubNext account. Administrators have the Publish button right on the page.

1. Pick an organization and click Publish: a short link like hubnext.cc/ab3xy9k appears.
2. Enter an address in Viewer e-mail and click Add. The system creates a password and shows it once: copy it and pass it on yourself. The key button issues a new password, the trash button removes access.
3. The person opens the link, signs in with the e-mail and password and sees a read-only page: just your one organization, with live data.

After five wrong passwords, sign-in for that e-mail is blocked for 15 minutes. Unpublish closes the link for everyone; Publish again brings back the same link.