Courriels
Cette page dit ce que Bastide envoie aujourd'hui comme courriels pour votre projet, comment ces envois sont tenus (réessais, plafonds, rebonds), et ce qui n'existe pas encore : l'envoi de vos propres courriels transactionnels, le domaine d'envoi à vous, et les quotas mensuels par palier.
Ce qui existe aujourd'hui
La plateforme envoie, pour votre projet, les courriels d'authentification de vos utilisateurs :
| Genre | Quand |
|---|---|
| Confirmation d'adresse | À l'inscription. |
| Inscription sur une adresse connue | Quelqu'un tente de s'inscrire avec une adresse déjà confirmée : la personne est prévenue, l'appelant n'apprend rien. |
| Réinitialisation du mot de passe | resetPasswordForEmail. |
| Changement d'adresse, ancienne et nouvelle | Les deux confirmations d'un changement d'adresse. |
| Connexion sans mot de passe | Le lien magique et le code à 6 chiffres, dans le même message. |
Le parcours et les liens sont décrits dans Authentification. Les gabarits sont ceux de la plateforme, en français, avec le nom de votre projet.
Ce qui n'existe pas encore
- L'envoi de vos propres courriels (facture, notification, bulletin) par Bastide : aucune API, aucun outil et aucun relais SMTP n'est ouvert à votre application. Employez votre propre fournisseur depuis votre code ; la sortie réseau de votre projet doit alors le permettre (voir Pare-feu).
- Un domaine d'envoi à vous. Les courriels partent du relais et de l'adresse d'expédition de la plateforme ; vous ne réglez ni l'expéditeur, ni le domaine, ni ses enregistrements SPF ou DKIM.
- Les gabarits personnalisés par projet.
- Les quotas mensuels par palier. La grille annonce 1 000, 10 000, 50 000 et 200 000 courriels transactionnels par mois de Découverte à Souverain ; ces quotas ne sont pas encore appliqués, et rien n'est facturé au-delà. Seul le plafond horaire ci-dessous s'applique.
Comment les envois sont tenus
Les réessais
Un courriel est déposé dans une file, puis remis au relais. Un échec temporaire se réessaie selon un calendrier fixe : huit tentatives, la dernière 24 heures après la première.
| Après la tentative | Attente avant la suivante |
|---|---|
| 1 | 1 min |
| 2 | 4 min |
| 3 | 12 min |
| 4 | 36 min |
| 5 | 107 min |
| 6 | 320 min |
| 7 | 960 min |
Après la huitième, le courriel est abandonné. Un courriel encore en attente au bout de 48 heures est abandonné sans partir : un lien d'authentification si vieux n'ouvrirait plus rien. Un envoi peut, rarement, arriver deux fois ; le lien ne sert qu'une fois.
Les plafonds
- Par projet : 100 courriels par heure au plus, par le relais commun. Au-delà, le courriel est inscrit au journal et ne part pas ; votre application n'en est pas avertie, parce qu'un parcours d'authentification ne dit jamais si un message est parti.
- Par adresse : 4 courriels par heure par défaut, réglable de 1 à 40 (voir Authentification). Au-delà, l'appel reçoit 429,
debit_depasse.
Les rebonds et les plaintes
Un rebond dur ou une plainte suspendent l'adresse pour votre projet : tout envoi suivant à cette adresse est clos sans partir, motif adresse_suspendue. La suspension tombe d'elle-même 90 jours après le dernier rebond. Une panne du relais n'est jamais comptée comme un rebond.
Ce que la plateforme garde
Le journal d'envoi est gardé 30 jours : genre, état, tentatives, réponse du relais (tronquée à 512 octets, adresse retirée), rebonds et plaintes revenus après la remise. Ce qu'un courriel porte (l'adresse, le jeton, le code) est scellé dès le dépôt et effacé dès que l'envoi est clos, remis ou non. La liste de suppression ne garde qu'une empreinte de l'adresse.
Lire le journal d'envoi
- Console : l'écran Authentification, carte « Courriels d'authentification ».
- Agent :
auth_email_list(rangdeveloper, portéedb:read), avec les filtresstate(pending,delivered,rejected,dead) etwithReturns(seulement les courriels revenus après la remise). - Ligne de commande :
bastide auth_email list --project-id <projet> --state dead. - API :
GET /v1/projects/{projectId}/auth-emails.
{
"projectId": "prj_01JQ8ZK4M7NP2RSTVWXYZ34567",
"state": "rejected",
"limit": 25
}Erreurs fréquentes
- Un utilisateur ne reçoit rien : cherchez son courriel au journal et lisez son motif.
adresse_suspendue: l'adresse a rebondi ; elle se libère 90 jours après le dernier rebond.sans_adresse_de_site: réglez l'adresse du site du projet. - Beaucoup d'inscriptions sans courriel : le plafond de 100 courriels par heure du projet est peut-être atteint, par exemple par des inscriptions automatisées ; abaissez les inscriptions par heure et par adresse IP.
- **429
debit_depasse** sur une demande de lien : la limite par adresse est atteinte.
Voir aussi
- Authentification, Pare-feu, Notifications, Limites par palier
- Référence : auth_email.list