# Expéditeurs et environnements

> Quel compte envoie les e-mails de connexion et d'invitation, avec quelle adresse d'expéditeur, et pourquoi chaque environnement a ses propres réglages.

Un e-mail arrive dans une boîte de réception avec une adresse d'expéditeur et un nom. Ces deux informations, et le compte qui l'envoie, dépendent du type d'e-mail et de l'environnement.

## Deux canaux

| | E-mails de connexion | E-mails d'invitation |
|---|---|---|
| Exemples | mot de passe oublié, vérification d'adresse, actions demandées par Keycloak | invitation à rejoindre l'application, relance, « invitation acceptée » envoyée à la personne qui a invité |
| Émetteur | Keycloak, realm du réseau de l'utilisateur | Wakastart, par l'API de Brevo |
| Réglage | par **réseau** et par environnement | par **application** et par environnement |
| Où | fiche du réseau, onglet **Email** | paramétrage de l'application, onglet **Invitations**, carte **Compte d'envoi Brevo** |
| Apparence | type `email` du thème de connexion | modèle Wakastart, logo de l'application |

## Un réglage par environnement

Chaque environnement de votre application, dev, staging et prod, a sa propre instance Keycloak et ses propres envois. Un réglage ne vaut donc que pour l'environnement choisi : configurer le compte Brevo de prod ne change rien en dev. Cela permet de tester un nouveau compte en dev sans risquer d'envoyer de vrais e-mails depuis la mauvaise adresse en production.

## Qui envoie les invitations

Pour chaque invitation, Wakastart choisit l'expéditeur dans cet ordre :

1. **Compte Brevo de l'application activé pour l'environnement** : l'e-mail part de ce compte, avec l'adresse et le nom configurés. Une adresse demandée dans la requête d'invitation est ignorée. L'adresse de réponse est celle de la configuration, sinon celle de la personne qui invite.
2. **Sinon**, l'e-mail part du compte Brevo de Wakastart, avec l'adresse demandée dans la requête si elle est fournie, sinon l'adresse de la plateforme, sous le nom « WakaStart ».

:::important
Quand le compte de l'application est activé, Wakastart ne se replie jamais sur son propre compte. Si votre clé Brevo est refusée, l'invitation n'est pas envoyée. Ce choix évite d'envoyer vos e-mails depuis une adresse qui n'est pas la vôtre sans que personne ne s'en aperçoive.
:::

## Les modèles d'invitation

Les e-mails d'invitation utilisent un modèle fourni par Wakastart, disponible en sept langues : `fr`, `en`, `es`, `de`, `nl`, `it`, `pt`. La langue est celle demandée à la création de l'invitation, le français par défaut. Le modèle reprend le nom et le logo de l'application, le nom de la personne qui invite et, si elle en a saisi un, son message personnalisé. Le lien d'invitation expire par défaut au bout de 10 jours.

Quand l'option **Notification à l'inviteur** est cochée dans l'onglet **Invitations**, la personne qui a invité reçoit aussi un e-mail lorsque l'invitation est acceptée.

## Qui envoie les e-mails de connexion

Chaque réseau utilise, pour chaque environnement, un serveur SMTP enregistré par Wakastart. Sans réglage propre au réseau, le serveur par défaut de la plateforme s'applique. La console affiche l'état de ce réglage dans l'onglet **Email** du réseau.

## Pour aller plus loin

- [Configurer le compte Brevo de l'application](/v1.0/emails/configurer-le-compte-brevo)
- [Consulter le serveur SMTP d'un réseau](/v1.0/emails/consulter-le-smtp-d-un-reseau)
- [Référence des e-mails](/v1.0/emails/reference)
