Integration shows offline or disconnected

If an integration shows as Offline or Disconnected in Connect, here's how to fix it.

Cloud integrations (Viz Flowics, Singular.live)

Check your API key/token:

• Open the integration and verify the credentials are correct.
• Tokens may have expired. Generate a new one in the external service.
• Test the connection using the Test button.

Check your network:

• Make sure your browser can reach the external API.
• Check if a VPN or firewall is blocking outbound connections.

Local integrations (OBS, vMix) via Direct

Check the target software:

• Make sure OBS/vMix is running.
• Verify the WebSocket Server (OBS) or Web Controller (vMix) is enabled.
• Confirm the host, port, and password match.

Check network access:

• If connecting from a different machine, ensure the port is not firewalled.
• Try localhost if Helmo and OBS/vMix are on the same machine.

Local integrations via Middleware

Check Helmo Middleware:

• Is the Helmo Middleware app running? Look for it in the system tray.
• Is it showing as Online in the Middleware tab?
• If offline, restart Helmo Middleware and check the API key.

Check heartbeat:

• Helmo Middleware sends a heartbeat every 30 seconds. If the last heartbeat is stale, it may have crashed or lost its network connection.

Still not working?

• Check the browser console for error messages.
• Try removing and re-adding the integration with fresh credentials.