Configurer l'e-mail

Configuration et paramètres

Avant toute étape, lisez Avant de commencer et Principes de base du terminal. Ces instructions supposent que vous avez ouvert le monorepo supastack complet dans VS Code ; sa racine package.json marque la racine du référentiel. Dans les commandes pnpm, un package d'espace de travail est une application ou un dossier de code partagé ; dans le produit, un espace de travail est le conteneur de données et la limite de sécurité d'une équipe. corepack pnpm --filter ... sélectionne un package dans le monorepo tandis que les commandes sont exécutées à partir de sa racine. Si vous avez ouvert uniquement un dossier mobile ou de bureau synchronisé, il ne contient pas le backend Web, la configuration Docker ou les scripts racine : exécutez le backend à partir de ce monorepo ou d'un serveur hébergé accessible et utilisez les propres scripts du dossier de plateforme. Une variable d'environnement est un paramètre nommé stocké dans un fichier .env local ou dans votre tableau de bord d'hébergement ; redémarrez l'application concernée après l'avoir modifiée et conservez les secrets du serveur en dehors des valeurs NEXT_PUBLIC_ et EXPO_PUBLIC_.

1. Ouvrez apps/web/.env.local et définissez EMAIL_PROVIDER=local pour le développement ; EMAIL_FROM est l'étiquette d'expéditeur utilisée par les modèles.

2. Démarrez l'application Web à partir de la racine du référentiel avec corepack pnpm --filter @supastack/web dev et déclenchez une connexion ou un flux d'invitation avec une adresse de test. Attendu : l'application enregistre le résultat d'un e-mail local sans contacter un véritable fournisseur. Connectez Resend, SES ou un autre service uniquement après que son domaine d'expéditeur ait été vérifié et que les destinataires du test soient restreints.

EMAIL_PROVIDER=local maintient les envois déterministes en local. Pour un envoi de production, examinez l’adaptateur Resend ou SES et fournissez ses identifiants serveur. EMAIL_FROM doit correspondre à l’identité vérifiée auprès du fournisseur choisi.

• Configurer Amazon SES avec le SDK AWS ou IAM SMTP

EMAIL_PROVIDER=local
EMAIL_FROM=supastack <[email protected]>
# Production adapter configuration is listed in .env.example:
# RESEND_API_KEY=  POSTMARK_SERVER_TOKEN=  SENDGRID_API_KEY=  BREVO_API_KEY=
# MAILGUN_API_KEY=  MAILGUN_DOMAIN=  MAILGUN_REGION=us

Commandes à copier

Suivez les commentaires pour voir dans quel dossier une commande s'exécute. Si deux terminaux sont étiquetés, ouvrez deux fenêtres de terminal et laissez la première commande s'exécuter pendant que vous utilisez la seconde.

corepack pnpm --filter @supastack/web dev

Processus d’implémentation

Les messages d’authentification et de fin de tâche utilisent la frontière transactionnelle de l’e-mail. Les workflows de prospection appartiennent au produit consommateur et restent séparés. Ne transformez jamais ce parcours en système d’envoi massif sans examen préalable.

Enregistrez l’envoi séparément de la génération. Le résultat d’un modèle peut être disponible alors que son message de fin échoue. Pour reprendre, examinez l’état de livraison au lieu de générer le même résultat une seconde fois.

Vérification et dépannage

Si aucun e-mail local n'apparaît, vérifiez que EMAIL_PROVIDER est défini dans apps/web/.env.local et redémarrez Web. Si un véritable fournisseur rejette un message, confirmez que EMAIL_FROM correspond à un expéditeur vérifié et inspectez l'enregistrement de livraison du fournisseur. Une réponse générée par l'IA peut réussir même lorsque son e-mail de suivi échoue ; vérifiez la livraison avant de réexécuter le AI task.

Dans un environnement de test dédié, vérifiez les restrictions de destinataires, l’identité d’expéditeur et les erreurs du fournisseur. Un résultat de l’adaptateur local ne prouve pas qu’un vrai e-mail a été envoyé. Le parcours de test réel facultatif limite les destinataires avec REAL_SMOKE_EMAIL_ALLOWED_DOMAIN.