Configurer les alertes email dans Home Assistant avec SMTP en 2026

Début 2025, je vous expliquais comment configurer des alertes email dans Home Assistant. À l'époque, la configuration ne se faisait pas directement depuis l'interface et il fallait passer par l'add-on File Editor pour modifier le fichier configuration.yaml, y renseigner son serveur SMTP puis redémarrer Home Assistant. Ça fonctionnait très bien... mais on est en 2026 : les choses ont changé !

Home Assistant a depuis fait évoluer son intégration SMTP. La configuration peut désormais être réalisée directement depuis l'interface et le système de notifications repose maintenant sur des entités notify. L'ancienne méthode et les actions du type notify.email sont progressivement abandonnées et disparaîtront totalement avec la version 2027.3. Si vous utilisez encore mon ancien tutoriel, ou si Home Assistant vient de vous afficher un avertissement concernant l'utilisation d'une action notify obsolète, il est donc temps de passer à la nouvelle méthode. Et vous allez voir que pour une nouvelle installation, c'est finalement plus simple qu'avant.

Les prérequis pour configurer les alertes email Home Assistant

Pour envoyer des emails, Home Assistant s'appuie sur son intégration SMTP et doit pouvoir se connecter à un serveur SMTP. Sur ce point, rien n'a changé : il s'agit du serveur utilisé pour l'envoi de courrier électronique. Vous pouvez utiliser le serveur SMTP de votre fournisseur de messagerie : Gmail, OVHcloud ou celui correspondant à votre propre domaine par exemple. Vous aurez généralement besoin des informations suivantes :

• l'adresse du serveur SMTP
• le port utilisé
• le type de sécurité utilisé (STARTTLS ou TLS notamment)
• votre nom d'utilisateur
• votre mot de passe ou mot de passe d'application
• l'adresse email qui apparaîtra comme expéditeur

Contrairement à l'ancienne méthode, vous n'avez plus besoin de File Editor ni de modifier le fichier configuration.yaml pour ajouter l'intégration SMTP.

Ajouter l'intégration SMTP dans Home Assistant

Connectez-vous à votre interface Home Assistant puis rendez-vous dans Paramètres → Appareils et services.

Cliquez ensuite sur Ajouter une intégration, recherchez SMTP puis sélectionnez l'intégration correspondante.

Home Assistant va alors vous demander les informations permettant de se connecter à votre serveur de courrier électronique : adresse du serveur, port, sécurité de la connexion, identifiant, mot de passe, adresse et nom de l'expéditeur. Dans mon cas, j'ai renseigné les infos relatives à mon compte mail chez OVH. Il suffit ici de renseigner les paramètres fournis par votre hébergeur ou votre fournisseur de messagerie.

Et avec Gmail ?

Si vous utilisez Gmail comme serveur d'envoi, la configuration classique utilise smtp.gmail.com, le port 587 et une connexion STARTTLS.

Attention cependant : Google demande l'utilisation d'un mot de passe d'application pour ce type de connexion. Votre mot de passe Gmail habituel ne doit donc pas être renseigné directement dans Home Assistant.

Ajouter un destinataire pour les notifications

C'est ici que le fonctionnement diffère assez fortement de l'ancienne intégration. Lors de la configuration, Home Assistant vous demande d'ajouter un premier destinataire. Il s'agit tout simplement de l'adresse sur laquelle vous souhaitez recevoir vos alertes. Vous êtes également invité à donner un nom à ce destinataire.

Mais cette adresse n'est pas simplement enregistrée comme un paramètre SMTP : Home Assistant va créer une entité de notification dédiée à ce destinataire.

Vous obtiendrez par exemple une entité ressemblant à :

notify.email_monadresse_exemple_com

C'est cette entité que nous allons ensuite utiliser dans nos automatisations.

Ajouter plusieurs destinataires

Vous pouvez parfaitement utiliser plusieurs adresses email. C'est pratique, par exemple, si certaines alertes doivent vous être envoyées tandis que d'autres doivent être adressées à un autre membre du foyer. Pour cela, rendez-vous dans Paramètres → Appareils et services, ouvrez votre intégration SMTP puis choisissez Ajouter un destinataire.

Renseignez la nouvelle adresse email et Home Assistant créera une nouvelle entité notify correspondante.

Vous pourrez ainsi choisir précisément le destinataire dans chacune de vos automatisations.

Créer des alertes email Home Assistant avec une automatisation

Maintenant que SMTP et notre destinataire sont configurés, on va pouvoir créer une première alerte email Home Assistant. Pour cet exemple, je vais prendre un cas concret très simple : l'envoi d'une notification par email lorsqu'une lumière est allumée. Rendez-vous dans Paramètres → Automatisations et scènes puis cliquer en bas à droite sur le bouton + Créer une automatisation.

Dans la fenêtre qui s'ouvre, choisissez l'option Créer une nouvelle automatisation. La première chose à faire est de définir un élément déclencheur. Cliquez donc sur Ajouter un déclencheur et recherchez votre dispositif. Pour mon exemple, je sélectionne Lumière du garage, puis le déclencheur La lumière s'est allumée. Home Assistant exécutera ainsi notre automatisation dès que cette lumière sera allumée.

Dans la partie Alors faire, cliquez sur Ajouter une action. Dans la partie gauche de la fenêtre, descendez dans la partie Services et dépliez email. Vous verrez alors les différents destinataires que vous avez créés. Sélectionnez le destinataire et dans la partie droite de la fenêtre optez pour l'option Envoyer un message de notification.

Renseignez ensuite le message et le titre de l'email.

En YAML, l'action ressemble par exemple à ceci :

actions:
  - action: notify.send_message
    metadata: {}
    target:
      entity_id: notify.email_steven_gmail_com
    data:
      message: La lumière de garage a été allumée
      title: Lumière Garage ON

Enregistrez votre automatisation et provoquez l'événement pour la tester. Si tout est correctement configuré, l'email devrait arriver quelques secondes plus tard dans la boite mail du destinataire.

Migrer une ancienne automatisation utilisant notify.email

Si vous utilisiez déjà les alertes email dans Home Assistant, alors c'est probablement cette partie qui va vous intéresser le plus. Les anciennes configurations utilisaient généralement une action ressemblant à celle-ci :

- action: notify.email
  data:
    target: adresse@example.com
    title: Fenêtre ouverte
    message: La fenêtre vient d'être ouverte.

Avec le nouveau système basé sur les entités de notification, elle devient :

- action: notify.send_message
  target:
    entity_id: notify.email_adresse_example_com
  data:
    title: Fenêtre ouverte
    message: La fenêtre vient d'être ouverte.

Il y a donc une différence importante : avec notify.send_message, le destinataire est représenté par une entité notify. On ne renseigne plus directement une adresse email quelconque dans le champ target de cette action.

Si vous avez besoin d'envoyer des notifications vers plusieurs adresses, commencez donc par créer les différents destinataires depuis l'intégration SMTP. Vous disposerez ensuite d'une entité notify pour chacun d'entre eux.

Retrouver l'identifiant de son entité notify

Si vous ne connaissez pas l'identifiant exact de votre nouvelle entité, rendez-vous dans Outils de développement → États et recherchez notify. Vous devriez retrouver l'entité correspondant à l'adresse configurée dans SMTP. Son identifiant sera nécessaire si vous souhaitez écrire ou modifier directement vos automatisations en YAML.

Plusieurs entités peuvent apparaître dans les résultats, notamment celles utilisées pour les notifications de l'application mobile. Repérez celle associée à votre service SMTP et à l'adresse email du destinataire.

notify.send_message ou smtp.send_message : quelle différence ?

Vous avez peut être remarqué tout à l'heure que lorsque nous avons sélectionné une action, nous avions en réalité deux choix :

• Envoyer un message de notification (notify.send_message)
• Envoyer un message via SMTP (smtp.send_message)

Pour une notification classique contenant simplement un titre et un message, notify.send_message est parfaitement adapté et permet de cibler directement l'entité correspondant au destinataire. La définition de l'action est alors très simple, sans prise de tête. Et c'est ce que nous avons utilisé dans ce tutoriel.

Mais l'intégration SMTP propose également l'action smtp.send_message pour les besoins plus avancés. Elle permet notamment d'exploiter les fonctionnalités propres à l'email comme le contenu HTML, les images intégrées ou les pièces jointes. On gardera ça pour la suite : car j'ai également un tutoriel consacré aux alertes mails avancées dans Home Assistant, qui mérite lui aussi une petite mise à jour avec cette nouvelle intégration. Affaire à suivre donc !

Et voilà ! Vous disposez maintenant d'une configuration SMTP à jour et vous pouvez commencer à utiliser les emails dans vos automatisations. De quoi être prévenu d'une porte laissée ouverte, d'une température anormale, d'un appareil qui s'allume ou de tout autre événement détecté par Home Assistant.