# E-mails

> Choisissez qui envoie les e-mails de votre application - e-mails de connexion Keycloak par réseau, e-mails d'invitation depuis votre propre compte Brevo.

Votre application envoie deux familles d'e-mails à ses utilisateurs, par deux canaux distincts. Les e-mails de **connexion** (mot de passe oublié, vérification d'adresse) partent de [Keycloak](/v1.0/glossaire#keycloak). Les e-mails d'**invitation** partent de Wakastart, par Brevo. Chacun se règle à son niveau et par [environnement](/v1.0/glossaire#environnement).

## Comment ça marche

```mermaid
flowchart LR
  subgraph Connexion["E-mails de connexion"]
    KC["Keycloak de l'environnement<br/>realm du réseau"] --> SMTP["Serveur SMTP<br/>du réseau pour cet environnement<br/>(sinon serveur par défaut)"]
  end
  subgraph Invitation["E-mails d'invitation"]
    INV["Invitation créée<br/>dans la console ou par l'API"] --> BR{"Compte Brevo de l'app<br/>activé pour l'environnement ?"}
    BR -- oui --> APP["Compte Brevo de l'application"]
    BR -- non --> WS["Compte Brevo de Wakastart"]
  end
  SMTP --> U([Utilisateur])
  APP --> U
  WS --> U
```

- Les **e-mails de connexion** dépendent du [réseau](/v1.0/glossaire#réseau) de l'utilisateur : chaque réseau a son serveur SMTP, réglé séparément pour dev, staging et prod. Leur apparence vient du type `email` du [thème de connexion](/v1.0/page-de-connexion).
- Les **e-mails d'invitation** dépendent de l'application : sans compte Brevo propre, ils partent du compte de Wakastart, sous le nom « WakaStart ». Avec un compte propre activé, ils partent de votre compte et de votre adresse.

## Commencer

::::cards{cols=3}
:::card{title="Expéditeurs et environnements" href="/v1.0/emails/expediteurs-et-environnements" icon="Layers"}
Qui envoie quoi, et avec quelle adresse.
:::
:::card{title="Configurer le compte Brevo" href="/v1.0/emails/configurer-le-compte-brevo" icon="Send"}
Envoyer les invitations depuis votre propre compte.
:::
:::card{title="Consulter le SMTP d'un réseau" href="/v1.0/emails/consulter-le-smtp-d-un-reseau" icon="Server"}
Vérifier quel serveur envoie les e-mails de connexion.
:::
::::

## Fonctionnalités

- Un compte Brevo par application et par environnement pour les invitations, avec test de la clé et de l'expéditeur sans envoyer d'e-mail.
- Des e-mails d'invitation en sept langues : français, anglais, espagnol, allemand, néerlandais, italien, portugais.
- Un serveur SMTP par réseau et par environnement pour les e-mails Keycloak.

## Produits liés

::::cards{cols=3}
:::card{title="Utilisateurs et équipes" href="/v1.0/utilisateurs" icon="Users"}
Créer et relancer les invitations.
:::
:::card{title="Page de connexion" href="/v1.0/page-de-connexion" icon="PanelsTopLeft"}
Habiller les e-mails Keycloak avec le type email de votre thème.
:::
:::card{title="Langues et traductions" href="/v1.0/langues-et-traductions" icon="Languages"}
Les langues de votre application.
:::
::::

## Ressources

- [Référence des e-mails](/v1.0/emails/reference) : champs, modèles d'invitation, statuts.
- [Résoudre les problèmes d'e-mails](/v1.0/emails/depannage).
