Integrations

The Integrations panel in the App Manager provides a centralized place to monitor and manage all inbound data connections from external systems into your Heisenware account.

Every external system that sends data to Heisenware—whether it's an IoT device, a piece of custom software, or a Heisenware Agent—is treated as an "integration." This panel allows you to view the status of these connections and manage their credentials.

Integrations panel

Types of Integrations

Heisenware supports three primary types of inbound integrations, each designed for a different use case.

Heisenware Agent

A Heisenware Agent is a specialized tool for securely connecting systems from a private network (e.g., on-premise servers, local file systems, or private databases) to the Heisenware cloud platform.

Automated Creation

Agents are created and configured within the App Builder. Once an Agent is deployed, its entry is automatically generated in the Integrations panel for monitoring purposes. You do not need to manually create credentials for an Agent here.

Learn more about how to build and deploy agents in the Agents article.

MQTT Client

This integration type is for any standard external MQTT client. It is the ideal choice for general-purpose IoT use cases, such as devices or sensors pushing data to Heisenware's MQTT broker. You can authorize these clients using either manual credential creation or Smart Onboarding.

VRPC Client

This is an advanced integration method used to connect custom code and proprietary software libraries to Heisenware using the innovative VRPC protocol. This is the most powerful option for creating specialized software integrations. These clients are also authorized using either manual credential creation or Smart Onboarding.

Connecting MQTT and VRPC Integrations

While Agent integrations are handled automatically, you have two methods for authorizing MQTT and VRPC clients to connect to your account.

Method 1: Manual Credential Creation

Use this method when you want to pre-configure your external client with a fixed username and password.

  1. From the Integrations panel, click Create.

  2. Select the integration type: MQTT or VRPC.

  3. Heisenware will generate a unique username and password. You can optionally modify these by clicking in the fields.

  4. Copy these credentials and use them in your external client's configuration to establish the connection.

MQTT Integration example

Method 2: Smart Onboarding

Use this method when you want to avoid manually handling credentials. With Smart Onboarding, the external client initiates a connection request, which you then simply approve within the App Builder.

For a detailed guide on this process, please refer to the Smart Onboarding article.

Integrating Custom Code with VRPC

Avanced Feature

This section describes an advanced feature that requires programming knowledge. If you are unsure how to proceed, please contact our support team for assistance.

What is VRPC?

VRPC (Variadic Remote Procedure Calls) is an open-source technology developed by Heisenware that allows functions written in different programming languages to call each other directly. It is the core technology that enables you to seamlessly integrate your own code into the Heisenware platform.

How it Works: Code Adapters

To make your custom code available within Heisenware, you must implement a Code Adapter. The adapter is a small wrapper you write around your existing functions that standardizes their interface so VRPC can communicate with them.

Once integrated using an adapter, your custom functions will appear directly in the App Builder's functionality panel, ready to be used in your applications.

This is useful for:

  • Integrating legacy systems that lack modern interfaces.

  • IoT integration for embedded devices and microcontrollers.

  • Adding new functionality by integrating specialized software libraries.

Available Adapters

Heisenware provides pre-built adapters for many popular languages, and more can be provided on request.

  • Arduino

  • C++

  • Node.js

  • Python

  • R

  • React

For complete technical details on implementing a code adapter, please refer to the official VRPC developer documentation.

Last updated