n8n mit Home Assistant und ioBroker: Gebäudetechnik im Betrieb automatisieren

n8n lässt sich mit Home Assistant und ioBroker verbinden, allerdings nicht über einen einzigen eingebauten Trigger für Zustandsänderungen. Der native Home-Assistant-Node in n8n bietet aktuell keinen Trigger, der auf eine Zustandsänderung reagiert, weshalb sich in der Praxis die Push-Richtung durchgesetzt hat: Home Assistant löst über eine Automation und einen Webhook-Aufruf einen n8n-Workflow aus, und n8n schreibt bei Bedarf über die REST-Command-Integration oder einen direkten API-Aufruf zurück. Für ioBroker funktioniert die Anbindung über den offiziellen REST-API-Adapter mit Basic- oder Bearer-Token-Authentifizierung in beide Richtungen. Für Zutrittskontrollen, Heizungssteuerung oder Alarmweiterleitung im Firmengebäude reicht dieses Push/Pull-Muster in aller Regel aus. Stand: August 2026.

Wie löst Home Assistant einen n8n-Workflow per Webhook aus?

Home Assistant richtet den Webhook-Endpunkt automatisch ein, sobald Sie eine Automation mit dem Trigger-Typ „Webhook" anlegen und ihr eine Webhook-ID zuweisen. Der Aufruf erfolgt unter der Adresse /api/webhook/<webhook_id>, wobei die Dokumentation ausdrücklich PUT-Anfragen empfiehlt; GET- und HEAD-Anfragen sind nur erlaubt, wenn Sie sie über die Option allowed_methods explizit freigeben. Standardmäßig beschränkt die Option local_only den Zugriff auf das lokale Netzwerk beziehungsweise die Nabu-Casa-Cloud, was Sie für eine reine Inhouse-Automatisierung meist unverändert lassen sollten. Je nach Content-Type liegen die gesendeten Daten in der Automation entweder als trigger.data (Formulardaten) oder trigger.json (JSON, wenn der Content-Type application/json gesetzt ist) vor. Auf n8n-Seite fängt ein gewöhnlicher Webhook-Node mit passender HTTP-Methode diese Anfrage ab, inklusive der üblichen Trennung zwischen Test- und Produktions-URL. Details zur Trigger-Konfiguration finden Sie in der Home-Assistant-Dokumentation zu Automation-Triggern.

Warum reicht der native Home-Assistant-Node in n8n allein nicht aus?

Der native Node deckt keinen Trigger für Zustandsänderungen ab, was in der n8n-Community wiederholt als zentrale Lücke beim Umstieg von Node-RED beschrieben wird. Nutzer berichten dort von fehlender Entity-Auswahl per Dropdown, sodass Entity-IDs manuell zwischen beiden Systemen übertragen werden müssen, und nennen intervallbasiertes Abfragen der REST-API als einzigen Workaround, der für zeitkritische Gebäudeereignisse wenig praxistauglich ist. Ein generischer WebSocket-Node wurde diskutiert, aber nicht als eingebaute Lösung umgesetzt. Für den Betrieb bedeutet das: Setzen Sie auf die Push-Richtung über Webhooks statt auf Polling, und rufen Sie zum Schalten von Geräten die passenden Home-Assistant-Services auf statt Zustände direkt zu setzen, da Letzteres laut Community-Berichten nicht zuverlässig bei allen Geräten ankommt.

Wie empfängt n8n die Ereignisse und wie schreibt es zurück?

Der Webhook-Node in n8n unterstützt die HTTP-Methoden DELETE, GET, HEAD, PATCH, POST und PUT bei einem maximalen Payload von 16 MB, was für Sensor- und Ereignisdaten aus der Gebäudetechnik ausreicht. Für den Rückweg ruft n8n über einen HTTP-Request-Node die rest_command-Integration von Home Assistant auf, die reguläre REST-Aufrufe als aufrufbare Aktionen bereitstellt und URL, HTTP-Methode, Header und Payload konfigurierbar macht; die Antwort liefert Statuscode, Rückgabetext und Header zur Weiterverarbeitung. Für die Authentifizierung gegenüber externen Systemen empfiehlt die n8n-Dokumentation, wo verfügbar vordefinierte Credential-Typen zu nutzen und andernfalls auf generische Verfahren wie Header- oder OAuth2-Authentifizierung auszuweichen. Details zu Methoden und Payload-Grenzen finden Sie in der n8n-Dokumentation zum Webhook-Node.

Wie bindet man ioBroker über die REST-API an?

Der offizielle ioBroker.rest-api-Adapter stellt eine Swagger-Oberfläche bereit und unterstützt drei Authentifizierungswege: Zugangsdaten als Query-Parameter, Basic-Authentifizierung über den Authorization-Header oder ein OAuth2-Bearer-Token aus einem eigenen Endpunkt. Zustände lassen sich klassisch per GET mit einem value-Parameter setzen, was der Adapter aus Kompatibilitätsgründen zur älteren Simple-API unterstützt, in der aktuellen Dokumentation aber als Legacy-Verfahren markiert ist. Für strukturierte Schreibzugriffe stehen POST und PUT zur Verfügung, wobei POST eine Ressource unabhängig von Duplikaten anlegt und PUT vorher deren Existenz prüft. In n8n bilden Sie das über einen HTTP-Request-Node ab, der Zustände liest oder per setState mit den Feldern val und ack schreibt. Details stehen im README des ioBroker.rest-api-Adapters.

Für welche Szenarien im Betrieb lohnt sich die Kombination?

Für Zutrittskontrollen bietet sich ein Muster an, bei dem ein Türsensor oder Kartenleser über Home Assistant eine Webhook-Automation auslöst und n8n das Ereignis protokolliert sowie bei Bedarf die Verwaltung benachrichtigt. Für die Heizungssteuerung eignet sich der umgekehrte Weg: Ein zeitgesteuerter n8n-Workflow ruft die rest_command-Integration oder den ioBroker-Adapter auf, um Sollwerte für einzelne Zonen zu setzen. Für die Alarmweiterleitung empfiehlt sich eine Kombination aus beidem, bei der Home Assistant sicherheitsrelevante Ereignisse per Webhook an n8n meldet und n8n die Eskalation über E-Mail, Microsoft Teams oder ein Ticketsystem übernimmt. Wichtig ist in allen drei Fällen, dass sicherheitsrelevante Aktionen wie das Entriegeln von Türen nicht direkt per Webhook ausgelöst werden, worauf auch die Home-Assistant-Dokumentation ausdrücklich hinweist. Wenn Sie eine solche Automatisierung fest im Betrieb verankern und pflegen wollen, unterstützt Sie NordFlux beim Aufbau von n8n-Workflows.

Häufige Fragen zu n8n mit Home Assistant und ioBroker

Kann n8n direkt auf eine Zustandsänderung in Home Assistant reagieren?

Nein, der native Home-Assistant-Node in n8n bietet dafür aktuell keinen eingebauten Trigger. In der Praxis läuft die Verbindung deshalb über die umgekehrte Richtung: Home Assistant meldet Ereignisse per Webhook aktiv an n8n, statt dass n8n den Zustand laufend abfragt.

Welche HTTP-Methode sollte der Home-Assistant-Webhook verwenden?

Die Home-Assistant-Dokumentation empfiehlt ausdrücklich PUT-Anfragen für Webhook-Trigger. GET- und HEAD-Anfragen funktionieren nur, wenn Sie sie zusätzlich über die Option allowed_methods freischalten.

Ist die REST-API von ioBroker sicher genug für den Produktivbetrieb?

Sie ist es, sofern Sie Basic-Authentifizierung oder ein OAuth2-Bearer-Token aktivieren, statt Zugangsdaten unverschlüsselt als Query-Parameter zu übergeben. Für den Betrieb im Firmennetz sollten Sie den Adapter zusätzlich hinter einem Reverse Proxy mit HTTPS betreiben.

Brauche ich für jedes Gerät einen eigenen n8n-Workflow?

Nein, üblich ist ein zentraler Webhook-Workflow, der eingehende Ereignisse anhand des Payload-Inhalts per Switch- oder IF-Node an die passende Verarbeitungslogik weiterleitet. Das hält die Wartung überschaubar, auch wenn im Gebäude mehrere Dutzend Sensoren und Aktoren angebunden sind.