Actualizar Home Assistant suele ser rutina… hasta que aparece un aviso que te hace frenar en seco. Con Home Assistant 2026.3 llega un warning importante para quienes usan telegram para alarmas, avisos de domótica o notificaciones diarias: el parámetro target de Telegram Bot queda obsoleto y tiene fecha de caducidad.
La buena noticia es que el arreglo es rápido y, si lo haces ahora, te evitas que en unos meses tus automatizaciones se queden mudas.
El aviso tras actualizar: dónde aparece y qué significa
Después de instalar la versión de marzo, el cambio se ve casi de inmediato. En el caso mostrado, Home Assistant queda en Core 2026.3.1, mientras que el Supervisor sigue en la versión de febrero (no siempre hay una actualización del Supervisor al mismo tiempo).
El punto clave no está en la pantalla principal, sino en Configuración, dentro de Mensajes de reparaciones. Ahí aparece un aviso que indica que se va a eliminar el parámetro target del servicio de Telegram Bot. Si tus scripts o automatizaciones aún lo usan, Home Assistant te lo marca para que lo corrijas cuanto antes.
Este aviso no es «cosmético». Lo que te está diciendo es: ahora funciona, pero dejará de hacerlo cuando llegue la versión en la que se elimina target de forma definitiva. En otras palabras, si esperas demasiado, un día tus notificaciones por Telegram no saldrán y te tocará correr para arreglarlo.
Además, el warning suele incluir ejemplos de código para orientarte. No hace falta adivinar qué cambiar, porque Home Assistant te muestra el patrón antiguo y las alternativas nuevas. Aun así, conviene entender bien qué opción elegir, ya que hay dos caminos posibles y uno suele ser más directo si ya trabajabas con un chat ID fijo.
Cuándo deja de funcionar target y qué alternativa conviene usar
El aviso es claro con la fecha: target se elimina definitivamente en 2026.9 (septiembre de 2026). A partir de ahí, lo que hoy envía mensajes, mañana puede fallar sin más.
Home Assistant propone dos formas de adaptarte:
- Sustituir
targetporchat_id. - Eliminar
targety pasar a usarentity_id.
En la práctica, si ya estabas enviando mensajes a un chat concreto, el cambio a chat_id suele ser el más sencillo: es un reemplazo directo de una palabra, manteniendo el resto igual. La ruta de entity_id puede tener sentido en otras configuraciones, pero para un ajuste rápido y limpio, chat_id suele encajar mejor.
Para verlo de un vistazo, aquí tienes la comparación:
| Opción | Qué cambias | Ventaja principal | Cuándo encaja mejor |
|---|---|---|---|
chat_id | Cambiar target por chat_id | Cambio mínimo, rápido | Cuando ya usas un chat ID concreto |
entity_id | Quitar target y añadir entity_id | Se apoya en entidades | Cuando tu diseño ya gira en torno a entidades/servicios |
Si tu objetivo es que todo siga igual, el camino corto suele ser
chat_id: cambias el nombre del parámetro y listo.
Con esto claro, el siguiente paso es localizar dónde está ese target en tu configuración, que muchas veces ya no está en automatizaciones, sino en un script.
Si antes usabas notify.telegram, esto explica por qué ahora lo tienes en scripts
En meses anteriores ya se venía avisando de cambios en el sistema de notificaciones de Telegram. La recomendación que se muestra aquí es muy práctica: en lugar de llamar directamente a notify para Telegram, crear un script dedicado y usarlo desde automatizaciones y otros scripts.
La idea es simple: en vez de repetir la llamada a Telegram por todas partes, centralizas el envío en un único script. Así, cuando cambie algo (como ahora con target), lo arreglas una vez y se acabó.
En esa forma de trabajar, lo habitual es que el envío de mensajes acabe dentro de scripts.yaml (en tu carpeta /config/). Por eso, aunque el warning aparezca tras la actualización, el cambio real se hace editando ese archivo, buscando el bloque del script que envía el mensaje por Telegram y ajustando el parámetro.
Si tienes muchos scripts, la parte «pesada» es encontrar la línea correcta. Sin embargo, en cuanto localizas el target junto al número de chat, el arreglo es casi mecánico.
Cambiar target por chat_id en scripts.yaml (sin romper nada)
Aquí va el flujo que suele funcionar mejor para aplicar el cambio con seguridad.
Localiza el script que envía el mensaje por Telegram
Abre tu editor de archivos (por ejemplo, File Editor) y ve a tu configuración. En la práctica, el lugar más común es:
/config/scripts.yaml
Dentro, busca el script que uses para avisos de Telegram. Lo reconocerás porque incluye el servicio de envío de mensajes y, justo debajo, la sección data con el parámetro target y el número del chat.
Aplica el cambio en el bloque data
El cambio es literalmente sustituir el nombre del parámetro. Mantienes el chat ID tal cual.
- Antes:
target: "TU_NUMERO_DE_CHAT" - Después:
chat_id: "TU_NUMERO_DE_CHAT"
Un ejemplo típico del fragmento, en formato de líneas para que se vea claro:
service: telegram_bot.send_messagedata:target: "123456789"
Y el mismo bloque tras el cambio:
service: telegram_bot.send_messagedata:chat_id: "123456789"
Guarda el archivo. En muchos editores verás un icono de disquete o un botón de guardar. Ese detalle importa, porque si cierras sin guardar, el warning seguirá ahí y en septiembre te acordarás del tema por las malas.
Reinicia Home Assistant y por qué el aviso no desaparece solo
Después de guardar el cambio, reinicia Home Assistant. En el caso mostrado, se hace un reinicio completo desde la sección de Sistema, porque es una forma sencilla de asegurarte de que todo recarga bien.
Un detalle que confunde a mucha gente: aunque ya esté arreglado, el mensaje de reparaciones puede seguir visible. No siempre se borra automáticamente al reiniciar. En esos casos, toca entrar de nuevo en Mensajes de reparaciones y marcarlo como resuelto manualmente (la interfaz suele mostrar una opción del tipo «Enviar» o «Terminar», según el mensaje).
Esto no significa que siga fallando. Solo indica que Home Assistant no «re-evalúa» ese aviso como esperas, o que prefiere que confirmes el cierre.
Si quieres quedarte tranquilo antes de cerrar el warning, hay una verificación muy simple: buscar tu chat ID en toda la configuración y confirmar que ya no aparece target por ninguna parte. Para eso, la Terminal es tu mejor aliada.
Verificación por Terminal: comprueba cuántas veces aparece tu chat ID
Cuando tienes varios YAML, buscar a mano es un castigo. Por eso, el método práctico es usar grep para localizar el número de tu chat ID y ver en qué archivos aparece.
En el vídeo se usan estos comandos (recuerda sustituir las x por tu número real):
grep -r "xxxxxxxxxxxx" /config/*.yamlgrep -r "xxxxxxxxxxxx" /config/**/*.yamlgrep -B3 -A1 "xxxxxxxxxx" /config/scripts.yaml
La lógica es:
- El primer comando revisa los YAML «directos» en
/config. - El segundo amplía la búsqueda a subcarpetas.
- El tercero enseña el contexto dentro de
scripts.yaml(3 líneas antes y 1 después), para confirmar que donde antes poníatargetahora ponechat_id.
¿Qué deberías ver? Lo típico, si seguiste el enfoque de script único, es que el chat ID aparezca una sola vez, y que esa aparición esté en scripts.yaml. Cuando muestras el contexto, se tiene que leer chat_id junto al número, sin rastro de target.
Si tu chat ID aparece varias veces, no pasa nada, solo significa que tienes más de un punto de envío configurado. En ese caso, repite el cambio en cada bloque que siga usando target.
Dónde ver tu chat ID en la integración de Telegram Bot (y qué pasa si tienes varios)
A veces la duda no es el cambio, sino el número. ¿Cuál era tu chat ID exacto? Home Assistant lo muestra en la propia integración.
Sigue esta ruta:
- Configuración
- Dispositivos y servicios
- Busca Telegram Bot
- Entra y revisa los números listados
Ahí verás el chat ID asociado. Si en casa enviáis avisos a varias personas, es normal que aparezcan varios IDs. En ese escenario, el trabajo se multiplica un poco, porque tendrás que actualizar cada script o cada bloque que apunte a esos chats.
Aun así, la mecánica no cambia: donde veas target, lo cambias por chat_id. Lo importante es no dejar ninguno atrás, porque el día que target desaparezca, fallará justo el destinatario que no migraste.
Cierra el warning y evita el susto de septiembre de 2026
Cuando ya confirmaste el cambio y verificaste que no quedan referencias antiguas, vuelve a Mensajes de reparaciones y cierra el aviso manualmente.
Este ajuste parece pequeño, pero tiene impacto real. En septiembre de 2026, con la eliminación definitiva en 2026.9, las notificaciones por Telegram pueden dejar de salir. Si usas esos avisos para alarmas, sensores, puertas, fugas o cualquier cosa importante, conviene dejarlo hecho ahora.
La parte buena es que, con el enfoque de scripts, se resuelve rápido. En el caso mostrado, el arreglo completo se hace en unos 20 minutos, contando reinicio y verificación.
Recursos, comunidad y enlaces útiles de Javier Gutierrez Abella
Si quieres estar al día de cambios como este, Javier Gutierrez Abella comparte vídeos, tutoriales y avisos de actualizaciones que a veces pasan desapercibidos hasta que rompen algo.
También tienes estos puntos de apoyo:
- La comunidad de Telegram de Javier Gutierrez Abella, donde ya hay más de 300 personas compartiendo dudas y soluciones.
- El foro Spylfy, con artículos, fotos, tutoriales y una sección de chollos con cupones de AliExpress (según se indica, con descuentos de 5, 10, 20, hasta 40 € en función del importe).
- El blog de Spylfy, como complemento a los contenidos del canal.
Aquí tienes un resumen de enlaces oficiales mencionados:
Si el aviso te pilló a contrapié, este es un buen momento para dejarlo cerrado y seguir con tu domótica. Y si te resultó útil, en el canal suelen pedir tres cosas: 👍 dar like, 💬 contar tu caso en comentarios, y 🔔 suscribirte para no perderte los siguientes avisos.
Conclusión: un cambio pequeño que evita que Telegram se quede en silencio
El fin de target en Telegram Bot suena serio, pero el arreglo es directo si actúas ya. Cambia target por chat_id en tu scripts.yaml, reinicia, verifica con Terminal y cierra el aviso en Reparaciones.
A partir de ahí, tus notificaciones de telegram quedan listas para la eliminación definitiva en 2026.9. Si te apetece, comparte cuántos chats tienes configurados y si tu chat ID aparecía en más de un archivo, esa pista puede ayudar a otros.
