Aller au contenu

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.

GPar

Simplification des statuts d’e-mail

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.

Partager

Essayez ce que vous venez de lire.

3 000 e-⁠mails gratuits par mois. Sans carte bancaire.

3 000 e-⁠mails gratuits par mois · Sans carte bancaire