Aller au contenu principal

Intégration SMTP pour Gladys Assistant

Intégration SMTP pour Gladys Assistant

Envoyez des emails depuis Gladys via votre propre serveur SMTP.

Voir sur GitHubToutes les intégrations externes

Cette intégration permet à Gladys d'envoyer des emails via votre propre serveur SMTP — votre fournisseur de messagerie (Gmail, Outlook, iCloud, Fastmail…), un service transactionnel (Brevo, Mailgun, Postmark, Amazon SES…) ou un serveur mail installé sur votre réseau local.

Une fois installée, « email » devient un canal de notification : vos scénarios peuvent vous envoyer un message, et Gladys peut vous joindre même quand vous n'êtes pas devant l'application.

Comment ça marche​

Il y a deux niveaux de réglages, et ce ne sont pas les mêmes :

  • Le serveur SMTP (bloc Configuration) — commun à toute la maison, renseigné une seule fois par l'administrateur. C'est le compte que Gladys utilise pour envoyer.
  • Votre adresse email (bloc Mon compte) — chaque utilisateur de l'instance Gladys renseigne sa propre adresse et y reçoit ses propres notifications. Un utilisateur qui laisse le champ vide est simplement ignoré : Gladys ne lui envoie jamais d'email.

Configurer le serveur SMTP​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Renseignez les réglages de votre fournisseur :
    • Serveur SMTP : le nom d'hôte, par exemple smtp.gmail.com.
    • Port et Chiffrement : 587 avec STARTTLS chez la plupart des fournisseurs, 465 avec TLS / SSL chez les autres. N'utilisez 25 avec Aucun que pour un relais sur votre propre réseau.
    • Nom d'utilisateur et Mot de passe : les identifiants du compte expéditeur. Laissez les deux vides pour un relais local acceptant les envois anonymes.
    • Adresse d'expédition : l'adresse depuis laquelle partent les emails. La plupart des fournisseurs exigent qu'elle corresponde au compte authentifié, sinon ils rejettent le message.
    • Nom de l'expéditeur : ce que voit le destinataire dans sa boîte.
    • Préfixe du sujet : ajouté devant chaque sujet, lui-même construit à partir de la première ligne du message — laissez vide si vous n'en voulez pas.
  3. Enregistrez, puis cliquez sur Tester la connexion SMTP. Le bouton ouvre une session et s'authentifie sans rien envoyer : en cas d'échec, le message affiché en dessous indique ce que le serveur a refusé.
  4. Cliquez sur Envoyer un email de test et vérifiez qu'il arrive bien — y compris dans les spams, ce qu'aucun test de connexion ne peut faire à votre place.

Réglages des fournisseurs courants​

FournisseurServeurPortChiffrement
Gmailsmtp.gmail.com587STARTTLS
Outlook / Microsoftsmtp-mail.outlook.com587STARTTLS
iCloudsmtp.mail.me.com587STARTTLS
Fastmailsmtp.fastmail.com465TLS / SSL
Brevosmtp-relay.brevo.com587STARTTLS
Mailgunsmtp.mailgun.org587STARTTLS
Amazon SESemail-smtp.<region>.amazonaws.com587STARTTLS

Gmail, Outlook et iCloud refusent le mot de passe de votre compte. Ils imposent un mot de passe d'application : activez la double authentification sur le compte, générez un mot de passe dédié à Gladys, et collez celui-ci dans le champ Mot de passe. Le révoquer plus tard coupe Gladys uniquement, pas votre compte.

Recevoir les notifications​

  1. Toujours dans l'onglet Configuration, repérez le bloc Mon compte.
  2. Saisissez votre adresse email et enregistrez.
  3. Chaque utilisateur de Gladys fait de même, avec sa propre adresse.

À quoi ressemble un email​

Le message envoyé par Gladys devient le corps de l'email. Son sujet est construit à partir de la première ligne du message (précédée de votre préfixe), pour qu'une liste de boîte de réception reste lisible sans rien ouvrir.

Quand le message contient une image — une capture de caméra par exemple — elle est jointe à l'email et affichée directement dans le corps du message.

Dépannage​

  • « authentication refused by the server » — nom d'utilisateur ou mot de passe incorrect. Sur Gmail, Outlook et iCloud, c'est presque toujours le mot de passe du compte utilisé à la place d'un mot de passe d'application.
  • « cannot reach the server » — nom d'hôte ou port incorrect, ou pare-feu bloquant le SMTP sortant. Certains fournisseurs d'accès bloquent le port 25 sur les lignes résidentielles : utilisez 587 ou 465.
  • « the TLS handshake failed » — le mode de chiffrement ne correspond pas au port. Le port 465 exige TLS / SSL, le port 587 exige STARTTLS.
  • « the server refused the sender or the recipient address » — l'adresse d'expédition n'est pas celle du compte authentifié, ou l'adresse du destinataire est invalide.
  • Un serveur mail local avec un certificat auto-signé — désactivez Vérifier le certificat TLS. Laissez-le activé dans tous les autres cas.
  • Les emails partent en spam — ajoutez l'adresse d'expédition à vos contacts, ou utilisez un domaine avec des enregistrements SPF/DKIM si vous en possédez un.

L'intégration journalise tout ce qu'elle fait : ouvrez les logs de l'intégration depuis l'interface de Gladys (ou docker logs sur l'hôte), avec LOG_LEVEL=debug pour le détail complet du dialogue SMTP.

Paramètres de configuration​

Voici les paramètres demandés par SMTP dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Votre serveur SMTPsectionNonGladys envoie ses notifications par email via le serveur SMTP configuré ici. N'importe quel fournisseur convient : votre fournisseur de messagerie, un service transactionnel, ou un serveur mail de votre réseau local. Chaque utilisateur renseigne ensuite sa propre adresse email dans le bloc « Mon compte » ci-dessous.
Serveur SMTPstringOuiNom d'hôte ou adresse IP du serveur SMTP, par exemple smtp.gmail.com.
PortnumberOui587 pour STARTTLS (le plus courant), 465 pour TLS implicite, 25 pour un relais local.
ChiffrementselectOuiComment la connexion est sécurisée. Choisissez STARTTLS sur le port 587, TLS sur le port 465.
Nom d'utilisateurstringNonCompte SMTP utilisé pour l'authentification. Laissez vide pour un relais acceptant les envois anonymes.
Mot de passesecretNonMot de passe SMTP. Avec Gmail, Outlook ou iCloud, générez un mot de passe d'application dédié plutôt que celui de votre compte.
Adresse d'expéditionstringOuiAdresse depuis laquelle les emails sont envoyés. La plupart des fournisseurs exigent qu'elle corresponde au compte authentifié.
Nom de l'expéditeurstringNonNom affiché dans la boîte de réception du destinataire.
Préfixe du sujetstringNonAjouté devant chaque sujet, construit à partir de la première ligne du message. Laissez vide pour ne pas en mettre.
Vérifier le certificat TLSbooleanNonGardez-le activé. Ne le désactivez que pour un serveur mail local utilisant un certificat auto-signé.

Comment installer SMTP dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : SMTP apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/gladysassistant/gladys-smtp:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/GladysAssistant/gladys-smtp.

SMTP nécessite Gladys >=4.62.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

SMTP est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par GladysAssistant, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le