Automatiza tu hogar con Telegram y n8n en Home Assistant

Conectar Telegram con Home Assistant usando n8n como intermediario es una de las integraciones de domótica más prácticas de 2026: con un flujo visual, sin escribir casi código, podés enviarle un mensaje a un bot y que las luces de tu casa respondan en segundos.

¿Qué es n8n y por qué usarlo para telegram n8n home assistant?

n8n es una plataforma de automatización de flujos de trabajo de código abierto, con interfaz visual tipo nodos, que podés instalar en tu propio servidor. A diferencia de Zapier o Make, el plan self-hosted no tiene límite de ejecuciones mensuales, lo que lo hace muy conveniente si vas a tener automatizaciones corriendo todo el día.

El modelo de precios en 2026 es simple: self-hosted gratis con todas las funciones, o cloud desde USD 20/mes si no querés gestionar infraestructura. Para integrar telegram con Home Assistant, la versión gratuita alcanza sobrada.

Lo que lo diferencia de configurar el webhook directamente en Home Assistant es la flexibilidad para agregar lógica intermedia: podés parsear mensajes, agregar condiciones, llamar a APIs externas, o incluso meter un modelo de IA en el medio antes de que la orden llegue al dispositivo. (Eso sí, requiere que tengas un servidor con IP pública y HTTPS, porque Telegram no acepta webhooks por HTTP plano.)

Conceptos previos: Home Assistant y bots de Telegram

Home Assistant es la plataforma de domótica open source más usada del mundo. Se instala en una Raspberry Pi, un mini PC, o un contenedor Docker, y desde ahí controlás luces, enchufes, sensores, cámaras, termostatos y prácticamente cualquier dispositivo del hogar. La integración nativa con Telegram existe y funciona, pero tiene menos flexibilidad para lógica condicional compleja.

Telegram, por su parte, tiene una API de bots muy bien documentada. Cualquier bot se crea en segundos con @BotFather, y Telegram te entrega un token de acceso. Los webhooks permiten que cada mensaje que le mandes al bot dispare un POST hacia tu servidor, que en este caso es n8n.

Paso 1: Crear y configurar un bot de Telegram

Abrís Telegram, buscás @BotFather y mandás el comando /newbot. Te pide un nombre para el bot (el que ven los usuarios) y un username que tiene que terminar en “bot”. En menos de un minuto tenés un token tipo 7845123456:AAF-xKjy... Relacionado: integrar inteligencia artificial en tus flujos n8n.

Guardá ese token en algún lugar seguro antes de seguir. No lo pegues en un script que vayas a versionar en Git. (Sí, en serio, pasa más de lo que parece.)

Una cosa que mucha gente saltea: antes de que el webhook funcione, tenés que mandarle al menos un mensaje al bot. Telegram no enviará actualizaciones a tu webhook si el chat entre vos y el bot nunca fue iniciado.

Paso 2: Conectar Telegram a n8n

En n8n, creás un nuevo workflow y agregás un nodo Telegram Trigger. Según la documentación oficial de n8n, el nodo soporta dos modos: polling (n8n consulta Telegram periódicamente) y webhook (Telegram le avisa a n8n en tiempo real).

Para automatizaciones del hogar, webhook es lo que querés. El problema es que Telegram exige HTTPS con certificado válido. Si tu n8n está en una red local, necesitás exponerlo con un dominio y certificado, o usar un túnel como Cloudflare Tunnel.

Una vez configurado el nodo Telegram Trigger, creás la credencial pegando el token del bot. N8n registra el webhook automáticamente en la API de Telegram al activar el workflow. Podés testearlo mandándole un mensaje al bot y viendo si n8n lo captura.

Paso 3: Integración con Home Assistant en n8n

Agregás un nodo de Home Assistant al workflow. Para autenticarte, necesitás un long-lived access token de Home Assistant: vas a tu perfil en la interfaz web, bajás hasta “Long-Lived Access Tokens”, generás uno y lo pegás en las credenciales del nodo en n8n.

Según la página de integración de n8n, el nodo de Home Assistant tiene 13 acciones disponibles en 2026:

• Obtener estado de una entidad
• Obtener todos los estados
• Obtener historial de estados
• Obtener configuración
• Obtener log de errores
• Llamar a un servicio (el más usado para controlar dispositivos)
• Crear un evento personalizado
• Capturar screenshot de cámara
• Verificar configuración
• Obtener plantilla renderizada
• Obtener atributos de una entidad
• Obtener lista de servicios disponibles
• Obtener lista de entidades

La acción que vas a usar el 90% del tiempo es Call Service. Le pasás el dominio (por ejemplo light), el servicio (turn_on o turn_off), y el entity_id de la luz o dispositivo. Sobre eso hablamos en automatizar procesos complejos con n8n.

Flujos de trabajo prácticos: ejemplos paso a paso

Control de luces por comando de texto

Ponele que querés que al mandar “luces sala encender” al bot, se prendan las luces del living. El flujo es:

• Nodo Telegram Trigger captura el mensaje
• Nodo IF evalúa si el texto del mensaje contiene “encender” o “apagar”
• Nodo Home Assistant llama al servicio light.turn_on o light.turn_off con el entity_id correspondiente
• Nodo Telegram Send Message te confirma “Listo, luces encendidas”

Todo el flujo se arma en 10 minutos.

Alerta de movimiento con foto de cámara

Este es más interesante. Home Assistant detecta movimiento (trigger nativo), dispara una automatización que llama a un webhook de n8n, n8n captura un screenshot de la cámara usando el nodo HA con acción “Camera Proxy” y te manda la foto por Telegram. Tardás más en describirlo que en armarlo.

Resumen diario de consumo energético

Un workflow de n8n con trigger de Schedule (todos los días a las 20:00), que consulta varios estados de entidades de energía en Home Assistant, formatea el texto y te manda el resumen al bot. Sin código Python, sin tocar el YAML de Home Assistant.

Control por voz e IA con Gemini o Claude

Este es el que más tiempo ahorra cuando la casa tiene muchos dispositivos. Según un workflow publicado en la comunidad de n8n, la arquitectura es: Telegram recibe una nota de voz o texto libre, OpenAI Whisper transcribe el audio a texto (si es nota de voz), un modelo de IA como Gemini o Claude interpreta el comando en lenguaje natural y determina qué servicio de Home Assistant llamar, y n8n ejecuta la acción. Básicamente armás un asistente de voz local que controlás desde cualquier lado del mundo por Telegram.

Tabla comparativa: n8n vs alternativas para integrar Telegram y Home Assistant

Seguridad y mejores prácticas

La transferencia de datos entre Telegram y n8n viaja encriptada por HTTPS. Las credenciales (token de Telegram, token de HA) se guardan en la base de datos de n8n, que está en tu servidor, no en servidores de terceros. Eso es una ventaja real respecto de servicios cloud.

Eso sí, hay algunos puntos que mucha gente ignora y después paga:

• Validá el chat_id del remitente: si el webhook de tu bot es público, cualquiera que conozca el username del bot puede mandarle mensajes. Usá un nodo IF al inicio que compare el chat_id del mensaje con tu propio ID y bloqueé todo lo demás.
• Escapá los caracteres especiales: Telegram en modo Markdown rechaza mensajes con caracteres como _, *, [, o ` sin escapar. Si Home Assistant te devuelve un nombre de entidad con guiones bajos, necesitás procesarlo antes de mandar el mensaje.
• El servidor tiene que estar disponible 24/7: si n8n está en una Raspberry Pi que se cuelga, tu bot deja de responder. Para automatizaciones críticas, un VPS es mejor opción que hardware propio.

¿Y qué pasa con los long-lived tokens de Home Assistant? Expiran solo si los revocás manualmente, que está bien para uso personal pero no ideal en producción. Creá un usuario dedicado en HA con permisos limitados solo a los servicios que n8n necesita controlar.

Casos de uso avanzados: integrando IA en tus automatizaciones

Acá viene lo bueno: una vez que tenés el pipeline Telegram → n8n → Home Assistant funcionando, meter IA en el medio es agregar uno o dos nodos más. Cubrimos ese tema en detalle en explorar alternativas de automatización con IA.

El flujo con transcripción de voz usa Whisper de OpenAI para convertir notas de voz de Telegram en texto. Después, un nodo de modelo de lenguaje (n8n tiene nodos nativos para OpenAI, Anthropic, y Google AI) recibe ese texto con un prompt del tipo “Dado este mensaje del usuario, devolvé el servicio de Home Assistant a llamar y el entity_id correspondiente en formato JSON”. El modelo devuelve algo como {"service": "light.turn_on", "entity_id": "light.cocina"}, y n8n lo parsea para llamar a HA.

Le mandás una nota de voz diciendo “apagá todo en el dormitorio” y el sistema interpreta, busca las entidades del dormitorio, y las apaga. Sin comandos exactos, sin listas de palabras clave, sin configuración por cada dispositivo nuevo que agregues al hogar. (El modelo de lenguaje asume ese trabajo de mapeo, que en YAML manual sería decenas de líneas de configuración.)

Probás esto en un fin de semana, funciona bárbaro, y de ahí en más no querés volver a configurar automatizaciones con YAML.

Errores comunes al integrar telegram n8n home assistant

Error 1: usar HTTP en vez de HTTPS para el webhook

Telegram solo acepta webhooks por HTTPS con certificado válido (no self-signed). Si instalás n8n en tu red local sin dominio y certificado, el webhook simplemente no funciona y no hay error claro. Solución: usá Cloudflare Tunnel para exponer n8n con HTTPS sin necesidad de IP pública ni certificado manual.

Error 2: no iniciar la conversación con el bot antes de activar el workflow

Si creás el bot, configurás el webhook y activás el workflow en n8n sin haber mandado nunca un mensaje al bot, Telegram no entregará mensajes y parecerá que todo está roto. Mandá al menos un mensaje al bot desde tu cuenta antes de activar el workflow.

Error 3: no filtrar por chat_id

Un workflow sin validación de remitente ejecuta comandos de cualquiera que le escriba al bot. Si encontraste el username del bot en algún lado y alguien más también, tiene acceso a tu Home Assistant. Siempre agregá un nodo IF al inicio del workflow que verifique que el campo message.chat.id coincida con tu chat_id personal. Te puede servir nuestra cobertura de verificar el cumplimiento normativo en automatizaciones.

Error 4: entity_id incorrecto o con formato equivocado

El entity_id en Home Assistant tiene el formato dominio.nombre_entidad, por ejemplo light.lampara_sala. Si lo escribís mal en el nodo de n8n, el call service no falla con error visible, simplemente no hace nada. Antes de automatizar, probá el entity_id directamente desde las herramientas de desarrollo de Home Assistant.

Si querés ver casos reales, tenemos un artículo sobre telegram – n8n – home assistant.

Preguntas Frecuentes

¿Cómo conectar Telegram con Home Assistant usando n8n?

Necesitás tres componentes: un bot de Telegram creado con @BotFather, n8n instalado y accesible por HTTPS, y Home Assistant con un long-lived access token. En n8n creás un workflow con un nodo Telegram Trigger (que recibe los mensajes) seguido de un nodo Home Assistant que llama al servicio que necesitás. La configuración completa demora entre 30 minutos y 2 horas según experiencia previa.

¿Necesito saber programar para usar n8n con Home Assistant?

Para flujos básicos (prender luces, obtener estados), no necesitás escribir código. Todo se configura con nodos visuales. Para lógica más compleja como parsear respuestas de IA o transformar datos, n8n permite escribir JavaScript en nodos Code, pero es opcional. La mayoría de las automatizaciones del hogar se resuelven con los nodos nativos.

¿Es seguro usar n8n para integrar Telegram y Home Assistant?

La comunicación viaja encriptada por HTTPS. Las credenciales se almacenan en tu servidor, no en servicios de terceros. El riesgo principal es la exposición del webhook: si no filtrás por chat_id, cualquiera que conozca tu bot puede enviar comandos. Con la validación de remitente configurada, el sistema es tan seguro como tu servidor.

¿Puedo usar n8n gratis para automatizar mi hogar?

Sí. La versión self-hosted de n8n es gratuita, de código abierto, y no tiene límite de ejecuciones. Solo necesitás un servidor donde instalarlo: una Raspberry Pi, un mini PC, o un VPS. Si preferís no gestionar infraestructura, el plan cloud de n8n arranca en USD 20/mes con ejecuciones ilimitadas.

¿Qué diferencia hay entre integrar Telegram directamente en Home Assistant y usar n8n?

La integración nativa de Home Assistant con Telegram funciona bien para casos simples, pero la lógica condicional compleja requiere automatizaciones en YAML que escalan mal. N8n permite agregar nodos de IA, transformar datos, llamar a APIs externas, y tener toda la lógica visual en un solo lugar, sin tocar la configuración de Home Assistant.

Conclusión

La combinación telegram n8n home assistant le saca años de ventaja a configurar todo desde el YAML de Home Assistant. N8n actúa como capa de lógica flexible: podés manejar condiciones, transformar mensajes, agregar IA, y tener todo visible en un workflow gráfico. Si tenés Home Assistant corriendo en casa y todavía controlás todo desde la app nativa, vale la pena invertir un fin de semana en armar esto. La posibilidad de mandar un mensaje de texto o una nota de voz desde cualquier parte del mundo y que tu hogar responda justifica el esfuerzo de configuración inicial. Para el servidor donde instalés n8n, un VPS con buena conectividad es la opción más estable para garantizar que los webhooks funcionen 24/7.

Fuentes

• n8n – Integración Home Assistant + Telegram (página oficial)
• n8n Docs – Nodo de Telegram: configuración y opciones
• Home Assistant – Integración con bots de Telegram
• n8n Workflows – Control por voz y texto con Whisper, Gemini y Home Assistant
• Comunidad Home Assistant – Hilo de discusión sobre n8n y Telegram