# 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.

2026-02-25 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

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 |
| --- | --- |
| `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.

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.

---

Source: https://emailit.com/fr/blog/simplification-des-statuts-emails/
