Notifications Telegram et Home Assistant : comment résoudre le changement de 2026.11

Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.

Albert BarnosellEditor y responsable de Tecnoyfoto

Vos notifications Telegram n’arrivent plus après une mise à jour de Home Assistant ? Si vos automatisations utilisaient l’ancien notificateur, le changement introduit dans Home Assistant 2026.11 peut expliquer la panne. Telegram reste disponible : c’est une ancienne méthode d’envoi qui a été supprimée.

Voici comment identifier les actions concernées, contrôler Telegram bot et adapter vos messages. Pour une installation importante, vous trouverez aussi deux instructions destinées à un assistant IA afin de faciliter l’inventaire puis la réparation.

Ce qui change pour Telegram dans Home Assistant 2026.11

L’ancienne plateforme YAML notify avec platform: telegram, déjà obsolète, a été retirée. Les actions qu’elle créait, par exemple notify.telegram ou un nom personnalisé, ne sont plus enregistrées. Les utilisateurs déjà passés aux actions actuelles de Telegram bot ne sont pas forcément concernés. Ce changement est indépendant de Marketplace.

Telegram bot reste pris en charge et crée une entité de notification pour chaque chat autorisé. Pour un texte simple, utilisez notify.send_message ; les actions telegram_bot.* servent notamment aux médias et aux options propres à Telegram.

Examiner l’installation avant toute modification

1. Vérifiez la version installée dans Paramètres → Système → Informations.
2. Dans Paramètres → Appareils et services, recherchez Telegram bot. Examinez la configuration existante avant de créer un nouveau bot.
3. Vérifiez les chats autorisés et leurs entités de notification : leurs noms et destinataires dépendent de votre installation.
4. Consultez les traces des automatisations et scripts pour repérer les anciennes actions introuvables.
5. Avant de modifier des fichiers, conservez une sauvegarde restaurable hors de Home Assistant et notez les états actifs ainsi que la procédure de retour arrière.

Une recherche textuelle aide à repérer les références et les anciens noms personnalisés, mais elle peut compter des commentaires, des copies ou des fichiers inactifs. Examinez séparément les automatisations, scripts, packages, modèles et alertes : une occurrence n’est pas forcément une panne confirmée.

Trouver le notificateur et tester un message

Ouvrez Telegram bot et consultez ses entités et les chats autorisés. Si le destinataire manque, utilisez le menu de l’intégration pour ajouter un chat autorisé. Les jetons et identifiants de chat sont confidentiels : ne les affichez pas dans une vidéo et ne les publiez pas.

Dans Outils de développement → Actions, choisissez notify.send_message, sélectionnez la bonne entité et envoyez un texte sans conséquence. Vérifiez sa réception dans le bon chat. Le nom ci-dessous est un exemple à remplacer :

action: notify.send_message
data:
  entity_id: notify.ENTITE_TELEGRAM
  message: "Test de notification Home Assistant"

Dans une liste d’actions YAML, ajoutez le tiret initial et respectez l’indentation. Une action exécutée sans erreur ne prouve pas à elle seule que le bon destinataire a reçu le message.

Adapter une action simple dans une automatisation

Une ancienne action pouvait ressembler à ceci ; son nom réel peut être différent :

- action: notify.telegram
  data:
    message: "Le lave-linge a terminé"

Pour un texte simple adressé au bon destinataire, voici une possibilité actuelle :

- action: notify.send_message
  data:
    entity_id: notify.ENTITE_TELEGRAM
    message: "Le lave-linge a terminé"

Conservez les déclencheurs, modèles, destinataires, ordre des actions et état activé ou désactivé. Commencez par un cas non critique, puis vérifiez la trace et la réception. Selon la structure et la gestion des erreurs, une action en échec peut empêcher les actions suivantes de s’exécuter.

Photos, plusieurs chats et options particulières

Une photo ou une pièce jointe ne se migre pas forcément par un simple changement de nom. Telegram bot propose des actions dédiées, par exemple :

- action: telegram_bot.send_photo
  data:
    entity_id: notify.ENTITE_TELEGRAM
    file: /media/image-exemple.jpg
    caption: "Alerte avec image"

Ce chemin est fictif : le fichier doit exister et être accessible par Home Assistant. Examinez individuellement les documents, vidéos, titres, modèles, formats HTML ou Markdown, boutons, messages silencieux, groupes et sujets de discussion. Les champs ou formats peuvent nécessiter une adaptation.

Choisissez explicitement les destinataires. Pour certaines actions Telegram, si un seul bot est configuré et que le destinataire est omis, le premier chat autorisé est utilisé ; avec plusieurs bots, une entité ou un bot doit parfois être précisé. Ne supposez pas que tous les destinataires recevront le message.

Alertes répétées et fonctions sensibles

L’intégration alert peut dépendre de notificateurs traditionnels. Remplacer directement un nom dans notifiers: par une entité moderne ne garantit pas un comportement équivalent. Vérifiez la compatibilité et conservez les répétitions, l’acquittement et le message de fin nécessaires.

Pour les alertes de sécurité et les appareils électroménagers, testez l’envoi isolément quand c’est possible. Ne déclenchez pas une alarme, un moteur ou un appareil uniquement pour tester Telegram. Une fonction critique non vérifiable en sécurité doit rester signalée comme en attente.

Utiliser une IA pour une installation complexe

Un assistant capable de travailler sur les fichiers, comme Codex, peut aider à inventorier et adapter une grande configuration. Il peut aussi se tromper ou exposer des données accessibles : limitez ses accès, ne collez pas de secrets dans la conversation, gardez des sauvegardes et vérifiez les résultats.

Prompt 1 : investigation en lecture seule

Examine mon Home Assistant en lecture seule pour repérer les anciennes notifications Telegram. Vérifie la version, Telegram bot, les entités notify et les actions disponibles. Identifie les automatisations, scripts, packages et alertes concernés, en distinguant la configuration active des copies. Sépare les textes, modèles, pièces jointes, destinataires, groupes et options particulières. Indique ce qui est vérifié et ce qui reste inconnu. Ne modifie rien et n’envoie aucun message. N’affiche ni n’enregistre de secrets, adresses privées, identifiants de chat ou noms personnels ; utilise des valeurs génériques.

Prompt 2 : réparation contrôlée

Adapte les anciennes notifications Telegram de mon Home Assistant aux actions actuelles. Commence par inventorier les usages et destinataires, crée des copies hors de Home Assistant et prépare le retour arrière. Conserve les modèles, l’ordre, le comportement et les états d’activation ; vérifie individuellement les photos, boutons, groupes et alertes répétées. Valide la configuration et contrôle la réception par des tests limités. N’active aucune alarme ni aucun appareil pour tester. Consulte-moi si une fonction critique ne peut pas être vérifiée en sécurité. N’affiche pas de secrets, adresses privées ou identifiants réels et ne prétends pas avoir vérifié une réception sans preuve. Indique les changements et les points en attente.

Contrôles avant de considérer la migration terminée

• La notification arrive à la bonne personne, dans le bon groupe et le bon sujet.
• Les photos, formats et boutons utilisés ont été testés séparément.
• Les traces et les actions suivantes sont vérifiées.
• Les alertes critiques sont testées de façon appropriée ou explicitement indiquées comme en attente.
• La sauvegarde et la procédure de restauration restent accessibles.

Un simple message peut être facile à adapter, mais chaque installation demande de vérifier ses propres destinataires et comportements.