# 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](/fr/docs/dictionary/enhanced-status-codes/) et d’un message lisible :

```text
550 5.1.1 <ada@example.com>: Recipient address rejected: User unknown
```

Le 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](/fr/docs/logs/email-details/) 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`, `553` ou `554`, et les réponses dont le texte indique un échec permanent. L’e-mail reçoit le statut `bounced`.
- **Nouvelle tentative.** Tout le reste, y compris `421`, `450`, `451`, `452`, les timeouts et les erreurs de connexion. L’e-mail reçoit le statut `attempted` et 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 `451` met en pause la livraison depuis cette IP d’envoi vers ce domaine destinataire pendant 5 minutes. Un blocage `550 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 à `attempted` et sont réessayés selon le calendrier normal.

Les rebonds définitifs entraînent un [blocage automatique](/fr/docs/suppressions/manage/) 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](/fr/docs/dictionary/bounce-categories/).

## 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. |

> **Pourquoi certains codes 5xx sont réessayés:** Emailit ne classe immédiatement un e-mail en rebond que sur `550`, `551`, `553` et `554`, ou quand la réponse indique un échec permanent. Les autres réponses `5xx` sont réessayées comme des échecs temporaires et rebondissent après la septième tentative. L’e-mail affiche `attempted` entre-temps.

## 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 API → Logs**, 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](/fr/docs/limits/) 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](/fr/docs/workspaces/production-access/) 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](/fr/docs/domains/verification/) 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](/fr/docs/deliverability/sending-health/). |
| `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.

> **E-mails entrants:** Quand Emailit reçoit des e-mails pour votre [sous-domaine de réception](/fr/docs/inbound/set-up/) et que l’espace de travail n’a plus de crédits, le serveur expéditeur reçoit `452 Insufficient credits to receive inbound email` et réessaie plus tard.

## Voir aussi

- [Codes de statut étendus](/fr/docs/dictionary/enhanced-status-codes/)
- [Catégories de rebonds](/fr/docs/dictionary/bounce-categories/)
- [Paramètres SMTP](/fr/docs/smtp/settings/)
- [Dépannage SMTP](/fr/docs/smtp/troubleshooting/)

---
Source: https://emailit.com/fr/docs/dictionary/smtp-reply-codes/