Skip to content

MQTT devices

The MQTT plugin receives and publishes messages from IoT devices through a broker (Mosquitto, EMQX, HiveMQ…). Messages arrive through the Heskala worker or the ingestion webhook. With them you can:

  • Show values, charts, maps and device status in IoT widgets of a dashboard.
  • Publish commands with an IoT button.
  • Run a script on each message of a topic, or a connection trigger.
  1. Create an MQTT connection in Settings → Integrations with the broker data.
  2. Install or configure the worker, or send messages to the ingestion webhook.
  3. Check the topics and their last value on the connection.
  4. Add IoT widgets to the dashboard with the topic and, if the message is JSON, the field (for example env.temp).
  5. To react to messages, create a script with an MQTT source (event onMessage and a topic filter).
  • On a public link, IoT widgets do not send commands and locations can be rounded.
  • There are profiles for cameras with detection (Frigate) and radio mesh networks (Meshtastic).
  • get_mqtt_status: workers, topics with their last value and, with Frigate, the last detection per camera.
  • create_script with mqttConnectionId and mqttTopicFilter; create_trigger with source: "mqtt".
  • IoT widgets: get_dashboard_widget_guide and set_dashboard_widgets.