---
title: "Envoyer les courriels de votre appli sans clé de fournisseur : la doc de while.sh"
url: https://while.sh/fr/docs/briques/courriels/
updated: 2026-11-21
---

# Courriels

Votre appli envoie ses courriels, comme une invitation ou un mot de passe oublié, par le relais SMTP de while. Elle ne garde la clé d'aucun fournisseur.

> Vous, à votre IA : Envoie un courriel de bienvenue à chaque nouvel inscrit.

## Ce que reçoit votre appli

Votre appli reçoit ces variables d'environnement à chaque mise en ligne :

| Variable | Ce qu'elle contient |
|---|---|
| `SMTP_URL` | L'adresse du relais, identifiant et secret compris. Une bibliothèque SMTP, comme nodemailer, la prend telle quelle. |
| `SMTP_FROM` | L'expéditeur : noreply@ suivi de l'adresse de l'appli. |

## Quand vous en servir

Servez-vous-en pour les courriels que votre appli envoie elle-même à ses utilisateurs.

## Comment ça marche

La brique s'ouvre organisation par organisation. Pour l'avoir, demandez-la à votre agent, qui écrit à l'équipe while (`send_feedback`, `kind: block`) avec l'usage et le volume prévu. L'équipe while décide, et votre agent suit la demande dans `get_organization`. À l'ouverture, les admins de l'organisation reçoivent un courriel.

Une fois la brique ouverte, les applis de production de l'organisation reçoivent `SMTP_URL` et `SMTP_FROM` à leur mise en ligne suivante. Votre appli envoie en SMTP au relais de while, avec l'identifiant de `SMTP_URL`, et while fait partir le message.

## Ce qu'il faut savoir

Une prévisualisation ne reçoit ni `SMTP_URL` ni `SMTP_FROM`. L'expéditeur est une adresse sous le nom de l'appli, comme noreply@planning.while.cloud ; une adresse d'un autre domaine est refusée, domaine personnalisé compris. Une adresse de test ou d'exemple, comme example.com ou .test, est acceptée sans que rien ne parte.

Un message part à 50 destinataires au plus et pèse 10 Mo au plus. Par défaut, une appli écrit à 100 destinataires par heure et 500 par jour, et l'organisation à 1 000 par jour ; l'équipe while peut relever les plafonds d'une appli. Au-delà, le relais demande de réessayer plus tard.
