Site icon JusteGeek

Mettre en place des notifications mail sur Home Assistant

L’une des choses qui m’a le plus surprise lors de mon passage sur Home Assistant, c'est l’absence de configuration d’un connecteur SMTP pour pouvoir envoyer des notifications par email. Cela relève pour moi d’une fonctionnalité assez basique et je dois bien avouer que j’ai été un peu frustré de voir que ce n'était pas nativement prévu et qu’il allait falloir passer par la case édition de fichiers de configuration pour pouvoir obtenir des alertes mails… Bon, la mise en place n’est pas compliquée mais pourrait en rebuter certains, notamment si vous n'êtes pas trop férus de technologie… Bref, je vous propose donc aujourd'hui un petit tutoriel sur la mise en place des notifications mail sur Home Assistant.

Notifications mail sur Home Assistant

Les prérequis

Pour pouvoir mettre en place des notifications mail sur Home Assistant, nous allons avoir besoin de deux éléments : la configuration du serveur web et le module complémentaire File editor.

La configuration du serveur web dépendra bien évidemment de votre messagerie. Pour ma part dans ce tutoriel, je vais utiliser une messagerie hébergée chez OVH, à vous d'adapter les informations si votre messagerie est différente. Dans tous les cas, nous aurons besoin, à minima, de : nom du serveur, numéro du port, le username et le password.

Les paramètres à connaitre pour la messagerie OVH sont les suivants :

Pour le module complémentaire File editor, si vous ne l'avez pas installé, je vous renvoie à mon article Premier pas sur Home Assistant, dans lequel je vous explique comment faire.

C'est bon pour vous ? Vous disposez bien des prérequis ? Et bien on attaque notre configuration mail.

Configuration du serveur mail (SMTP)

Pour effectuer notre configuration SMTP, on va se rendre dans le plugin File editor soit en utilisant le raccourci de la barre latérale (si vous l'avez activé) soit en allant dans Paramètres > Modules Complémentaires > File editor puis en cliquant sur le bouton OUVRIR L'INTERFACE UTILISATEUR WEB.

Depuis n'importe quelle page de HA, ouvrez le plugin 'File editor'

Une fois dans le plugin, cliquez sur l'cône en forme de dossier, en haut à gauche.

Cliquez sur le bouton 'Parcourir' pour rechercher le fichier de configuration

Choisissez le fichier configuration.yaml

Choisissez le fichier de configuration nommé 'configuration.yaml'

Ajoutez votre configuration email, comme ceci (attention à bien conserver l'indentation):

notify:
  - name: "email"
    platform: smtp
    server: ssl0.ovh.net
    port: 587
    timeout: 15
    sender: 
    username: 
    password: 
    recipient: 
    sender_name: 

On a donc ici plusieurs champs que vous allez devoir personnaliser : le sender qui est l'adresse utilisée pour envoyer votre mail (ce sera votre adresse mail expéditrice), le username et le password de votre compte email, le recipient qui est le destinataire des emails de notification et le sender_name qui est le nom d'affichage de l'expéditeur. Ce qui devrait vous donner quelque chose qui ressemble à ça :

Exemple de configuration SMTP. Une fois renseignée, cliquez sur la disquette rouge en haut à droite pour enregistrer

Une fois que c'est bon, pensez à enregistrer vos modifications en utilisant le bouton rouge en forme de disquette en haut à droite. Ensuite, il ne nous reste qu'à redémarrer HA pour que notre configuration soit prise en compte. Pour cela, cliquez sur Paramètres puis en haut à droite sur les trois points et enfin sur Redémarrer Home Assistant.

Redémarrer Home Assistant

Sélectionnez ensuite l'option Redémarrer Home Assistant et confirmer avec le bouton REDÉMARRER. Et une fois que notre HA est de nouveau en ligne, et bien notre configuration email sera opérationnelle. Mais bien évidemment notre tutoriel ne s'arrête pas là, puisque si nous avons défini la possibilité d'envoyer des alertes mails, encore faut il que HA sache dans quels cas il doit envoyer des notifications par mails. On va donc tout de suite se faire un petit exemple.

Création des notifications mail sur Home Assistant

Pour l'exemple, on va mettre en place une notification par email, certes pas très utile je pense mais qui vous permettra tout de suite de comprendre le fonctionnement. Pour créer des notifications mail sur Home Assistant, on va tout simplement créer une automatisation, c'est à dire qu'un événement déclencheur entraînera l'envoi d'une notification par email. On va ainsi dire que l'on souhaite recevoir une notification par email, lorsqu'une lumière est allumée.

Ouvrez donc le menu Paramètres et cliquer sur Automatisations et scènes.

Cliquez sur Automatisations et scènes

Cliquez ensuite en bas à droite sur CRÉER UNE AUTOMATISATION.

Cliquez sur CRÉER UNE AUTOMATISATION

On va d'abord définir notre événement déclencheur, à savoir l'allumage d'une lumière. Cliquez donc sur AJOUTER UN DÉCLENCHEUR.

Ajout d'un déclencheur pour l'automatisation

Choisissez Entité.

Choisissez ici 'Entité'

Puis Etat.

Choisissez ensuite 'Etat'

Recherchez ensuite votre dispositif dans les entités. Pour mon exemple, je vais choisir un ruban LED nommé RUBAN LED 1. Puis on va renseignez les champs De et A pour le passage du statut Eteint au statut Allumé.

Exemple de déclencheur : un ruban LED passe de "éteint" à "allumé"

Descendez ensuite dans la partie Alors faire et cliquez sur le bouton AJOUTER UNE ACTION et sélectionnez l'entrée Notifications.

Sélectionnez l'action 'Notifications'

Puis Send a notification with email.

Sélectionnez l'action 'Notification with email'

Renseignez le message et éventuellement le titre du message que vous souhaitez envoyer, et cliquez en bas sur ENREGISTRER.

Exemple de configuration de notifications mail sur Home Assistant

Donner ensuite un nom à cette automatisation et validez avec le bouton ENREGISTRER.

Donnez un nom à votre automatisation

Et voilà ce que j'ai reçu, instantanément dans ma boite email après avoir allumé mon "ruban LED 1" :

Voici un exemple de mail envoyé par Home Assistant

Voilà, vous savez maintenant comment créer des notifications mail sur Home Assistant. Mon exemple ici est assez basique, car vous pouvez aller assez loin avec le contenu des notifications. Je vous montrerai par exemple dans un prochain tutoriel comment créer une alerte mail unique dont le contenu variera en fonction des statuts des capteurs...

Quitter la version mobile