Simplification des statuts d'e-mail
Les statuts d’e-mail constituent 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 (rebond dur) |
| attempted | 🟠 | Tentative de livraison mais échec temporaire |
| failed | 🔴 | Échec de livraison dû à une erreur spécifique |
| 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 de suppression |
| 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épréciés. Voici comment ils correspondent aux nouveaux :
| Ancien statut (déprécié) | Nouveau statut |
|---|---|
pending | accepted ou scheduled |
sent | delivered |
held | (supprimé) |
hold_cancelled | (supprimé) |
softfail | attempted |
hardfail | bounced |
opened | loaded |
error | failed |
delayed | (supprimé) |
processed | (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.
Le seul endroit où les anciens noms de statuts peuvent encore apparaître concerne les événements et requêtes webhook déjà déclenchés qui ont été envoyés avant cette modification. Ces données historiques sont immuables et conserveront les valeurs de statut d’origine avec lesquelles elles ont été créées.
Si vous filtrez ou effectuez des correspondances sur les valeurs de statut dans votre code, mettez à jour vos intégrations pour utiliser les nouveaux noms.
Blog
Les dernières actualités et mises à jour, directement depuis Emailit.
Restez informé des derniers articles du Blog Emailit.
