Files
formation-manager-itinova/EMAIL_SETUP.md

110 lines
3.8 KiB
Markdown

# Configuration de l'envoi d'emails
## État actuel
Par défaut, l'application **simule** l'envoi d'emails en créant des notifications pour le propriétaire du projet. Les emails ne sont pas réellement envoyés aux utilisateurs finaux.
## Configuration de l'envoi réel d'emails
Pour activer l'envoi réel d'emails, vous devez configurer un service d'envoi d'emails externe. L'application supporte **Resend**, un service moderne et simple d'utilisation.
### Étape 1 : Créer un compte Resend
1. Allez sur [https://resend.com](https://resend.com)
2. Créez un compte gratuit (100 emails/jour inclus)
3. Vérifiez votre adresse email
### Étape 2 : Obtenir une clé API
1. Dans le tableau de bord Resend, allez dans **API Keys**
2. Cliquez sur **Create API Key**
3. Donnez un nom à votre clé (ex: "Manager Itinova Production")
4. Copiez la clé API générée (elle commence par `re_`)
### Étape 3 : Configurer votre domaine (optionnel mais recommandé)
Pour envoyer des emails depuis votre propre domaine (ex: `noreply@itinova.org`) :
1. Dans Resend, allez dans **Domains**
2. Cliquez sur **Add Domain**
3. Entrez votre domaine (ex: `itinova.org`)
4. Suivez les instructions pour ajouter les enregistrements DNS
5. Attendez la vérification (quelques minutes à quelques heures)
**Note:** Sans domaine vérifié, les emails seront envoyés depuis `noreply@manusvm.computer`
### Étape 4 : Ajouter les secrets dans Manus
1. Ouvrez l'interface de gestion de votre projet Manus
2. Allez dans **Settings****Secrets**
3. Ajoutez les secrets suivants :
| Nom du secret | Valeur | Description |
|---------------|--------|-------------|
| `RESEND_API_KEY` | `re_xxxxx...` | Votre clé API Resend |
| `RESEND_FROM_EMAIL` | `noreply@itinova.org` | Adresse email d'envoi (doit être vérifiée dans Resend) |
4. Sauvegardez les modifications
5. Redémarrez l'application (elle détectera automatiquement la nouvelle configuration)
### Étape 5 : Tester l'envoi
1. Allez dans **Utilisateurs**
2. Cliquez sur le bouton de réinitialisation de mot de passe pour un utilisateur
3. Vérifiez que l'email a bien été reçu
## Vérification de la configuration
Vous pouvez vérifier si l'envoi d'emails réel est activé en consultant les logs du serveur :
- **Emails simulés** : `[Email] RESEND_API_KEY non configurée, email simulé`
- **Emails réels** : `[Email] Email envoyé via Resend: <id>`
## Alternatives à Resend
Si vous préférez utiliser un autre service d'envoi d'emails, vous pouvez modifier le fichier `server/_core/emailSender.ts` pour intégrer :
- **SendGrid** : Service populaire avec 100 emails/jour gratuits
- **Mailgun** : Service robuste avec 5000 emails/mois gratuits
- **AWS SES** : Service Amazon très économique pour gros volumes
- **Votre propre serveur SMTP** : Configuration personnalisée
## Limites et quotas
### Plan gratuit Resend
- 100 emails par jour
- 3000 emails par mois
- Support email uniquement
### Plans payants Resend
- À partir de 20$/mois pour 50 000 emails
- Support prioritaire
- Webhooks et analytics avancés
## Dépannage
### Les emails n'arrivent pas
1. Vérifiez que `RESEND_API_KEY` est correctement configurée
2. Vérifiez que `RESEND_FROM_EMAIL` utilise un domaine vérifié
3. Consultez les logs du serveur pour voir les erreurs
4. Vérifiez le dossier spam/courrier indésirable
5. Consultez le tableau de bord Resend pour voir l'état des envois
### Erreur "Domain not verified"
Vous devez vérifier votre domaine dans Resend en ajoutant les enregistrements DNS requis.
### Quota dépassé
Si vous dépassez le quota gratuit, vous devrez :
- Attendre le lendemain (quota journalier)
- Passer à un plan payant
- Utiliser un autre service d'envoi
## Support
Pour toute question sur la configuration de l'envoi d'emails, consultez :
- [Documentation Resend](https://resend.com/docs)
- [API Reference Resend](https://resend.com/docs/api-reference)