Référence
Codes de réponse SMTP
La signification de chaque code de réponse SMTP, s’il est temporaire ou permanent, comment Emailit le traite, et les réponses que le relais SMTP d’Emailit envoie à votre application.
Chaque commande SMTP reçoit une réponse à trois chiffres. Cette page liste les codes que vous rencontrez à deux endroits : les réponses des serveurs de messagerie des destinataires quand Emailit livre vos e-mails, et les réponses du relais SMTP d’Emailit quand votre application envoie via smtp.emailit.com.
Lire une réponse
Une réponse commence par un code à trois chiffres, généralement suivi d’un code de statut étendu et d’un message lisible :
550 5.1.1 <ada@example.com>: Recipient address rejected: User unknownLe premier chiffre indique le résultat :
| Premier chiffre | Signification | Ce que l’expéditeur doit faire |
|---|---|---|
2 |
Succès. La commande a été acceptée. | Continuer. |
3 |
Intermédiaire. Le serveur attend d’autres données, par exemple le corps du message après DATA. |
Envoyer la partie suivante. |
4 |
Échec temporaire. La même commande pourra peut-être fonctionner plus tard. | Réessayer plus tard. |
5 |
Échec permanent. Répéter la commande ne servira à rien. | Ne pas réessayer sans rien changer. |
Le deuxième chiffre donne la catégorie (0 syntaxe, 1 information, 2 connexion, 5 système de messagerie), et le troisième la précise. Les serveurs emploient souvent les codes de façon approximative : lisez donc toujours aussi le code étendu et le texte du message.
Traitement des réponses des serveurs destinataires par Emailit
Quand le serveur d’un destinataire répond par un échec, Emailit enregistre une livraison avec la réponse complète et décide s’il faut réessayer :
- Rebond immédiat. Les réponses avec le code
550,551,553ou554, et les réponses dont le texte indique un échec permanent. L’e-mail reçoit le statutbounced. - Nouvelle tentative. Tout le reste, y compris
421,450,451,452, les timeouts et les erreurs de connexion. L’e-mail reçoit le statutattemptedet Emailit réessaie jusqu’à 7 fois sur environ 21 heures (après 10, 20, 40, 80, 160, 320 et 640 minutes). Si toutes les tentatives échouent, l’e-mail rebondit et l’adresse est bloquée. - Traité comme permanent malgré un code 4xx. Les réponses courantes « mailbox full », « over quota », « user unknown », « mailbox disabled » et « relay access denied » sont converties en échec permanent, car les réessayer fonctionne rarement.
- Pause temporaire. Une réponse
451met en pause la livraison depuis cette IP d’envoi vers ce domaine destinataire pendant 5 minutes. Un blocage550 5.7.1(pour une raison autre que le contenu) la met en pause pendant 1 heure. Les e-mails qui tombent sur une pause passent àattemptedet sont réessayés selon le calendrier normal.
Les rebonds définitifs entraînent un blocage automatique selon les paramètres de votre espace de travail. Pour les causes et les solutions regroupées par problème, consultez Catégories de rebonds.
Référence des codes de réponse
La colonne « Emailit » décrit ce qui se passe quand le serveur d’un destinataire envoie ce code pendant la livraison.
2xx et 3xx : succès et réponses intermédiaires
| Code | Signification | Type | Emailit |
|---|---|---|---|
220 |
Service prêt. Message d’accueil du serveur, également envoyé avant une négociation STARTTLS. |
Succès | Poursuit l’échange. |
221 |
Fermeture de la connexion, généralement après QUIT. |
Succès | Aucune action. |
235 |
Authentification réussie. | Succès | Non utilisé lors de la livraison aux destinataires ; le relais d’Emailit l’envoie à votre application après AUTH. |
250 |
Action demandée terminée. Après DATA, le serveur a accepté le message. |
Succès | Passe l’e-mail à delivered. |
251 |
Utilisateur non local ; le serveur va transférer le message. | Succès | Traité comme 250. |
252 |
Le serveur ne peut pas vérifier l’utilisateur, mais va tenter la livraison. | Succès | Traité comme 250. |
354 |
Début de l’envoi du corps du message ; terminez-le par une ligne contenant un seul point. | Intermédiaire | Envoie le message. |
4xx : échecs temporaires
| Code | Signification | Type | Emailit |
|---|---|---|---|
421 |
Service indisponible, fermeture de la connexion. Souvent trop de connexions ou un blocage temporaire lié à la réputation. | Temporaire | Réessayé. Les variantes boîte pleine et compte indisponible rebondissent. |
450 |
Boîte aux lettres indisponible, par exemple occupée, verrouillée ou en greylisting. | Temporaire | Réessayé. Les variantes quota, utilisateur inconnu et boîte désactivée rebondissent. |
451 |
Erreur locale de traitement, souvent une limitation du débit ou du greylisting. | Temporaire | Réessayé, avec une pause de 5 minutes pour cette IP et ce domaine. Les variantes dépassement de quota et boîte inactive rebondissent. |
452 |
Stockage système insuffisant, ou trop de destinataires dans une seule transaction. | Temporaire | Réessayé. Les variantes quota, stockage et boîte pleine rebondissent. |
454 |
Échec temporaire d’authentification ou de TLS. | Temporaire | Réessayé. Les variantes « Relay access denied » rebondissent. |
5xx : échecs permanents
| Code | Signification | Type | Emailit |
|---|---|---|---|
500 |
Erreur de syntaxe, commande non reconnue. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
501 |
Erreur de syntaxe dans les paramètres ou les arguments, comme une adresse mal formée. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
502 |
Commande non implémentée. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
503 |
Mauvaise séquence de commandes. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
504 |
Paramètre de commande non implémenté. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
521 |
Le domaine n’accepte pas d’e-mails (RFC 7504). | Permanent | Réessayé, puis rebondit après la dernière tentative. |
530 |
Authentification requise, ou le serveur exige d’abord TLS. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
534 |
Mécanisme d’authentification trop faible. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
535 |
Identifiants d’authentification invalides. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
538 |
Chiffrement requis pour le mécanisme d’authentification demandé. | Permanent | Réessayé, puis rebondit après la dernière tentative. |
550 |
Boîte aux lettres indisponible : l’adresse n’existe pas, ou le serveur a refusé le message pour des raisons de règles ou de spam. | Permanent | Rebondit. Les blocages 550 5.7.1 déclenchent aussi une pause de 1 heure pour cette IP et ce domaine. |
551 |
Utilisateur non local ; le serveur ne transférera pas le message. | Permanent | Rebondit. |
552 |
Boîte aux lettres pleine, ou message qui dépasse la taille maximale du serveur. | Permanent | Réessayé, puis rebondit après la dernière tentative. Les réponses connues de dépassement de quota rebondissent immédiatement. |
553 |
Nom de boîte aux lettres non autorisé, par exemple une adresse invalide. | Permanent | Rebondit. |
554 |
Échec de la transaction, souvent un rejet lié à une règle, au spam ou à la réputation. Également envoyé comme message d’accueil quand un serveur refuse la connexion. | Permanent | Rebondit. |
555 |
Paramètres MAIL FROM ou RCPT TO non reconnus. |
Permanent | Réessayé, puis rebondit après la dernière tentative. |
556 |
Le domaine n’accepte pas d’e-mails (RFC 7504). | Permanent | Réessayé, puis rebondit après la dernière tentative. |
Réponses du relais SMTP d’Emailit
Quand votre application envoie via smtp.emailit.com, voici les réponses qu’Emailit peut renvoyer. Les réponses aux commandes MAIL et DATA sur une connexion authentifiée apparaissent aussi dans Email APILogs, avec leur code de statut.
| Réponse | Commande | Cause | Que faire |
|---|---|---|---|
235 Authentication successful |
AUTH |
La clé API a été acceptée. | Continuez. |
535 Authentication failed |
AUTH |
Le mot de passe n’est une clé API valide pour aucun espace de travail. | Utilisez une clé API en cours de validité comme mot de passe. Le nom d’utilisateur peut être emailit. |
454 Temporary authentication failure |
AUTH |
Emailit n’a pas pu vérifier la clé à cause d’une erreur interne. | Réessayez après un court délai. |
504 Error: Unrecognized authentication type |
AUTH |
Votre client a utilisé une méthode autre que PLAIN ou LOGIN, comme CRAM-MD5. |
Configurez le client sur PLAIN ou LOGIN. |
452 4.4.5 Messages per second limit exceeded (n/limit) |
MAIL FROM |
L’espace de travail a atteint sa limite d’envoi par seconde. Cette limite est commune à l’API et au SMTP. | Ralentissez et réessayez. La plupart des bibliothèques d’e-mail réessaient automatiquement après une réponse 4xx. |
452 4.5.3 Daily message limit exceeded (n/limit) |
MAIL FROM |
L’espace de travail a atteint sa limite d’envoi quotidienne, réinitialisée à 0 h 00 UTC. | Attendez la réinitialisation ou demandez une limite plus élevée depuis le tableau de bord. |
451 Temporary local error in processing |
MAIL FROM, RCPT TO, DATA |
Un problème temporaire du côté d’Emailit. | Réessayez plus tard. |
530 Authentication required |
RCPT TO |
Le client ne s’est pas authentifié avant d’envoyer. | Activez l’authentification SMTP dans votre client. |
501 Invalid RCPT TO format |
RCPT TO |
L’adresse du destinataire est mal formée. | Corrigez l’adresse. |
550 Unverified workspaces can only send to workspace members' account emails. |
RCPT TO |
L’espace de travail est en mode bac à sable et le destinataire n’en est pas membre. | Envoyez à l’adresse e-mail du compte d’un membre, ou demandez l’accès production. |
535 Mail server has been suspended |
RCPT TO |
L’espace de travail est suspendu. | Vérifiez votre santé d’envoi et contactez le support. |
530 From/Sender domain is not verified for this workspace. From: ... |
DATA |
L’en-tête From n’utilise pas un domaine d’envoi vérifié de l’espace de travail. Les sous-domaines doivent être vérifiés séparément. |
Vérifiez le domaine ou changez l’adresse From. |
530 API key is restricted to sending domain: acme.com. ... |
DATA |
La clé API est limitée à un domaine et l’adresse From en utilise un autre. |
Utilisez le domaine autorisé ou une autre clé. |
550 Sending from this domain is paused |
DATA |
Le domaine a été mis en pause, généralement à cause d’un taux de rebond élevé. | Consultez Santé d’envoi. |
552 Message too large (maximum size 40MB) |
DATA |
Le message, pièces jointes encodées comprises, dépasse 40 Mo. | Envoyez des pièces jointes plus petites ou ajoutez plutôt un lien vers les fichiers. |
550 Loop detected |
DATA |
Le message est déjà passé plus de 4 fois par le relais d’Emailit. | Vérifiez les règles de transfert qui renvoient les e-mails vers Emailit. |
550 Message processing failed |
DATA |
Emailit n’a pas pu stocker le message. | Réessayez. Si l’échec persiste, contactez le support en indiquant l’heure de la tentative. |
250 2.0.0 OK: queued as em_... |
DATA |
Emailit a accepté le message. Chaque destinataire reçoit son propre ID d’e-mail ; les ID sont listés, séparés par des virgules, lorsqu’ils tiennent dans la réponse. | Stockez l’ID pour retrouver l’e-mail dans le tableau de bord ou via l’API. |
Le relais envoie aussi les réponses standard du protocole, comme 220 à la connexion, 503 Error: need MAIL command quand les commandes arrivent dans le désordre, et 421 Timeout - closing connection quand une connexion reste inactive.