n8n con Home Assistant e ioBroker: automatizar la tecnología del edificio en operación

n8n se puede conectar con Home Assistant e ioBroker, aunque no mediante un único disparador integrado para cambios de estado. El nodo nativo de Home Assistant en n8n actualmente no ofrece ningún disparador que reaccione a un cambio de estado, por lo que en la práctica se ha impuesto la dirección push: Home Assistant activa un workflow de n8n mediante una automatización y una llamada webhook, y n8n escribe de vuelta cuando es necesario a través de la integración REST Command o una llamada directa a la API. Para ioBroker, la conexión funciona a través del adaptador oficial de la API REST con autenticación Basic o Bearer token en ambas direcciones. Para el control de accesos, la regulación de la calefacción o el reenvío de alarmas en un edificio corporativo, este patrón push/pull suele ser suficiente. Actualizado: agosto de 2026.

¿Cómo activa Home Assistant un workflow de n8n mediante webhook?

Home Assistant configura automáticamente el endpoint del webhook en cuanto se crea una automatización con el tipo de disparador «Webhook» y se le asigna un ID de webhook. La llamada se realiza en la dirección /api/webhook/<webhook_id>, y la documentación recomienda explícitamente las solicitudes PUT; las solicitudes GET y HEAD solo están permitidas si las habilita explícitamente mediante la opción allowed_methods. Por defecto, la opción local_only restringe el acceso a la red local o a la nube de Nabu Casa, algo que normalmente debería dejar sin cambios para una automatización puramente interna. Según el tipo de contenido, los datos enviados en la automatización están disponibles como trigger.data (datos de formulario) o trigger.json (JSON, cuando se establece el content-type application/json). En el lado de n8n, un nodo webhook habitual con el método HTTP adecuado capta esta solicitud, incluida la habitual separación entre URL de prueba y de producción. Encontrará los detalles sobre la configuración del disparador en la documentación de Home Assistant sobre disparadores de automatización.

¿Por qué no basta con el nodo nativo de Home Assistant en n8n?

El nodo nativo no cubre ningún disparador para cambios de estado, algo que en la comunidad de n8n se describe repetidamente como una brecha central al migrar desde Node-RED. Los usuarios informan allí de la falta de selección de entidades mediante desplegable, por lo que los ID de entidad deben transferirse manualmente entre ambos sistemas, y mencionan la consulta de la API REST por intervalos como el único workaround, poco práctico para eventos críticos en el tiempo dentro del edificio. Se debatió un nodo WebSocket genérico, pero no se implementó como solución integrada. Para la operación, esto significa: apueste por la dirección push mediante webhooks en lugar de polling, y llame a los servicios de Home Assistant correspondientes para conmutar dispositivos en lugar de establecer estados directamente, ya que, según informes de la comunidad, esto último no llega de forma fiable a todos los dispositivos.

¿Cómo recibe n8n los eventos y cómo escribe de vuelta?

El nodo webhook de n8n admite los métodos HTTP DELETE, GET, HEAD, PATCH, POST y PUT con una carga útil máxima de 16 MB, lo cual es suficiente para los datos de sensores y eventos de la tecnología del edificio. Para el camino de vuelta, n8n llama a la integración rest_command de Home Assistant mediante un nodo HTTP Request, que ofrece llamadas REST habituales como acciones invocables y permite configurar URL, método HTTP, encabezados y carga útil; la respuesta proporciona el código de estado, el texto de retorno y los encabezados para su posterior procesamiento. Para la autenticación frente a sistemas externos, la documentación de n8n recomienda utilizar tipos de credenciales predefinidos cuando estén disponibles y, en caso contrario, recurrir a métodos genéricos como la autenticación por encabezado u OAuth2. Encontrará los detalles sobre métodos y límites de carga útil en la documentación de n8n sobre el nodo webhook.

¿Cómo se conecta ioBroker mediante la API REST?

El adaptador oficial ioBroker.rest-api ofrece una interfaz Swagger y admite tres métodos de autenticación: credenciales como parámetros de consulta, autenticación Basic mediante el encabezado Authorization, o un token bearer OAuth2 desde un endpoint propio. Los estados se pueden establecer de forma clásica mediante GET con un parámetro value, algo que el adaptador admite por motivos de compatibilidad con la antigua Simple API, pero que en la documentación actual se marca como método obsoleto (legacy). Para accesos de escritura estructurados están disponibles POST y PUT, donde POST crea un recurso independientemente de duplicados y PUT comprueba antes su existencia. En n8n esto se representa mediante un nodo HTTP Request que lee estados o los escribe mediante setState con los campos val y ack. Los detalles se encuentran en el README del adaptador ioBroker.rest-api.

¿Para qué escenarios en operación merece la pena la combinación?

Para el control de accesos, resulta adecuado un patrón en el que un sensor de puerta o un lector de tarjetas activa una automatización webhook a través de Home Assistant, y n8n registra el evento y, si es necesario, notifica a la administración. Para la regulación de la calefacción, resulta adecuado el camino inverso: un workflow de n8n programado por tiempo llama a la integración rest_command o al adaptador de ioBroker para establecer valores de consigna para zonas individuales. Para el reenvío de alarmas, se recomienda una combinación de ambos, en la que Home Assistant notifica a n8n los eventos relevantes para la seguridad mediante webhook y n8n se encarga de la escalada por correo electrónico, Microsoft Teams o un sistema de tickets. En los tres casos es importante que las acciones relevantes para la seguridad, como desbloquear puertas, no se activen directamente mediante webhook, algo que también señala expresamente la documentación de Home Assistant. Si desea anclar y mantener firmemente una automatización de este tipo en la operación, NordFlux le apoya en la creación de workflows de n8n.

Preguntas frecuentes sobre n8n con Home Assistant e ioBroker

¿Puede n8n reaccionar directamente a un cambio de estado en Home Assistant?

No, el nodo nativo de Home Assistant en n8n actualmente no ofrece ningún disparador integrado para ello. En la práctica, la conexión funciona por tanto en la dirección inversa: Home Assistant informa activamente de eventos a n8n mediante webhook, en lugar de que n8n consulte el estado de forma continua.

¿Qué método HTTP debería utilizar el webhook de Home Assistant?

La documentación de Home Assistant recomienda explícitamente las solicitudes PUT para los disparadores webhook. Las solicitudes GET y HEAD solo funcionan si además las habilita mediante la opción allowed_methods.

¿Es la API REST de ioBroker lo bastante segura para un entorno de producción?

Lo es, siempre que active la autenticación Basic o un token bearer OAuth2, en lugar de transmitir las credenciales sin cifrar como parámetros de consulta. Para la operación en la red corporativa, también debería ejecutar el adaptador detrás de un proxy inverso con HTTPS.

¿Necesito un workflow de n8n independiente para cada dispositivo?

No, lo habitual es un workflow webhook central que dirige los eventos entrantes a la lógica de procesamiento adecuada mediante un nodo Switch o IF, según el contenido de la carga útil. Esto mantiene el mantenimiento manejable, incluso cuando en el edificio hay conectadas varias docenas de sensores y actuadores.