Notifications Home Assistant : les recevoir sur téléphone

En bref : une notification avant une automatisation

Pour recevoir les notifications Home Assistant sur votre téléphone, associez l’application Companion au serveur, autorisez les notifications et testez l’action destinée à ce téléphone. Ajoutez ensuite un déclencheur simple. Cette progression permet de distinguer un problème de livraison du message d’un problème dans votre automatisation.

• Prérequis : Home Assistant fonctionnel, compte administrateur pour utiliser les outils de test et application Companion sur le téléphone.
• Commencez avec un message texte sans image, lien ni bouton.
• Testez l’action manuellement avant de programmer son envoi.
• Durée à prévoir : une courte session de configuration si le serveur et l’application sont déjà accessibles ; le dépannage peut demander davantage.

Ce tutoriel suppose que le serveur fonctionne déjà. Si ce n’est pas le cas, suivez d’abord notre installation de Home Assistant pour débutants. Nous allons préparer un rappel de démonstration, puis vérifier son arrivée sur le téléphone. Les intitulés de menus peuvent varier avec la version et la traduction de votre interface.

1. Comment associer le téléphone à Home Assistant ?

Installez l’application officielle Home Assistant Companion et connectez-la à votre serveur. Elle peut proposer les instances découvertes sur le réseau ; sinon, saisissez l’adresse que vous utilisez pour ouvrir Home Assistant. Identifiez clairement le serveur choisi si plusieurs apparaissent, puis terminez la connexion avec votre compte.

Le guide de démarrage de Companion détaille cet assistant de connexion. Choisissez un nom reconnaissable pour le téléphone : cela simplifiera le choix du destinataire. Si plusieurs membres du foyer utilisent Home Assistant, prenez le temps de vérifier à quel appareil vous envoyez le message.

L’intégration Mobile App assure la liaison avec l’application. Elle est normalement chargée par la configuration par défaut de Home Assistant. Une installation très personnalisée peut demander de vérifier sa présence. Ne créez pas une intégration de notification générique avant d’avoir confirmé que le téléphone est bien enregistré.

2. Quelles permissions faut-il autoriser ?

Autorisez les notifications pour Home Assistant dans le système du téléphone. La permission d’afficher des alertes est distincte des permissions de localisation ou d’autres capteurs. Pour ce premier essai, le résultat attendu est un message visible, sans demander au téléphone de transmettre toutes ses données ni d’activer un scénario de présence.

Dans Companion, vérifiez le serveur et le nom de l’appareil. La documentation des notifications indique que les actions destinataires prennent la forme notify.mobile_app_ suivie de l’identifiant du téléphone. Cet identifiant doit être repris tel qu’il apparaît dans votre installation. Le titre est facultatif ; le champ message est nécessaire.

Gardez le premier texte très neutre, par exemple « Le test est arrivé ». Vous pourrez choisir ensuite ce qui mérite une alerte. Pour les détails sensibles, le contenu affiché sur un écran verrouillé mérite une décision explicite. Notre dossier sur la vie privée dans une installation domotique aide à distinguer les données utiles de celles qu’il vaut mieux éviter de diffuser.

3. Comment envoyer une notification de test ?

Avec un compte administrateur, ouvrez l’onglet Actions des outils Home Assistant et sélectionnez l’action correspondant à votre téléphone. Remplissez un message simple puis exécutez l’action. Cette commande envoie réellement une notification, sans attendre un capteur ni une heure programmée. Le destinataire se choisit dans le nom de l’action mobile.

La documentation actuelle des outils place cet écran dans Paramètres, Outils, Actions. Sur certaines versions, il apparaît sous Outils de développement, Actions. En mode YAML, utilisez cet exemple en remplaçant impérativement notify.mobile_app_mon_telephone par le nom proposé chez vous :

action: notify.mobile_app_mon_telephone
data:
  title: "Test Home Assistant"
  message: "Le test est arrivé sur le téléphone."

Lancez l’action, puis regardez le téléphone. Notez séparément une erreur affichée dans Home Assistant et l’absence de bannière sur le mobile : ce ne sont pas les mêmes observations. Tant que ce test ne produit pas le résultat attendu, conservez ce petit message et passez au diagnostic ci-dessous. Ajouter des images ou des boutons compliquerait inutilement la recherche.

4. Comment programmer un rappel simple ?

Créez une automatisation avec un déclencheur horaire et reprenez l’action déjà validée. Un rappel à heure fixe permet de vérifier toute la chaîne sans installer de capteur supplémentaire. L’heure donnée ci-dessous sert seulement d’exemple : remplacez-la par une heure proche, encore à venir, pour votre essai.

Dans Paramètres, Automatisations et scènes, créez une automatisation. L’éditeur officiel permet de choisir un déclencheur, des conditions facultatives et les actions. Vous pouvez aussi passer en édition YAML pour coller la définition complète suivante. N’ajoutez pas ce bloc dans le formulaire réservé à une seule action.

alias: "Rappel de démonstration sur le téléphone"
description: "Vérifier la réception d’une notification horaire"
triggers:
  - trigger: time
    at: "18:30:00"
conditions: []
actions:
  - action: notify.mobile_app_mon_telephone
    data:
      title: "Rappel maison"
      message: "Pensez à vérifier les fenêtres avant de partir."
mode: single

Le déclencheur horaire de Home Assistant lance l’automatisation à l’heure choisie. Enregistrez-la et vérifiez qu’elle est activée. Après l’essai, désactivez ce rappel de démonstration si vous n’en avez pas besoin. Une fois cette base comprise, un détecteur de fuite correctement placé peut fournir un événement plus utile, à condition de vérifier son intégration et son état réel.

5. Que vérifier si le message n’arrive pas ?

Vérifiez d’abord l’action manuelle, puis l’automatisation. Une action absente suggère un problème d’enregistrement du téléphone ; une action présente mais sans réception demande de contrôler le message et l’application. Si le test manuel fonctionne, concentrez-vous sur le déclencheur et les traces de l’automatisation.

La page de dépannage Companion recommande notamment de vérifier les permissions et l’enregistrement push. Après la première association, un redémarrage de Home Assistant peut être nécessaire pour voir apparaître l’action. Évitez de supprimer immédiatement le téléphone : relevez d’abord ce qui manque exactement.

Consultez ensuite les traces de l’automatisation. Exécuter ses actions manuellement ne valide pas son déclencheur. Pour vérifier le scénario complet, attendez l’événement prévu et ouvrez la trace correspondante. Vous saurez si l’automatisation a commencé et jusqu’où elle est allée, ce qui rend le dépannage beaucoup plus précis.

Les notifications restent-elles entièrement locales ?

Pas nécessairement : une automatisation exécutée chez vous peut envoyer son message par une infrastructure push distante. Le mode Local Push constitue un autre chemin, avec ses propres conditions de connexion. Distinguez aussi recevoir une alerte et ouvrir ensuite le tableau de bord depuis l’extérieur : ces deux fonctions ne se valident pas avec le même essai.

La documentation Local Push décrit une connexion WebSocket directe. Sur iOS, son usage dépend notamment de l’adresse interne et des réseaux Wi-Fi déclarés comme internes. Sur Android, la connexion persistante se règle dans Companion et implique des contraintes d’arrière-plan. Être simplement connecté au Wi-Fi ne suffit donc pas à conclure que la livraison est locale.

Pour consulter ensuite Home Assistant hors du domicile, reportez-vous au dossier consacré à l’accès distant à Home Assistant. Ici, le contrôle final reste concret : le bon événement déclenche le bon message sur le bon téléphone, dans les conditions où vous comptez réellement l’utiliser.