Recursos · Integración n8n

Integración Home Assistant n8nAutomatiza Home Assistant con n8n.

Cada bombilla, sensor y script de la casa se convierte en un paso de un flujo de trabajo. La integración Home Assistant n8n abre 13 operaciones repartidas en 7 recursos: estados, servicios, eventos, registros, plantillas, configuración e imágenes de cámara. Sin nodo trigger propio, el arranque llega desde fuera.

Probar la integración Home Assistant en n8nVer las 13 operaciones

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve la integración Home Assistant n8n?

Home Assistant gobierna la casa y n8n gobierna todo lo que la rodea. El nodo habla con la API REST de Home Assistant usando un token de acceso de larga duración, así que un flujo puede leer el estado de cualquier entidad, llamar a un servicio, escribir un estado, renderizar una plantilla o traerse la imagen de una cámara como archivo. En total, 13 operaciones sobre 7 recursos detrás de un único credential, es decir, la conexión que guardas una vez en n8n y reutilizas en todos los flujos.

El primer patrón es el más frecuente: la casa responde a algo que pasa fuera de ella. Una alarma de terceros llama a un Webhook de n8n, la URL que ese servicio activa en cuanto salta una alerta, y el flujo lanza service.call sobre el dominio de las luces para encender toda la casa y simular que hay alguien. La lógica vive en n8n, la ejecución vive en casa, y no hace falta tocar una sola automatización en YAML.

El segundo patrón es la casa rindiendo cuentas. state.getAll devuelve todas las entidades en una sola ejecución, suficiente para archivar cada día el consumo de los enchufes inteligentes en Google Sheets y construir un histórico que Home Assistant no guarda para siempre. Si añades log.getLogbookEntries con una franja horaria, sacas qué equipos siguieron encendidos durante la noche, entidad por entidad.

El tercero es la casa hablando con la gente, no solo por cámara. Cada mañana, un Schedule Trigger puede lanzar cameraProxy.getScreenshot sobre la cámara del salón para revisarla desde el móvil sin abrir la aplicación de Home Assistant. Y como el nodo llama a los servicios por dominio, todo lo que Home Assistant ya conoce queda al alcance, desde las bombillas del nodo Philipshue hasta un altavoz con la playlist de Spotify.

Donde el nodo se detiene, entra HTTP Request. La API de Home Assistant expone mucho más que estos 7 recursos, el historial y los calendarios entre otras cosas, y el nodo HTTP Request llama a cualquiera de esos endpoints reutilizando el mismo credential mediante la autenticación predefinida. Conviene tener presentes dos límites antes de construir: no existe trigger de Home Assistant, así que el flujo lo arranca un Schedule Trigger o un Webhook de n8n, o sea una URL que otro servicio llama; y tu instancia de n8n tiene que alcanzar por red el host de Home Assistant, algo que se planifica cuando n8n vive fuera de la red de casa.

Si quieres montar este tipo de flujo sin aprender a base de errores, el Curso n8n recorre las piezas una a una.

Conexión

¿Cómo conectar Home Assistant con n8n?

  1. 01

    Genera un token de acceso de larga duración

    Entra en Home Assistant y abre tu perfil de usuario. En la sección Long-Lived Access Tokens genera un token nuevo y cópialo en ese momento, porque solo se muestra una vez. Es el único secreto que necesita el nodo y lo que n8n envía en cada llamada a tu instancia. Guárdalo a mano mientras rellenas el resto de los campos.

  2. 02

    Rellena el credential en n8n

    En n8n, crea un credential de Home Assistant, esa conexión guardada una sola vez que después aparece en el desplegable de cualquier flujo. Pega el token en Access Token y escribe la URL o la dirección IP de tu instancia en Host, sin el protocolo delante: your.awesome.home, nunca https://your.awesome.home.

  3. 03

    Ajusta el puerto y el interruptor SSL

    En Port, deja el valor por defecto 8123 si entras a Home Assistant por http:// y no has tocado nada, pon 443 si entras por https://, o escribe tu propio puerto si lo configuraste. Activa el interruptor SSL cuando tengas SSL habilitado en la clave config.yml, o cuando tu interfaz responda por https://.

Acciones

Qué sabe hacer el nodo Home Assistant

El nodo Home Assistant expone 13 operaciones en 7 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyCallCheck ConfigurationGet Error LogsGet Logbook EntriesGet ScreenshotCreate or Update
Camera Proxy✓
Config✓✓
Event✓✓
Log✓✓
Service✓✓
State✓✓✓
Template✓

Camera Proxy

1 operación
01

Get a screenshot

cameraProxy.getScreenshot

Lo que ves en n8n

Notas y casos de uso

Captura la imagen actual de una cámara y la entrega al flujo como archivo, no como texto. Los nodos siguientes pueden adjuntarla a un mensaje o dejarla en un almacenamiento.

Parámetros clave

  • Camera Entity Name or ID: la cámara que va a hacer la foto, elegida en la lista que n8n carga desde tu instancia o definida con una expresión como {{ $json.entity_id }} cuando lo decide un nodo anterior.
  • Put Output File in Field: el nombre del campo binario de salida donde aterriza la imagen, el mismo que citas luego para enviarla.
Casos de uso
alguien toca el timbre, el flujo fotografía la entrada y publica la imagen en el chat de casa.

Config

2 operaciones
02

Get the config

config.get

Lo que ves en n8n

Notas y casos de uso

Devuelve la configuración de la instancia tal y como la reporta la API de Home Assistant. No hay nada que rellenar: la operación no tiene parámetros, simplemente responde.

Casos de uso
es el nodo de prueba perfecto justo después de guardar el credential, para confirmar que el host, el puerto y el token encajan antes de construir nada encima. Dentro de un flujo programado también funciona como señal de vida, porque una conexión rota se ve aquí y no en mitad de una llamada a un servicio.
03

Check the config

config.check

Lo que ves en n8n

Notas y casos de uso

Pide a Home Assistant que valide su propia configuración y devuelve el veredicto. Tampoco tiene parámetros, así que sale barato ejecutarla a menudo.

Casos de uso
después de tocar tus archivos de Home Assistant, lanza esta comprobación antes de reiniciar nada. El flujo valida la configuración y se bifurca según el resultado para avisar en el chat cuando algo no cuadra. Mucho mejor que enterarte porque la calefacción ha dejado de responder.

Event

2 operaciones
04

Create an event

event.create

Lo que ves en n8n

Notas y casos de uso

Lanza un evento en el bus de eventos de Home Assistant, para que las automatizaciones que ya viven allí reaccionen a algo ocurrido dentro de n8n.

Parámetros clave

  • Event Type: el identificador de entidad para el que se crea el evento, escrito como texto o construido con una expresión.
  • Event Attributes: carga opcional, añadida par a par con Add Attribute, con los datos que espera la automatización que escucha.
Casos de uso
una oportunidad pasa a ganada en el CRM, n8n emite el evento y Home Assistant decide por su cuenta qué lámpara parpadea.
05

Get many events

event.getAll

Lo que ves en n8n

Notas y casos de uso

Lista los eventos que conoce la instancia en una sola llamada, sin filtros que configurar.

Parámetros clave

  • Return All: activado, n8n encadena las páginas de la API hasta traerlos todos; desactivado, se para en Limit.
  • Limit: el número máximo de eventos devueltos mientras Return All siga desactivado.
Casos de uso
reconocimiento del terreno. Una ejecución durante el montaje basta para ver qué nombres de evento publica de verdad tu instalación y copiarlos luego en Event Type.

Log

2 operaciones
06

Get a log for an entity

log.getErroLogs

Lo que ves en n8n

Notas y casos de uso

Recupera el registro de errores de la instancia tal y como lo escribe Home Assistant. No hay campos que rellenar, la operación devuelve lo que haya.

Casos de uso
un flujo nocturno lee ese registro y lo manda donde de verdad miras. Las integraciones que han dejado de hablar con su aparato aparecen ahí mucho antes de que nadie note que un interruptor se ha quedado mudo, y así una sospecha vaga se convierte en algo legible.
07

Get all logs for an entity

log.getLogbookEntries

Lo que ves en n8n

Notas y casos de uso

Devuelve las entradas del logbook, el historial legible de qué cambió y cuándo. Sin tocar nada responde sobre el periodo reciente; los campos opcionales lo acotan.

Parámetros clave

  • Start Time: el inicio del periodo, como valor de fecha y hora.
  • End Time: el final de ese mismo periodo.
  • Entity ID: restringe el logbook a una sola entidad en lugar de toda la casa.
Casos de uso
un informe semanal sobre la puerta del garaje, para responder sin discusión a quién la abrió y a qué hora.

Service

2 operaciones
08

Call a service

service.call

Lo que ves en n8n

Notas y casos de uso

Por aquí es por donde un flujo actúa sobre la casa. El nodo elige un dominio de servicios y después un servicio dentro de él, y Home Assistant hace el trabajo: encender una luz, fijar una temperatura, ejecutar un script.

Parámetros clave

  • Domain Name or ID: la familia de servicios, tomada de la lista o entregada por una expresión como {{ $json.domain }}.
  • Service Name or ID: el servicio dentro de ese dominio, misma lista y misma lógica de expresión.
  • Service Attributes: los valores que espera el servicio, añadidos par a par con Add Attribute.
Casos de uso
un único flujo matinal que abre la oficina, ajusta el termostato y arranca la música.
09

Get many services

service.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve los servicios disponibles en la instancia, agrupados por el dominio al que pertenecen.

Parámetros clave

  • Return All: activado, vuelven todos los servicios por muchas páginas de API que haga falta recorrer; desactivado, la respuesta se detiene en Limit.
  • Limit: el número máximo de servicios devueltos.
Casos de uso
documentación de primera mano. Antes de cablear una llamada, esta operación te da los nombres exactos de dominio y servicio de tu instalación, en lugar de los de un artículo escrito sobre otra casa.

State

3 operaciones
10

Create or update a state

state.upsert

Lo que ves en n8n

Notas y casos de uso

Escribe un valor en la máquina de estados. Si la entidad ya tiene estado, queda reemplazado; si no existía, aparece con el valor que has enviado.

Parámetros clave

  • Entity Name or ID: la entidad a la que pertenece el estado, elegida en la lista o dada por una expresión.
  • State: el valor en sí, como texto.
  • State Attributes: pares adicionales asociados al estado, añadidos con Add Attribute.
Casos de uso
meter un dato de negocio dentro de la casa, para que una pantalla muestre los pedidos del día junto a la temperatura.
11

Get a state

state.get

Lo que ves en n8n

Notas y casos de uso

Lee el estado actual de una entidad con sus atributos. No modifica nada, así que puedes colocarla delante de cualquier decisión del flujo sin riesgo.

Parámetros clave

  • Entity Name or ID: la entidad que se va a leer, tomada de la lista que n8n carga desde tu instancia o entregada por una expresión cuando la ha elegido un nodo anterior.
Casos de uso
antes de mandar un recordatorio programado, comprobar si hay alguien en casa y saltarse el mensaje cuando la respuesta es que no.
12

Get many states

state.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve el estado de todas las entidades de golpe, la forma más rápida de ver la casa entera en una sola ejecución.

Parámetros clave

  • Return All: activado, n8n recorre las páginas de la API hasta traer la máquina de estados completa; desactivado, la ejecución se para en Limit.
  • Limit: el número máximo de estados devueltos.
Casos de uso
una fotografía diaria guardada en una hoja de cálculo, que con el tiempo da un histórico de sensores que se puede graficar.

Template

1 operación
13

Create a template

template.create

Lo que ves en n8n

Notas y casos de uso

Renderiza una plantilla de Home Assistant y devuelve el resultado, de modo que la lógica se queda en sintaxis de Home Assistant en vez de reconstruirse a golpe de nodos en n8n.

Parámetros clave

  • Template: la plantilla que se va a renderizar, escrita como texto; la documentación de plantillas de Home Assistant explica la sintaxis.
Casos de uso
construir una frase a partir de varios sensores, temperatura interior y exterior por ejemplo, y enviar esa única línea como cuerpo del mensaje en lugar de tres lecturas sueltas.
Necesitas ayuda

¿Necesitas ayuda para automatizar Home Assistant con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Home Assistant y n8n, las preguntas que vienen después

01¿La integración Home Assistant n8n es gratis?
Sí. El nodo de Home Assistant viene incluido con n8n, así que no hay nada que instalar ni ningún coste adicional por el lado de n8n. Se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia que alojes tú mismo con Docker o npm, en Community Edition bajo licencia Sustainable Use. Un flujo construido en un sitio funciona en el otro sin cambios. Home Assistant, por su parte, es software que ya tienes corriendo en casa, y el token de acceso que une ambos tampoco cuesta nada. Lo que pagas, en cualquiera de los dos casos, es el modelo de alojamiento de n8n que hayas elegido, no este nodo.
02¿Qué credenciales hacen falta para conectar Home Assistant con n8n?
Un token de acceso de larga duración y la dirección de tu instancia. El token se genera desde tu perfil de usuario de Home Assistant, en la sección Long-Lived Access Tokens, y se pega en el campo Access Token de n8n. Al lado, Host espera la URL o la dirección IP sin ningún protocolo delante, y Port espera 8123 por defecto en una instancia a la que entras por http, 443 cuando entras por https, o el valor que hayas configurado tú. Si tienes SSL habilitado en la clave config.yml, o si tu interfaz responde por https, activa el interruptor SSL. El credential se guarda una vez y se reutiliza en todos los flujos posteriores.
03¿Qué límites tiene el nodo de Home Assistant en n8n?
El nodo cubre 7 recursos y 13 operaciones, una parte de lo que expone la API REST de Home Assistant. Estados, servicios, eventos, registros, configuración, plantillas e imágenes de cámara están cubiertos; lo demás no. Cuando te falta un endpoint, el nodo HTTP Request lo llama directamente y reutiliza el mismo credential gracias a la autenticación predefinida, así que no gestionas un segundo token. La otra restricción es de red más que de funcionalidad: tu instancia de n8n tiene que poder alcanzar el host y el puerto de Home Assistant que has escrito, algo que hay que preparar cuando n8n corre fuera de la red donde vive la casa.
04¿Existe un trigger de Home Assistant en n8n?
No. No hay nodo trigger de Home Assistant en n8n, de modo que un flujo no puede quedarse esperando a que algo se mueva en casa. El arranque llega por otra vía. Un Schedule Trigger ejecuta el flujo cada cierto intervalo fijo y lee el estado actual, que es lo que necesitan los resúmenes, las fotografías diarias y las comprobaciones de salud. Un Webhook de n8n te da una URL que otro servicio llama, y una automatización de Home Assistant puede llamarla cuando ocurre algo dentro, lo que devuelve la lógica reactiva al lado de la casa. El trigger de cualquier otra herramienta también sirve, y es el patrón más habitual.
05¿n8n o Make para Home Assistant?
Depende sobre todo de dónde viva tu instancia. Make lo aloja Make, sin opción de autoalojamiento, y se factura por operación. n8n corre en tu propio servidor si así lo quieres, y aquí eso pesa, porque Home Assistant suele vivir en una red local que una plataforma alojada no alcanza sin abrirla. Instalar n8n junto a Home Assistant mantiene el tráfico y el token de acceso dentro de casa. El modelo de coste también cambia: facturar por operación castiga a los flujos que releen un estado cada pocos minutos, justo lo que genera una casa. Los dos se construyen en visual, así que la decisión se juega en alojamiento, control de los datos y frecuencia de ejecución.
Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones