Dépannage SMTP

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

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

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

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.

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. Consultez Comment tester l’envoi avant la vérification de mon espace de travail ?.

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

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 et Rebonds et plaintes.

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, 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 ou activez la recharge automatique. Les e-mails que l’expéditeur renvoie arrivent dès que des crédits sont disponibles.

Problèmes de connexion

Pour plus de détails, consultez Pourquoi ai-je des erreurs TLS en me connectant à SMTP ?.

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. Corrigez la cause, puis relancez-le. Consultez Pourquoi mon e-mail est-il retenu ?.
• Suppressed : le destinataire figure dans votre liste d’adresses bloquées.
• 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.

Pour une liste de contrôle complète, consultez Pourquoi mon e-mail n’est-il pas arrivé ?.

Le problème persiste ?

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