Référence
Codes de statut étendus
Les codes de statut étendus RFC 3463 comme 5.1.1, 4.7.0 et 5.7.26 expliqués, avec la cause habituelle de chacun et ce qu’il faut changer avant de renvoyer.
Les codes de statut étendus sont les codes x.y.z qui suivent la réponse à trois chiffres dans la plupart des réponses SMTP. Ils sont plus précis que le code de réponse : c’est donc le moyen le plus rapide de comprendre pourquoi un e-mail a rebondi ou a été différé.
Structure du code
Un code de statut étendu comporte trois parties, class.subject.detail :
550 5.1.1 The email account that you tried to reach does not exist.
│ │ └─ detail: bad destination mailbox address
│ └─── subject: addressing
└───── class: permanent failure| Classe | Signification |
|---|---|
2 |
Succès. |
4 |
Échec temporaire persistant. Le message pourra peut-être être livré s’il est renvoyé plus tard. |
5 |
Échec permanent. Renvoyer le même message ne fonctionnera pas. |
| Sujet | Domaine |
|---|---|
0 |
Autre ou non défini. |
1 |
Adressage : l’adresse de l’expéditeur ou du destinataire. |
2 |
Boîte aux lettres : la boîte aux lettres du destinataire, par exemple pleine ou désactivée. |
3 |
Système de messagerie : le système destinataire, par exemple ses limites de stockage ou de taille. |
4 |
Réseau et routage : DNS, connexions et timeouts. |
5 |
Protocole de livraison : commandes et syntaxe SMTP. |
6 |
Contenu ou format du message : encodage et conversion. |
7 |
Sécurité ou règles : authentification, filtrage anti-spam et réputation. |
Emailit enregistre le code étendu de chaque livraison en échec. Vous le trouvez avec la réponse complète dans l’onglet Deliveries de l’e-mail, et dans smtp_enhanced_code des événements webhook email.attempted. Le fait qu’Emailit réessaie ou non dépend du code de réponse et du message, comme l’explique Traitement des réponses par Emailit.
Codes de succès
| Code | Signification | Remarques |
|---|---|---|
2.0.0 |
Succès. | Le relais SMTP d’Emailit répond 250 2.0.0 OK: queued as em_... lorsqu’il accepte votre message. |
2.1.5 |
Adresse de destination valide. | Le destinataire a été accepté. |
2.6.0 |
Message accepté. | Fréquent dans les réponses des serveurs Microsoft. |
Échecs temporaires (4.x.x)
| Code | Signification | Cause fréquente | Que faire |
|---|---|---|---|
4.2.1 |
Boîte aux lettres temporairement indisponible. | La boîte aux lettres reçoit des e-mails trop rapidement, ou elle est inactive. | Rien pour un message isolé. Emailit traite comme permanentes les réponses de Gmail « receiving mail at a rate » et « inactive mailbox ». |
4.2.2 |
Boîte aux lettres pleine. | Le destinataire a dépassé son quota de stockage. | Emailit traite les réponses courantes de dépassement de quota comme des rebonds définitifs. Retirez l’adresse si le problème se répète. |
4.3.0 |
Problème du système de messagerie. | Une panne temporaire sur le serveur destinataire. | Rien. Emailit réessaie. |
4.4.1 |
Pas de réponse de l’hôte. | Le serveur du destinataire n’a pas répondu ou la connexion a expiré. | Rien pour un message isolé. Si tout un domaine est concerné, vérifiez que ses enregistrements MX fonctionnent. |
4.4.2 |
Mauvaise connexion. | La connexion a été coupée pendant la transaction. | Rien. Emailit réessaie. |
4.4.5 |
Congestion du système. | Le serveur destinataire est surchargé. Le relais d’Emailit utilise aussi ce code lorsque vous dépassez votre limite d’envoi par seconde. | Ralentissez. Pour le relais d’Emailit, restez sous votre limite par seconde. |
4.5.3 |
Trop de destinataires. | Trop de destinataires dans une seule transaction. Le relais d’Emailit utilise aussi ce code lorsque vous atteignez votre limite d’envoi quotidienne. | Pour le relais d’Emailit, attendez la réinitialisation quotidienne à 0 h 00 UTC ou demandez une limite plus élevée. |
4.7.0 |
Rejet temporaire pour raison de sécurité ou de règles. | Greylisting (mise en liste grise), ou un fournisseur qui limite le débit d’e-mails qu’il juge suspects, comme le « unusual rate of unsolicited mail » de Gmail. | Laissez Emailit réessayer. Si le problème persiste, vérifiez votre santé d’envoi, vos taux de plainte et votre authentification. |
4.7.1 |
Livraison temporairement non autorisée. | Greylisting ou blocage temporaire lié à une règle. | Laissez Emailit réessayer. |
4.7.28 |
Débit limité (Gmail). | Gmail a détecté un taux inhabituel d’e-mails non sollicités depuis votre IP ou votre domaine. | Réduisez le volume vers Gmail, nettoyez votre liste et examinez les plaintes. |
Échecs permanents (5.x.x)
| Code | Signification | Cause fréquente | Que faire |
|---|---|---|---|
5.0.0 |
Échec permanent, sans détail. | Un rejet générique. | Lisez le texte du message pour en connaître la raison. |
5.1.0 |
Erreur d’adresse. | L’adresse a été rejetée pour une raison d’adressage non précisée. | Vérifiez que l’adresse ne contient pas de faute de frappe. |
5.1.1 |
Boîte aux lettres de destination incorrecte. | La boîte aux lettres n’existe pas. | Retirez l’adresse. Emailit la bloque si elle rebondit de nouveau définitivement dans les 24 heures. |
5.1.2 |
Système de destination incorrect. | Le domaine du destinataire n’existe pas ou n’a pas de serveur de messagerie. | Vérifiez que le domaine ne contient pas de faute de frappe, comme gmial.com. |
5.1.3 |
Syntaxe de l’adresse de destination incorrecte. | L’adresse n’est pas valide. | Corrigez l’adresse, ou vérifiez votre liste avant d’envoyer. |
5.1.8 |
Adresse du système de l’expéditeur incorrecte. | Le serveur destinataire n’a pas pu résoudre le domaine de l’expéditeur d’enveloppe. | Vérifiez que vos enregistrements MX et SPF de return-path sur emailit.yourdomain.com sont publiés. Consultez Enregistrements DNS. |
5.1.10 |
Le destinataire a un MX nul, ou destinataire introuvable. | MX nul selon la RFC 7505. Microsoft utilise aussi ce code lorsque le destinataire n’existe pas. | Retirez l’adresse. |
5.2.1 |
Boîte aux lettres désactivée. | Le compte a été fermé ou suspendu. | Retirez l’adresse. |
5.2.2 |
Boîte aux lettres pleine. | Le destinataire a dépassé son quota. | Réessayez beaucoup plus tard, ou retirez l’adresse si le problème se répète. |
5.2.3 |
Message trop long pour la boîte aux lettres. | Le message dépasse la taille maximale du destinataire. | Réduisez la taille du message. |
5.3.4 |
Message trop volumineux pour le système. | Le message dépasse la taille maximale du serveur destinataire. | Envoyez des pièces jointes plus petites, ou ajoutez plutôt un lien vers les fichiers. |
5.4.1 |
Pas de réponse de l’hôte, ou accès refusé. | Microsoft l’utilise lorsqu’un destinataire est rejeté en périphérie, souvent parce que l’adresse n’existe pas. | Vérifiez l’adresse et retirez-la si elle est invalide. |
5.4.4 |
Routage impossible. | Le domaine du destinataire n’a pas d’enregistrement MX ou A utilisable. | Vérifiez le domaine. |
5.5.0 |
Erreur de protocole. | Le serveur a rejeté une commande SMTP. | Contactez le support si de nombreux destinataires sont concernés. |
5.7.0 |
Rejet pour raison de sécurité ou de règles. | Un blocage générique lié à une règle, souvent pour spam ou réputation. | Lisez le texte du message, et vérifiez le contenu et la qualité de votre liste. |
5.7.1 |
Livraison non autorisée, message refusé. | Le serveur du destinataire a bloqué le message ou votre IP : filtrage anti-spam, blocklist, ou destinataire qui n’accepte que les e-mails de certains expéditeurs. | Lisez le texte du message. Pour les blocklists, consultez les bonnes pratiques. Emailit met en pause cette route IP-domaine pendant une heure pour les blocages qui ne concernent pas le contenu. |
5.7.8 |
Identifiants d’authentification invalides. | Nom d’utilisateur ou mot de passe erroné, généralement quand votre application se connecte à un serveur SMTP. | Pour le relais d’Emailit, utilisez une clé API comme mot de passe. |
5.7.9 |
Mécanisme d’authentification trop faible. | Le serveur exige une méthode de connexion plus robuste. | Utilisez PLAIN ou LOGIN via TLS avec le relais d’Emailit. |
5.7.23 |
Échec de la validation SPF. | L’IP d’envoi n’est pas autorisée par l’enregistrement SPF du domaine de l’expéditeur d’enveloppe. | Assurez-vous que l’enregistrement TXT sur emailit.yourdomain.com contient include:_spf.emailit.com. |
5.7.25 |
Échec de la validation du DNS inverse. | L’IP d’envoi n’a pas d’enregistrement PTR correspondant. | Contactez le support. Emailit gère le DNS inverse de ses IP. |
5.7.26 |
Plusieurs contrôles d’authentification ont échoué, ou DMARC a échoué. | Le message a échoué à l’alignement SPF et DKIM, et la politique DMARC du domaine demande le rejet. Gmail l’utilise aussi pour les e-mails non authentifiés. | Vérifiez votre domaine pour que DKIM soit validé, et contrôlez avec les rapports DMARC les autres services qui envoient avec votre domaine. |
5.7.27 |
L’adresse de l’expéditeur a un MX nul. | MX nul selon la RFC 7505 sur le domaine de l’expéditeur. Gmail l’utilise aussi lorsque SPF échoue. | Vérifiez vos enregistrements return-path et SPF. |
5.7.509 |
Accès refusé, échec DMARC (Microsoft). | Outlook.com a rejeté le message parce qu’il a échoué à DMARC et que votre politique est reject. |
Corrigez SPF et DKIM pour le service d’envoi, puis revoyez votre politique DMARC. |
5.7.515 |
Accès refusé, niveau d’authentification insuffisant (Microsoft). | Outlook.com exige que SPF, DKIM et DMARC soient validés pour les expéditeurs à fort volume. | Publiez un enregistrement DMARC et assurez-vous que votre domaine est vérifié dans Emailit. |
5.7.606 |
Accès refusé, IP d’envoi bannie (Microsoft). | L’IP d’envoi figure sur la liste de blocage de Microsoft. | Contactez le support avec la réponse complète. |