E-mail via SMTP

sol2flow envoie des e-mails pour les invitations, les réinitialisations de mot de passe, les confirmations d’adresse e-mail, les approbations d’inscription, les alertes de sécurité (par exemple « une clé d’accès a été ajoutée ») et les récapitulatifs de notifications. Chaque message comporte une partie HTML et une partie texte brut, et il est rédigé dans la langue du destinataire.

remarque

Exiger la confirmation de l’e-mail est activé par défaut : les nouveaux comptes, et les personnes qui modifient leur adresse e-mail, confirment l’adresse via un lien envoyé par e-mail. Si votre instance ne peut pas envoyer d’e-mails, désactivez-le dans Admin → Authentification, sinon personne ne pourra terminer son inscription. Voir Confirmation de l’e-mail.

Configurer SMTP

1. Obtenez des identifiants SMTP auprès de votre fournisseur de messagerie (ou de votre propre serveur de messagerie). Une adresse d’expéditeur dédiée comme [email protected] est idéale.

2. Ajoutez à .env :

   MAIL_DRIVER=smtp
   MAIL_FROM="sol2flow <[email protected]>"
   SMTP_HOST=smtp.example.com
   SMTP_PORT=587
   SMTP_USER=[email protected]
   SMTP_PASSWORD=…
   SMTP_SECURE=false

3. Appliquez la configuration : docker compose up -d.

4. Testez-la : sur la page de connexion, choisissez Mot de passe oublié ? pour votre propre compte et vérifiez que l’e-mail arrive.

Port	SMTP_SECURE	Chiffrement
587	false	STARTTLS (activé après la connexion) : le choix habituel
465	true	TLS dès le premier octet
25	false	de serveur à serveur ; souvent bloqué par les hébergeurs

Délivrabilité

• Envoyez depuis un domaine que vous contrôlez et publiez pour celui-ci des enregistrements SPF, DKIM et DMARC comme l’indique votre fournisseur de messagerie. Sans eux, les invitations finissent souvent en spam.
• MAIL_FROM doit être une adresse que votre compte SMTP est autorisé à utiliser comme expéditeur.
• Les liens dans les e-mails utilisent APP_URL : vérifiez qu’il s’agit bien de l’adresse HTTPS publique.

Envoi et nouvelles tentatives

Les e-mails sont mis en file d’attente et envoyés en arrière-plan, avec de nouvelles tentatives quand le serveur SMTP est indisponible. Aucune action d’un utilisateur n’attend le serveur de messagerie, et un e-mail en échec n’annule jamais la modification qui l’a déclenché. Les échecs sont journalisés (voir Dépannage).

Sans SMTP

Avec MAIL_DRIVER=log (la valeur par défaut), les messages ne sont pas envoyés : leur objet et leur texte, liens compris, sont écrits dans le journal de l’application (docker compose logs app). Cela suffit pour un premier test, mais personne ne peut alors recevoir d’invitation ni réinitialiser son mot de passe.

E-mails de notification

En plus des e-mails toujours envoyés (invitations, réinitialisations de mot de passe, alertes de sécurité), chacun reçoit des e-mails récapitulatifs sur les modifications de ses tâches. L’interrupteur et la planification pour toute l’instance se trouvent dans Administration → Général ; chaque personne peut s’en désabonner dans ses propres paramètres. Voir Notifications.