Rebonds

Lorsqu'un e-mail ne peut pas être remis, le serveur destinataire renvoie un rebond. MailLand classifie les rebonds, supprime automatiquement les adresses qui n'accepteront jamais de courrier et effectue de nouvelles tentatives pour les échecs transitoires.

Types de rebondsCopier le lien de la section

Catégories de rebondsCopier le lien de la section

L'API de répartition des rebonds (GET /v1/deliverability/bounce-breakdown) regroupe chaque rebond selon la classification que l'agent de transfert de courrier (MTA) lui-même attribue au rejet SMTP, puis fait correspondre cette classification à permanent, temporaire ou bloqué. Le tableau ci-dessous est le vocabulaire de production complet et figé : tout ce que l'hôte émet et qui ne figure pas dans ce tableau est compté comme inconnu plutôt que deviné :

Deux points de terminaison traités plus loin sur cette page rapportent les rebonds dans un vocabulaire qui leur est propre. /v1/transactional/bounces/statistics compte hardBounces et softBounces à partir de la même décision que celle qui supprime (ou non) l'adresse : un rebond bloqué n'est donc jamais compté comme permanent ou temporaire ; son byCategory regroupe la classification de l'hôte ci-dessus en un ensemble plus grossier (invalid_recipient, bad_mailbox, bad_domain, mailbox_full, content_rejected, policy_reason, general_bounce). /v1/transactional/bounces/recent renvoie comme bounceCategory la classification de l'hôte elle-même.

Traitement automatiqueCopier le lien de la section

Rebonds permanentsCopier le lien de la section

1. L'adresse e-mail du destinataire est immédiatement ajoutée à la liste de suppression globale
2. Tous les futurs e-mails (transactionnels et marketing) vers cette adresse sont bloqués
3. Un événement webhook message.bounced est déclenché avec bounce_type: "hard" (aucun événement suppression.added distinct n'est émis)

Rebonds temporairesCopier le lien de la section

1. Le statut du message passe à Bounced
2. L'adresse est supprimée pour les e-mails marketing pendant 30 jours (les e-mails transactionnels continuent d'être remis) : dès le premier rebond temporaire, pas après plusieurs tentatives. Exception : le premier rebond MessageExpired d'une adresse, ou son premier rebond pour message trop volumineux (QuotaIssues avec le code étendu 5.3.4 ou 5.2.3), ne supprime rien ; un autre dans les 30 jours supprime comme d'habitude.
3. Un événement webhook message.bounced est déclenché avec bounce_type: "soft". (Les échecs transitoires sont réessayés par le MTA lui-même avant qu'un rebond ne soit signalé à MailLand.)
4. Après 30 jours, la suppression expire automatiquement

Rebonds bloquésCopier le lien de la section

1. Le statut du message passe à Bounced (Failed pour un AdminBounce), mais l'adresse du destinataire n'est pas ajoutée à une liste de suppression : un rebond bloqué est une déclaration sur notre envoi, pas sur la boîte aux lettres du destinataire
2. Un événement webhook message.bounced est déclenché avec bounce_type: "blocked" (pour un AdminBounce, un événement message.failed avec reason: "admin_bounce" à la place)
3. Un taux soutenu de rebonds bloqués déclenche une alerte interne pour révision manuelle ; il n'y a pas de pause automatique de l'envoi

Statistiques de rebondsCopier le lien de la section

Obtenez des statistiques agrégées de rebonds pour une période :

GET https://api.mail.land/v1/transactional/bounces/statistics

Authentifiez-vous avec Authorization: Bearer <token> ou X-API-Key: <api key>.

curl https://api.mail.land/v1/transactional/bounces/statistics \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "totalBounces": 1125,
  "hardBounces": 450,
  "softBounces": 385,
  "generalBounces": 290,
  "byCategory": {
    "invalid_recipient": 380,
    "mailbox_full": 345,
    "content_rejected": 185,
    "policy_reason": 95,
    "bad_domain": 70,
    "general_bounce": 50
  }
}

Rebonds récentsCopier le lien de la section

Obtenez les messages ayant rebondi le plus récemment :

GET https://api.mail.land/v1/transactional/bounces/recent?limit=50

curl "https://api.mail.land/v1/transactional/bounces/recent?limit=50" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "messageId": "t_a1b2c3d4e5f6",
    "recipientEmail": "[email protected]",
    "subject": "Your order has shipped",
    "bounceCategory": "InvalidRecipient",
    "bounceReason": "550 5.1.1 The email account does not exist",
    "bouncedAt": "2026-02-17T12:34:56Z",
    "retryCount": 0
  },
  {
    "messageId": "t_d4e5f6a1b2c3",
    "recipientEmail": "[email protected]",
    "subject": "Invoice #1234",
    "bounceCategory": "QuotaIssues",
    "bounceReason": "552 5.2.2 Mailbox full",
    "bouncedAt": "2026-02-17T11:00:00Z",
    "retryCount": 2
  }
]

Les résultats sont triés par bouncedAt décroissant et limités aux 90 derniers jours. bouncedAt correspond à l'heure de création du message, pas à un horodatage de rebond suivi séparément.

Réessayer un message en rebondCopier le lien de la section

Réessayez manuellement la remise d'un message en rebond :

POST https://api.mail.land/v1/transactional/bounces/{messageId}/retry

curl -X POST https://api.mail.land/v1/transactional/bounces/t_a1b2c3d4e5f6/retry \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Le réessai renvoie le contenu original via le système d'outbox de MailLand. Le suivi des ouvertures et des clics est DÉSACTIVÉ sur les copies réessayées : le choix de suivi de l'envoi original ne peut pas être récupéré à partir de l'enregistrement du message.

Seuils du taux de rebondCopier le lien de la section

Les seuils sont des valeurs par défaut de l'offre, évaluées uniquement une fois que la taille d'échantillon minimale d'envois a été atteinte dans la fenêtre d'évaluation :

L'envoi est mis en pause (429 de l'API) lorsque le seuil de pause est atteint ; cela abaisse également votre score expéditeur.

Blocages de délivrabilitéCopier le lien de la section

Un dépassement du seuil de pause place également un blocage de délivrabilité durable sur l'espace de travail, distinct de la pause 429 transitoire ci-dessus. Tant que le blocage est actif, tout envoi, transactionnel comme marketing, est refusé : 403 ACTION_REQUIRED depuis l'API, un 451 4.7.0 temporaire via le relais SMTP, afin que votre serveur de messagerie garde le message en file d'attente et réessaie.

• Le blocage est placé une fois par épisode de dépassement, pas à chaque envoi.
• Il persiste jusqu'à ce que le support MailLand l'examine et le lève ; un taux de rebond ou de plainte qui se rétablit ne le lève pas automatiquement, il n'existe aucune levée automatique.
• Les propriétaires et administrateurs de l'espace de travail reçoivent un e-mail dès que le blocage est placé.

Meilleures pratiquesCopier le lien de la section

• Nettoyez vos listes : validez les adresses e-mail avant d'envoyer avec la Validation d'e-mail. Supprimez les adresses qui rebondissent systématiquement.
• Surveillez les catégories de rebonds : une hausse soudaine des rebonds content_rejected peut indiquer un problème de contenu, et non de qualité de liste.
• Ne réessayez pas les rebonds permanents : les rebonds permanents sont définitifs. Réessayer gaspille le quota et nuit à la réputation.
• Observez les modèles de rebonds temporaires : des rebonds mailbox_full répétés provenant du même domaine peuvent indiquer un problème au niveau du fournisseur.
• Utilisez le tableau de bord de délivrabilité : suivez les taux de rebond par fournisseur pour détecter rapidement les problèmes spécifiques à un domaine.

Prochaines étapesCopier le lien de la section

• Suppressions : gérer la liste de suppression
• Vue d'ensemble de la délivrabilité : surveiller le score expéditeur et les tendances
• Événements Webhook : recevoir les événements message.bounced