Ingénierie4 min de lecture
Simplification des statuts d’e-mail
Nous avons remplacé les anciens statuts d’e-mail par un ensemble plus clair et cohérent. Voici ce qui a changé et comment les nouveaux statuts correspondent aux anciens.
GParGeorge

Les statuts d’e-mail sont l’un des éléments les plus importants de l’API : ils vous indiquent précisément où en est un e-mail dans son cycle de vie. Au fil du temps, notre ensemble initial de statuts s’est développé de manière organique et est devenu source de confusion : quelle est la différence entre error et softfail ? Est-ce que held équivaut à pending ? Nous avons décidé de faire le ménage.
Les nouveaux statuts
Nous disposons désormais de 12 statuts clairs, chacun avec une signification et une couleur distinctes :
Statut | Couleur | Description |
|---|---|---|
accepted | 🟡 | Accepté pour livraison |
scheduled | 🟡 | Programmé pour livraison ultérieure |
delivered | 🟢 | Livré au serveur de messagerie du destinataire |
bounced | 🔴 | Échec définitif (hard bounce) |
attempted | 🟠 | Livraison tentée, mais échec temporaire |
failed | 🔴 | Échec de livraison dû à une erreur précise |
rejected | 🔴 | Accepté initialement, puis rejeté |
loaded | 🔵 | Contenu de l’e-mail chargé (suivi d’ouverture) |
clicked | 🟣 | Un lien dans l’e-mail a été cliqué |
suppressed | ⚪ | Le destinataire figure sur la liste des adresses bloquées |
received | 🟢 | E-mail entrant accepté |
complained | 🔴 | Une plainte pour spam a été enregistrée |
Ce qui a changé par rapport aux anciens statuts
Les anciens statuts sont désormais obsolètes. Voici leur correspondance avec les nouveaux :
Ancien statut (obsolète) | Nouveau statut |
|---|---|
|
|
|
|
| (supprimé) |
| (supprimé) |
|
|
|
|
|
|
|
|
| (supprimé) |
| (supprimé) |
Les statuts renommés sont plus descriptifs : loaded indique clairement que nous suivons le chargement du contenu de l’e-mail (pas nécessairement son ouverture par un humain), attempted est moins ambigu que softfail, et bounced est universellement compris.
Rétrocompatibilité
Tous les e-mails existants et leurs livraisons ont été migrés vers les nouveaux statuts. Vous ne verrez aucun ancien nom de statut dans les enregistrements d’e-mails ou de livraisons, quelle que soit leur date de création.
Les anciens noms de statuts ne peuvent plus apparaître que dans les événements et requêtes webhook déjà déclenchés, envoyés avant ce changement. Ces données historiques sont immuables et conserveront les valeurs de statut d’origine avec lesquelles elles ont été créées.
Si votre code filtre ou compare des valeurs de statut, mettez à jour vos intégrations pour utiliser les nouveaux noms.


