# Dépannage SMTP

> Chaque code de réponse que peut renvoyer le relais SMTP d’Emailit, avec sa cause et sa solution, ainsi que les ports bloqués, les erreurs TLS, les timeouts et les e-mails acceptés mais non livrés.

Consultez cette page quand le relais SMTP rejette un message ou que votre client ne parvient pas à se connecter. Les erreurs sont regroupées selon l’étape de la conversation SMTP où elles se produisent, et chacune indique sa cause et sa solution.

## Trouver le code de réponse

- **Dans votre application.** Les bibliothèques de messagerie incluent la réponse du serveur dans l’erreur, par exemple `Error: Invalid login: 535 Authentication failed` dans Nodemailer ou `SMTPAuthenticationError: (535, b'Authentication failed')` en Python.
- **Dans Emailit.** **Email API → Logs** enregistre chaque message soumis avec la source **SMTP** et son code de réponse, ainsi que les refus liés aux limites de débit et les échecs d’authentification pour les clés qu’Emailit peut identifier. Filtrez par **Status code** ou **API key**.
- **Avec un test manuel.** Exécutez la commande cURL de [Envoyer un message de test](/fr/docs/smtp/#send-a-test-message) avec `-v` pour voir toute la conversation.

Les codes qui commencent par `4` sont temporaires : les clients bien conçus réessaient plus tard. Les codes qui commencent par `5` sont définitifs : corrigez la cause avant de renvoyer.

## Référence rapide

| Code et message | Étape | Section |
| --- | --- | --- |
| `535 Authentication failed` | AUTH | [Erreurs d’authentification](#login-errors) |
| `454 Temporary authentication failure` | AUTH | [Erreurs d’authentification](#login-errors) |
| `452 4.4.5 Messages per second limit exceeded` | MAIL FROM | [Erreurs de limite de débit](#rate-limit-errors) |
| `452 4.5.3 Daily message limit exceeded` | MAIL FROM | [Erreurs de limite de débit](#rate-limit-errors) |
| `451 Temporary local error in processing` | Toutes | [Erreurs temporaires](#temporary-errors) |
| `501 Invalid RCPT TO` | RCPT TO | [Erreurs de destinataire](#recipient-errors) |
| `530 Authentication required` | RCPT TO | [Erreurs de destinataire](#recipient-errors) |
| `535 Mail server has been suspended` | RCPT TO | [Erreurs de destinataire](#recipient-errors) |
| `550 Unverified workspaces can only send to…` | RCPT TO | [Erreurs de destinataire](#recipient-errors) |
| `552 Message too large` | DATA | [Erreurs de message](#message-errors) |
| `530 From/Sender domain is not verified for this workspace` | DATA | [Erreurs de message](#message-errors) |
| `530 API key is restricted to sending domain` | DATA | [Erreurs de message](#message-errors) |
| `550 Sending from this domain is paused` | DATA | [Erreurs de message](#message-errors) |
| `550 Loop detected` | DATA | [Erreurs de message](#message-errors) |
| `550 Message processing failed` | DATA | [Erreurs de message](#message-errors) |
| `452 Insufficient credits to receive inbound email` | DATA | [Erreurs de réception](#inbound-errors) |

## Erreurs d’authentification

Elles surviennent quand votre client envoie `AUTH`.

### 535 Authentication failed

**Cause.** Le mot de passe n’est une clé API valide pour aucun espace de travail. La clé contient peut-être une faute de frappe ou des espaces en trop, a peut-être été supprimée ou régénérée, ou il s’agit peut-être d’une ancienne clé que vous avez remplacée.

**Solution.** Copiez de nouveau la clé depuis l’endroit où vous l’avez stockée à sa création. Emailit n’affiche les clés qu’une seule fois : si vous ne l’avez plus, créez une nouvelle clé dans **Email API → API Keys**. Utilisez `emailit` comme nom d’utilisateur et la clé complète, commençant par `secret_`, comme mot de passe. Consultez [Pourquoi SMTP renvoie-t-il 535 Authentication failed ?](/fr/docs/kb/smtp-535-authentication-failed/).

### 454 Temporary authentication failure

**Cause.** Emailit n’a pas pu vérifier la clé en raison d’une erreur interne.

**Solution.** Réessayez après un court délai. Si le problème dure plus de quelques minutes, consultez [status.emailit.com](https://status.emailit.com) et contactez le support.

## Erreurs de limite de débit

Elles surviennent quand votre client envoie `MAIL FROM` pour commencer un message.

### 452 4.4.5 Messages per second limit exceeded

**Cause.** Votre espace de travail a envoyé au cours de la dernière seconde plus de messages que sa limite par seconde, fixée à 2 par défaut. La limite est partagée avec l’API et compte chaque transaction SMTP comme un message. Les nombres entre parenthèses indiquent le compteur actuel et la limite.

**Solution.** La plupart des clients réessaient automatiquement après un `452`. Pour l’éviter, envoyez via une file d’attente avec une simultanéité limitée, ou réutilisez une seule connexion et envoyez les messages les uns après les autres. Si vous avez besoin d’un débit plus élevé, utilisez **Request Increase** sur la carte **Sending Limits** de la page d’accueil du tableau de bord. Consultez [Limites](/fr/docs/limits/).

### 452 4.5.3 Daily message limit exceeded

**Cause.** L’espace de travail a atteint sa limite quotidienne, fixée à 5 000 messages par défaut et partagée avec l’API.

**Solution.** L’envoi reprend après minuit UTC. Demandez une limite quotidienne plus élevée depuis la carte **Sending Limits** de la page d’accueil du tableau de bord. Les espaces de travail Pro et Business bénéficient aussi de hausses automatiques quand leur santé d’envoi est bonne.

## Erreurs temporaires

### 451 Temporary local error in processing

**Cause.** Emailit a rencontré une erreur interne en traitant la commande. Cela peut se produire à n’importe quelle étape.

**Solution.** Réessayez plus tard. Les serveurs de messagerie et la plupart des bibliothèques le font automatiquement pour les réponses `4xx`. Si le problème persiste, contactez le support en indiquant l’heure de la tentative.

## Erreurs de destinataire

Elles surviennent quand votre client envoie `RCPT TO` pour chaque destinataire.

### 501 Invalid RCPT TO

**Cause.** L’adresse du destinataire est mal formée, par exemple elle n’a pas de `@` ou rien avant ou après. Le message complet est `Invalid RCPT TO format` ou `Invalid RCPT TO`.

**Solution.** Validez les adresses avant d’envoyer. Vérifiez l’absence de valeurs vides et de noms d’affichage transmis là où seule une adresse est attendue.

### 530 Authentication required

**Cause.** Le client ne s’est pas authentifié, ou son authentification a échoué et il a continué malgré tout. Sans authentification, le relais n’accepte que les e-mails destinés aux adresses de réception et de rebond propres à Emailit.

**Solution.** Activez l’authentification SMTP dans votre client et définissez le nom d’utilisateur et le mot de passe. Recherchez un `535` antérieur dans la même session.

### 535 Mail server has been suspended

**Cause.** L’espace de travail est suspendu, généralement à cause d’un taux de rebond élevé. Consultez [Santé d’envoi](/fr/docs/deliverability/sending-health/).

**Solution.** Contactez le support à l’adresse support@emailit.com. L’envoi reprend une fois la suspension levée.

### 550 Unverified workspaces can only send to workspace members' account emails

**Cause.** L’espace de travail est en mode bac à sable, et le destinataire n’est pas l’adresse e-mail du compte d’un membre de l’espace de travail. Le message se termine par l’adresse bloquée.

**Solution.** Testez avec l’adresse e-mail du compte d’un membre, ou [demandez l’accès production](/fr/docs/workspaces/production-access/). Consultez [Comment tester l’envoi avant la vérification de mon espace de travail ?](/fr/docs/kb/test-sending-before-production-access/).

## Erreurs de message

Elles surviennent après que votre client a envoyé le message avec `DATA`.

### 552 Message too large (maximum size 40MB)

**Cause.** Le message, pièces jointes encodées comprises, dépasse 40 Mo. L’encodage Base64 rend les pièces jointes environ un tiers plus volumineuses que les fichiers.

**Solution.** Envoyez des pièces jointes plus petites, ou déposez les fichiers volumineux sur votre propre espace de stockage et incluez un lien.

### 530 From/Sender domain is not verified for this workspace

**Cause.** Une adresse de l’en-tête `From` ne se trouve pas sur un domaine d’envoi vérifié de l’espace de travail propriétaire de la clé. Raisons fréquentes : le domaine n’est pas encore vérifié ou attend un examen, l’adresse d’expéditeur est sur un sous-domaine que vous n’avez pas ajouté, la clé appartient à un autre espace de travail, ou le message n’a pas d’en-tête `From`. L’adresse d’enveloppe `MAIL FROM` n’a pas d’importance.

**Solution.** Vérifiez le statut du domaine dans **Email API → Domains**, faites correspondre exactement l’adresse d’expéditeur à un domaine vérifié et utilisez une clé du même espace de travail. Consultez [Pourquoi SMTP renvoie-t-il 530 From domain not verified ?](/fr/docs/kb/smtp-530-from-domain-not-verified/).

### 530 API key is restricted to sending domain

**Cause.** La clé est une clé **Sending Only** limitée à un domaine, et l’adresse d’expéditeur est sur un autre domaine. Le message indique le domaine autorisé.

**Solution.** Envoyez depuis le domaine autorisé, ou utilisez une clé sans restriction de domaine.

### 550 Sending from this domain is paused

**Cause.** Emailit a mis en pause le domaine d’expéditeur parce que son taux de rebond a dépassé 5 %.

**Solution.** Trouvez l’origine des rebonds et nettoyez votre liste. Consultez [Santé d’envoi](/fr/docs/deliverability/sending-health/) et [Rebonds et plaintes](/fr/docs/deliverability/bounces-and-complaints/).

### 550 Loop detected

**Cause.** Le message est déjà passé plus de quatre fois par le relais Emailit, généralement parce que des règles de transfert le renvoient dans un sens puis dans l’autre.

**Solution.** Trouvez et cassez la boucle de transfert entre vos systèmes ou vos boîtes aux lettres.

### 550 Message processing failed

**Cause.** Emailit a accepté les données mais n’a pas pu stocker le message.

**Solution.** Renvoyez le message. S’il échoue de nouveau, contactez le support en indiquant l’heure de la tentative et les adresses From et To.

## Erreurs de réception

### 452 Insufficient credits to receive inbound email

**Cause.** Un message a été envoyé à l’une de vos adresses de [réception](/fr/docs/inbound/), mais l’espace de travail n’a plus de crédits. Recevoir un e-mail coûte 1 crédit. Le serveur expéditeur reçoit cette erreur temporaire et réessaie plus tard.

**Solution.** Rechargez vos [crédits](/fr/docs/billing/credits/) ou activez la [recharge automatique](/fr/docs/billing/auto-refill/). Les e-mails que l’expéditeur renvoie arrivent dès que des crédits sont disponibles.

## Problèmes de connexion

| Symptôme | Cause probable | Solution |
| --- | --- | --- |
| La connexion expire ou est refusée | Votre FAI, votre hébergeur ou votre fournisseur cloud bloque le port. Le port 25 est bloqué sur la plupart des plateformes cloud, et certaines bloquent le 587. | Utilisez le `587`, puis le `2525` ou le `2587`. Voir [Pourquoi ma connexion SMTP expire-t-elle ?](/fr/docs/kb/smtp-connection-timeout-port-25/). |
| `wrong version number`, ou la connexion se bloque après l’établissement | Le mode TLS ne correspond pas au port : TLS implicite sur le 587, ou STARTTLS sur le 465. | Utilisez STARTTLS sur 587, 2525, 2587 et 25, et le TLS implicite uniquement sur 465. |
| Le nom du certificat ne correspond pas | Vous vous connectez par adresse IP ou via votre propre nom d’hôte. | Connectez-vous à `smtp.emailit.com`. |
| La négociation échoue sur un ancien système | Le client ne parvient pas à négocier une version récente de TLS, ou ses certificats d’autorité sont obsolètes. | Mettez à jour l’environnement d’exécution, OpenSSL et le bundle de certificats d’autorité. |

Pour plus de détails, consultez [Pourquoi ai-je des erreurs TLS en me connectant à SMTP ?](/fr/docs/kb/smtp-tls-errors/).

## Accepté mais non livré

Une réponse `250` signifie qu’Emailit a accepté le message, pas qu’il est arrivé en boîte de réception. Ouvrez l’e-mail dans **Email API → Emails** à l’aide de l’ID de la réponse et vérifiez son statut :

- **Held** : l’espace de travail n’avait plus de crédits, le domaine a été mis en pause, ou le message a obtenu un score de 7 ou plus aux [contrôles anti-spam](/fr/docs/deliverability/spam-checks/). Corrigez la cause, puis [relancez-le](/fr/docs/email-api/retry-and-forward/). Consultez [Pourquoi mon e-mail est-il retenu ?](/fr/docs/kb/email-status-held/).
- **Suppressed** : le destinataire figure dans votre [liste d’adresses bloquées](/fr/docs/suppressions/).
- **Attempted** : le serveur du destinataire a renvoyé une erreur temporaire. Emailit réessaie pendant environ 21 heures.
- **Bounced** ou **Failed** : les détails de livraison affichent la réponse du serveur destinataire. Consultez [Rebonds et plaintes](/fr/docs/deliverability/bounces-and-complaints/).

Pour une liste de contrôle complète, consultez [Pourquoi mon e-mail n’est-il pas arrivé ?](/fr/docs/kb/email-not-delivered-checklist/).

## Le problème persiste ?

Écrivez à support@emailit.com ou posez votre question sur [Discord](https://discord.emailit.com). Indiquez l’heure de la tentative, le port, votre bibliothèque de messagerie et la réponse complète du serveur.

---
Source: https://emailit.com/fr/docs/smtp/troubleshooting/