Aller au contenu

Statuts des messages

Statut Signification Crédit
queued Accepté, en attente de l’expéditeur réservé
sending L’expéditeur effectue le rendu et communique avec le fournisseur réservé
sent Le fournisseur l’a accepté consommé
delivered Le fournisseur a confirmé la remise au serveur du destinataire (nécessite des webhooks) consommé
bounced Le serveur du destinataire l’a refusé ; les rebonds définitifs ajoutent l’adresse à la liste de suppression consommé
complained Le destinataire l’a signalé comme spam ; l’adresse est ajoutée à la liste de suppression consommé
failed Erreur permanente, ou erreurs temporaires ayant épuisé toutes les nouvelles tentatives remboursé (sauf lorsqu’un serveur SMTP personnalisé a peut-être déjà reçu le message, ou lorsqu’une part inhabituellement élevée des envois de l’organisation échoue)
held En attente de crédits dans la file d’attente des e-mails retenus pas encore
held_service_error En attente de la réparation d’un service défaillant remboursé, réservé à nouveau à la libération
discarded Retiré de la file d’attente des e-mails retenus – la durée de rétention a expiré ou quelqu’un l’a supprimé manuellement aucun

L’API renvoie queued ou held lors de l’envoi. Vous voyez tous les autres statuts via getStatus() / GET /v1/messages/:id, l’Historique ou history() du SDK Node.

queued → sending → sent → delivered
queued → sending → sent → bounced
queued → sending → (nouvelle tentative …) → sent
queued → sending → (bascule vers le service de secours) → sent
queued → sending → failed
held → (crédits ajoutés) → queued → sending → sent
held → (durée de rétention écoulée) → discarded
queued → sending → (erreur d’authentification, pas de secours) → held_service_error → (service réparé) → queued → …

Chaque message possède une chronologie d’événements horodatés. Le détail d’un message dans l’Historique du tableau de bord les affiche avec ces libellés :

Événement Libellé dans l’Historique Signification
held Retenu Placé dans la file d’attente des e-mails retenus
released Libéré Libéré de la file d’attente des e-mails retenus
queued En file d’attente En attente de l’expéditeur
sending Envoi en cours Transmis au fournisseur
sent Envoyé Le fournisseur l’a accepté
failover Bascule vers le service de secours Le service principal a échoué, le service de secours a été utilisé
retry Nouvelle tentative planifiée Une erreur temporaire, une autre tentative suit
auto_reply Réponse automatique créée Une réponse automatique a été créée pour ce message
delivered Remis Remise confirmée par webhook
bounced Rebond Rebond définitif (statut bounced) ou rebond temporaire (événement uniquement, le fournisseur continue de réessayer)
complained Signalé comme spam Le destinataire s’est plaint
opened / clicked Ouvert / Lien cliqué Suivi des ouvertures et des clics par le fournisseur
failed Échec Erreur permanente
refunded Crédit remboursé Le crédit réservé est retourné à son attribution
discarded Supprimé Retiré de la file d’attente des e-mails retenus

opened et clicked sont des événements, pas des statuts – un message remis qui a été ouvert reste delivered. Le suivi des ouvertures dépend du fournisseur et du chargement des images par le destinataire : considérez-le comme une estimation.

Les messages et leur contenu rendu sont conservés pendant la durée d’historique du forfait sous lequel ils ont été envoyés (de 7 à 180 jours, voir Forfaits), puis supprimés.