Configuration SMTP et e-mails

Assurez-vous d'avoir un .env fichier créé sous le docker/ dossier. Vous pouvez soit copier .env.example soit exécuter hexabot init pour créer ce fichier. Le .env fichier contient des variables d'environnement que nous utilisons pour configurer l'instance Hexabot.

Environnement de développement

Vous avez deux options pour gérer la fonctionnalité d'email pendant le développement :

1. Sans SMTP : Vous pouvez exécuter l'application sans utiliser SMTP en réglant la variable d'environnement EMAIL_SMTP_ENABLED=false. Il suffit d'exécuter hexabot start et d'inviter un nouvel utilisateur. L'application se comportera comme si elle envoyait des e-mails, mais rien ne se passera en arrière-plan.

2. Utilisation de smtp4dev pour les tests : Nous utilisons smtp4dev pour les tests d'e-mails dans l'environnement de développement. Pour utiliser ce service, définissez la EMAIL_SMTP_ENABLED vers true dans le .env dans le fichier et redémarrez l'application en utilisant la commande hexabot start --services smtp4dev. Ensuite, invitez un nouvel utilisateur ou réinitialisez un mot de passe et vérifiez si les e-mails sont reçus dans l'interface smtp4dev à http://localhost:9002/. Cela s'applique également à d'autres scénarios comme l'e-mail de confirmation après l'inscription et l'e-mail de réinitialisation de mot de passe.

Configuration SMTP (Dev local)

Pour le développement local avec smtp4dev, configurez les variables d'environnement suivantes :

APP_SMTP_4_DEV_PORT=9002
EMAIL_SMTP_ENABLED=true
EMAIL_SMTP_HOST=smtp4dev
EMAIL_SMTP_PORT=25
EMAIL_SMTP_SECURE=false
EMAIL_SMTP_USER=dev_only
EMAIL_SMTP_PASS=dev_only
EMAIL_SMTP_FROM=[email protected]

Environnement de production

En production, utilisez un service SMTP tiers en configurant les variables d'environnement avant d'exécuter hexabot start, voici un exemple :

EMAIL_SMTP_ENABLED=true
EMAIL_SMTP_HOST=sandbox.smtp.mailtrap.io
EMAIL_SMTP_PORT=2525
EMAIL_SMTP_SECURE=false  # Définir sur true si vous utilisez un serveur SMTP sécurisé qui utilise SSL/TLS
EMAIL_SMTP_USER=***************
EMAIL_SMTP_PASS=***************
[email protected]

Personnalisation des modèles d'e-mail

Les modèles d'e-mail se trouvent dans le api/src/templates dossier. Ces modèles sont écrits en syntaxe MJML (vous pouvez en savoir plus sur MJML ici).

Traductions

Les chaînes d'e-mail sont traduites à l'aide du système i18n. Vous pouvez trouver les fichiers de traduction dans le api/src/config/i18n dossier.