MQTT

MQTT ist das Protokoll vieler Hausautomationen und Maschinen: Ein Broker verteilt Nachrichten nach Themen, und wer ein Thema abonniert, bekommt sie. Mit dem Baustein MQTT schickt Bellchain jeden Alarm an ein Thema auf deinem Broker, etwa damit Home Assistant das Licht umschaltet oder ein Dashboard den letzten Alarm zeigt. MQTT gibt es ab dem Plan Trader.

Einrichten

Dein Broker muss aus dem Internet erreichbar sein, verschlüsselt und mit gültigem Zertifikat (etwa von Let’s Encrypt): mqtts:// auf Port 8883 oder WebSocket über TLS mit wss://. Cloud-Broker wie HiveMQ Cloud oder EMQX Cloud bringen das mit; einen eigenen Mosquitto-Server machst du über TLS oder einen Reverse Proxy mit WebSocket erreichbar.
Leg für Bellchain einen eigenen Benutzer an, der nur auf ein Thema schreiben darf, etwa bellchain/#.
Zieh im Editor den Baustein MQTT aufs Board, trag Broker, Thema, Benutzer und Passwort ein und klick in den Eigenschaften auf Test senden. Kommt der Test an, verbinde den Baustein mit deiner Bedingung.

Was ankommt

Je Alarm eine Nachricht an das Thema, standardmäßig dasselbe JSON wie beim Webhook, ohne Signatur (der Broker prüft Benutzer und Passwort):

{
  "id": "3f1c…",
  "type": "alert",
  "version": 1,
  "test": false,
  "time": "2026-10-18T17:00:00.000Z",
  "chain": { "id": "Xy12ab", "name": "BTC Dip-Käufer" },
  "action": "q1",
  "message": "BTC Dip-Käufer: RSI 14: 28,7 · Kurs: 77.788 $",
  "pair": "BTC/USDT",
  "timeframe": "1h",
  "price": 77788,
  "values": [{ "node": "r1", "pin": "out", "label": "RSI 14", "value": 28.7, "text": "28,7" }]
}

Unter den erweiterten Einstellungen des Bausteins wählst du:

Inhalt: JSON wie oben oder Nur die Nachricht als Text, etwa für eine Laufschrift.
Zustellung: Mit QoS 1 (Vorgabe) bestätigt der Broker jede Nachricht; fehlt die Bestätigung, versucht Bellchain es erneut. QoS 0 sendet einmal ohne Bestätigung.
Letzten Alarm behalten: Mit Behalten (retain) hebt der Broker den letzten Alarm auf; ein Dashboard bekommt ihn nach dem Neustart sofort.

Beispiel: Home Assistant

Mit der MQTT-Integration in Home Assistant reagiert eine Automation auf das Thema:

automation:
  - alias: "Bellchain: Licht rot bei Alarm"
    trigger:
      - platform: mqtt
        topic: bellchain/alerts
    condition:
      - condition: template
        value_template: "{{ not trigger.payload_json.test }}"
    action:
      - service: light.turn_on
        target:
          entity_id: light.buero
        data:
          color_name: red

Wenn etwas nicht ankommt

Grund im Verlauf	Bedeutung
`mqtt_auth`, `mqtt_not_authorized`	Benutzer oder Passwort falsch, oder der Benutzer darf nicht verbinden. Bellchain versucht es nicht erneut und sagt dir Bescheid.
`mqtt_tls`	Das Zertifikat des Brokers ist ungültig, abgelaufen oder selbst signiert.
`mqtt_url_not_tls`	Die Adresse beginnt mit `mqtt://` oder `ws://`; Bellchain sendet nur verschlüsselt.
`mqtt_private_address`	Der Broker liegt im eigenen Netz, etwa `192.168.…` oder `homeassistant.local`.
`mqtt_network`, `mqtt_timeout`, `mqtt_unavailable`, `mqtt_closed`	Der Broker war nicht erreichbar oder hat nicht geantwortet; Bellchain versucht es später erneut.
`mqtt_ws_not_found`	Unter dem Pfad der `wss://`-Adresse gibt es keinen WebSocket, oft fehlt `/mqtt` am Ende.

Bellchain spricht MQTT 3.1.1 und verbindet sich je Alarm neu: verbinden, veröffentlichen, trennen, mit einer Client-ID bellchain-… und ohne gespeicherte Sitzung.

Version 2026.10.25.16 · Changelog