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.
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.
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.
From the Integrations panel, click Create.
Select the integration type: MQTT or VRPC.
Heisenware will generate a unique username and password. You can optionally modify these by clicking in the fields.
Copy these credentials and use them in your external client's configuration to establish the connection.
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
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