Una de las primeras configuraciones que debemos hacer en Home Assistant son configurar las notificaciones. Al ser un sistema operativo de código libre, tenemos la posibilidad de instalar diferentes formas de notificarnos que ha ocurrido algo, no obstante, creemos que una de las mejores formas para avisarnos de todo lo que ocurre es a través de Telegram. Gracias a que podemos crear bots, tenemos la posibilidad de integrarlo directamente en la domótica de nuestra casa, para que nos envíen notificaciones tanto de manera individual (solamente a nosotros) como también a un grupo con más personas (por ejemplo, un grupo con toda la familia). Si quieres saber cómo configurar un bot en Telegram para usarlo como notificaciones en Home Assistant, a continuación, tenéis todos los detalles.
Telegram es la aplicación por excelencia para las notificaciones de diferentes softwares, y es que podemos integrar notificaciones con un bot para nuestro router, servidor NAS, para nuestro sistema de monitorización, y también para nuestro sistema de domótica. Si quieres conocer cómo se crea y configura un bot, y cómo se incorpora a HAOS, os enseñamos todos los pasos que debes hacer.
¿Para qué me sirve esto?
Si bien Home Assistant ofrece notificaciones push nativas, la integración con Telegram proporciona ventajas operativas clave como un historial persistente de alertas y la facilidad para notificar a grupos familiares.
Aunque podríamos lanzar notificaciones push a través de la aplicación de Home Assistant para smartphones, creemos que Telegram proporciona ventajas operativas clave como un historial persistente de alertas y la facilidad para notificar a grupos familiares. Además, podemos verlo directamente desde nuestro smartwatch, algo que con las notificaciones push no podríamos si no es compatible. Por ello, la recomendamos como solución principal para todas las notificaciones.
Por ejemplo, un uso que hacemos nosotros a estas notificaciones, es que los avisos que tienen que ver con la administración del sistema de domótica, como las actualizaciones de HAOS, actualizaciones de los diferentes dispositivos domóticos como Shelly, o algún problema que tengamos automatizado, automáticamente se enviará una notificación a nuestro smartphone de manera individual. Sin embargo, si hay notificaciones que tienen que ver con los miembros de la casa, como, por ejemplo, si nos hemos dejado la puerta del garaje abierta, si han llamado al timbre, o si hay demasiado consumo de electricidad en un determinado momento, podemos enviar estos avisos directamente a un grupo donde estemos nosotros y también nuestra pareja, hijos etc.
Para poder dar de alta este tipo de notificaciones, lo primero que debemos hacer es crear el correspondiente bot, crear un grupo con el bot dentro de dicho grupo, y posteriormente sacar tanto las API KEY como los ID de los diferentes bots y chats que nosotros queramos configurar.
Crear un bot en Telegram para Home Assistant
Lo primero que tenemos que hacer es buscar el popular «BotFather» a través de Telegram e iniciarlo. Siguiendo los pasos, podemos pulsar sobre «newbot» para crear un nuevo bot. Le daremos un nombre al bot y después el nombre de usuario del bot, este último debe terminar en «bot» o bien «_bot», de lo contrario no podremos configurarlo. Es la forma que tiene la plaforma de mensajería de diferenciar un bot del que no lo es. Lo más importante de este paso es el HTTP API KEY que nos proporciona.
Una vez creado, podemos iniciar el bot en nuestro móvil sin ningún problema. Si volvemos a BotFather podemos ver todo el listado de bots poniendo «mybots» tal y como podéis ver. También tenemos la posibilidad de realizar ciertas configuraciones como añadir una descripción, una fotografía y otros ajustes.
Después de crear el bot, debemos llamar a un bot que se llama «getmyid», hay muchos actualmente, podemos usar cualquiera de ellos. Este bot se encarga de proporcionarnos el ID de nuestro Telegram para que el bot que hemos creado nos pueda enviar mensajes.
Con el ID, ya podremos enviar mensajes de forma individual a nuestro smartphone, pero lo más interesante es crear un grupo para que más personas de nuestra familia puedan recibir dichas notificaciones.
Configurar un grupo con el bot dentro
Para configurar un grupo con el bot dentro, lo único que tenemos que hacer es crear un grupo con varias personas como hacemos normalmente. Después añadiremos al bot de Home Assistant que hemos creado anteriormente, pero también tenemos que añadir el boy de «getmyid» para que nos proporcione el ID del chat de grupo (que es diferente del chat individual). Todos los ID de chats de grupos tienen un signo menos delante del ID, tal y como podéis ver:
Ahora ya está Telegram listo para recibir las notificaciones, y solamente necesitaremos configurar Home Assistant para enviarlas.
Configuración de Home Assistant
Desde la versión de Home Assistant 2023.12, hicieron un cambio importante en la integración de Telegram, ya no es necesario usar un archivo de configuración YAML para esto, sino que se hace directamente a través de la interfaz gráfica de usuario. Desde mitad del año 2025 es obligatorio usar la nueva forma de integración. Por lo que ahora mismo, la forma de dar de alta la integración es completamente diferente a cómo era antes. Al tener una integración oficial y a través de la interfaz gráfica de usuario, ya no es necesario configurar ningún archivo configuration.YAML como sí ocurría antes, además, todo se ha unificado usando el nuevo «Notify» para las notificaciones de cualquier tipo, no hay que usar el propio servicio de Telegram sino el servicio Notify con el «Objetivo» de Telegram.
Lo primero que debes hacer es irte a «Ajustes / Dispositivos y servicios«, pinchamos en «Añadir integración» y buscamos «Telegram bot«:
Ahora se nos abrirá un nuevo menú, y tendremos que elegir el modo de configuración de Telegram Bot, podemos elegir entre «Difusión» o «Sondeo«. La diferencia entre ambos es la siguiente:
- Difusión (Broadcast): solo admite el envío de mensajes. No es necesario que expongamos la instalación de Home Assistant a Internet, no se hace un sondeo para recibir mensajes o comandos enviados al bot.
- Sondeo (Polling): permite envío y recepción de mensajes por parte dle bot. Obtiene datos mediante un sondeo largo con un tiempo de espera de 10 segundos. Si vas a hacer automatizaciones con envío de comandos por Telegram, debes elegir el modo sondeo para que funcione correctamente, y el sistema de mensajería comprobará la recepción de comandos.
Cualquiera de las dos opciones son válidas, si solamente vas a enviar usa difusión, si vas a enviar mensajes y recibir datos entonces elige sondeo. No es recomendable usar Webhooks debido a que tienes que exponer a Internet tu instalación de Home Assistant. En cualquier momento podrías cambiar el comportamiento de la integración pinchando en «Ajustes» de la integración, por lo que puedes cambiar de opinión en cualquier momento.
En el menú principal del «Telegram Bot» podemos añadir los ID de chats permitidos, podemos añadir tanto los ID de chats individuales como también de grupos donde hayamos metido previamente al bot.
Si pinchamos en «Añadir ID de chat permitido» tendremos que introducir solamente el ID del chat, tal y como hemos obtenido anteriormente. Podemos añadir todos los que nosotros necesitemos.
Tal y como habéis visto, configurar un bot de Telegram en Home Assistant es muy sencillo, ahora vamos a probarlo a través del propio sistema para comprobar que funciona correctamente, para ello simplemente debemos irnos a «Herramientas para desarrolladores» y en la pestaña de «Acciones» ponemos lo siguiente:
Una vez que tengamos esto, pinchamos en el botón de «REALIZAR UNA ACCION» y de forma instantánea recibiremos una notificación por Telegram en nuestro smartphone. Esta es la mejor forma para comprobar que efectivamente funciona todo correcto, también podéis probar con la notificación de grupo, y así comprobáis las dos formas de notificación. A continuación, podéis ver capturas de los mensajes enviados directamente desde nuestra instancia de Home Assistant.
Tal y como podéis ver, el proceso de crear un bot y añadirlo a Home Assistant es bastante sencillo, podemos crear diferentes bots y grupos, no hay ningún tipo de limitación en este aspecto. De esta forma, podemos enviar ciertos mensajes a un usuario en concreto, y otros mensajes a otro usuario que tengamos dado de alta en el sistema de domótica. Un aspecto muy importante, es que vamos a tener ciertas limitaciones debido a la API para evitar los abusos, algunas de las recomendaciones que nos proporciona el sistema de mensajería para no tener problemas, son las siguientes:
- No enviar más de un mensaje por segundo. Es posible que el sistema permita ráfagas breves de varios mensajes simultáneamente, pero si se envían demasiados dará error y no se enviarán.
- Si se envían notificaciones a varios usuarios de forma simultánea, la API no permite enviar más de 30 mensajes por segundo. Esto tiene como objetivo evitar abusos como hemos mencionado anteriormente.
- El bot que creemos no podrá enviar más de 20 mensajes por minuto al mismo grupo.
Como podéis ver, existen ciertas limitaciones para evitar el SPAM continuado de mensajes. En circunstancias normales no tendremos tantas notificaciones como para llegar a los límites, no obstante, es muy importante que lo tengas en cuenta para evitar problemas. Si después de enviar múltiples notificaciones, tienes problemas para recibir más, es posible que te hayan limitado por abuso, es cuestión de esperar unas horas hasta que vuelva a funcionar correctamente todo.
Ejemplos prácticos: creando automatizaciones con alertas
Si quieres saber cómo integrar las notificaciones por Telegram en tus automatizaciones de Home Assistant, a continuación, os ponemos algunos ejemplos para que podáis ponerlo en marcha.
Aviso de puerta de garaje abierto
En este ejemplo, mandaremos avisos por Telegram cuando la puerta del garaje está abierta durante 3 minutos. Los desencadenantes son el sensor de puerta de garaje abierta o entre abierta, con varias acciones en «Entonces hacer»:
- Enviar notificación básica por Telegram indicando que la puerta está abierta durante 3 minutos.
- Capturar una foto a través de la cámara IP, guardarla en local, y enviarla por Telegram. Esperar 10 segundos y volver a enviar una nueva foto, y enviarla por Telegram.
El código completo es el siguiente:
alias: ALERTA - Puerta Garaje Abierto 3 minutos
description: >-
Aviso por Telegram cuando la puerta del garaje está abierta durante 3
minutos.
triggers:
- entity_id: sensor.sensor_puerta_estado_garaje
to: Abierta
for:
hours: 0
minutes: 3
seconds: 0
trigger: state
- entity_id: sensor.sensor_puerta_estado_garaje
to: Entre-Abierta
for:
hours: 0
minutes: 3
seconds: 0
trigger: state
conditions: []
actions:
- action: notify.send_message
metadata: {}
data:
title: PUERTA GARAJE {{ states ('sensor.sensor_puerta_estado_garaje') }}
message: >-
¡La puerta lleva {{ states ('sensor.sensor_puerta_estado_garaje') }} 3
minutos! Te envío un par de fotos para su verificación:
target:
entity_id: notify.telegram_bot_xxx_xxx
- repeat:
count: 2
sequence:
- action: camera.snapshot
data:
filename: /config/z_camara_fotos/foto_estado_garaje.jpg
target:
entity_id: camera.reolink_e1_outdoor_instantaneas_clear
- action: telegram_bot.send_photo
data:
verify_ssl: true
file: /config/z_camara_fotos/foto_estado_garaje.jpg
target:
- "xxxx"
config_entry_id: xxxx
- delay:
hours: 0
minutes: 0
seconds: 10
milliseconds: 0
mode: single
Aviso mucho consumo de electricidad
En este ejemplo, mandaremos avisos por Telegram cuando el consumo de electricidad supere los 700W durante 2 minutos, todo ello medido con un Shelly EM. Los desencadenantes son el sensor Shelly EM si está por encima de 700W y dura más de 2 minutos.
- Enviar notificación básica por Telegram indicando que hay un consumo de más de 700W durante 2 minutos.
- Se apaga la automatización actual durante 30 minutos, y luego se vuelve a activar. Esto lo hacemos para que no esté continuamente enviando notificaciones.
El código completo es el siguiente:
alias: AVISO - Solar - Consumo luz externa
description: Aviso de consumo red eléctrica general
triggers:
- trigger: numeric_state
entity_id:
- sensor.powen_red_entidad
for:
hours: 0
minutes: 2
seconds: 0
above: 700
conditions: []
actions:
- action: notify.send_message
metadata: {}
data:
title: SOLAR
message: "AVISO: Consumo red eléctrica >700W durante 2 minutos. "
target:
entity_id: notify.telegram_bot_xx_xx
- data:
stop_actions: false
target:
entity_id: automation.solar_consumo_luz_exterior
action: automation.turn_off
- delay:
hours: 0
minutes: 30
seconds: 0
milliseconds: 0
- data: {}
target:
entity_id: automation.solar_consumo_luz_exterior
action: automation.turn_on
mode: single
Aviso batería baja en dispositivos
Si quieres controlar el estado de la batería de varios dispositivos, puedes enviarte alertas por Telegram para ello. En este ejemplo, mandaremos avisos por Telegram cuando la batería esté por debajo del 15%. El código completo es el siguiente:
alias: AVISO - Shelly Blu HT batería baja
description: ""
triggers:
- trigger: numeric_state
entity_id:
- sensor.shellyhtexterior_battery
below: 15
conditions: []
actions:
- action: notify.send_message
metadata: {}
data:
title: AVISO - ShellyBLU HT exterior batería baja
message: >-
La batería es inferior al 15%, comprobar para reemplazarla lo antes
posible.
target:
entity_id: notify.telegram_bot_xxx_xxx
mode: single
Como podéis ver, tenemos muchos escenarios donde una notificación por Telegram es la mejor forma de avisar si algo ocurre.
Desventajas de usar Home Assistant con Telegram
Si bien es cierto que es una herramienta muy interesante, hay que tener en cuenta ciertas desventajas antes de configurarlo, que puede que no a todos les afecte, según su uso, pero que no está de más conocerlas:
- Dependencia de internet: Pese a que es lógica, hay que mencionarla, y es que el sistema depende completamente de una conexión a de red a internet ya sea tanto para Home Assistant como para el sistema de mensajería. Si la conexión se interrumpe (por el motivo que sea), no se recibirán alertas, y puede que no nos demos cuenta de ello.
- Privacidad y seguridad: aunque es un sistema cifrado y seguro, sin embargo, los bots, así como nuestras cuentas, pueden llegar a ser hackeados, o accesibles por una persona externa, por lo que, dependiendo de lo que mostremos al bot, podremos estar más o menos comprometidos. Algo que tenemos que tener en cuenta.
- Limitaciones: tenemos límites en la frecuencia de envío de mensajes (rate limiting). Si tienes muchas automatizaciones que envían alertas frecuentes, podrías enfrentar retrasos o pérdida de mensajes.
- Mantenimiento y configuración: Dejar todo listo puede ser un quebradero de cabeza para gente con pocos conocimientos, sin embargo, no es lo único, ya que una vez completado, puede que tengamos que volver a configurar todo, si a Home Assistant o Telegram les da por cambiar sus APIs.
- Fiabilidad del bot: el bot puede dejar de funcionar correctamente debido a problemas con los servidores, lo que nos llevaría a no recibir notificaciones, pudiendo causar un problema en ciertas ocasiones. Hay que recordar que este servicio es gratuito, y todo lo que no es de pago, es más susceptible a recibir caídas o problemas.
Estas son las principales consideraciones a tener en cuenta según nuestra experiencia con sistemas domóticos en entornos reales.