GUIDE

Relais SMTP

Connectez WordPress, Laravel, Django, un ERP ou tout logiciel qui parle SMTP à Zendou, sans changer son code d'envoi. Même solde de crédits, même journal, mêmes règles de délivrabilité que l'API — juste un port SMTP à la place d'un appel HTTP.

Paramètres de connexion

Hôte unique, trois ports possibles selon ce que votre hébergeur autorise :

Port	Mode	Quand l’utiliser
587	STARTTLS	Port principal, recommandé par défaut — celui qu'utilisent WP Mail SMTP, PHPMailer, Laravel, Django, Rails et Nodemailer sans configuration particulière.
465	TLS implicite	À utiliser si votre hébergeur l'impose (ex. SMTPSecure = 'ssl' côté PHP).
2525	STARTTLS (alternative)	À essayer si le port 587 est bloqué par votre hébergeur ou votre opérateur réseau.

Hôte : smtp.zendou.app, pour les trois ports. Le port 25 n’est jamais écouté — c’est un port de transit entre serveurs de messagerie, pas de soumission depuis un logiciel client.

Authentification uniquement sur canal chiffré

AUTH PLAIN et AUTH LOGIN ne sont acceptées qu’une fois la connexion chiffrée — après STARTTLS sur les ports 587/2525, ou d’emblée sur le port 465 (TLS implicite). Une tentative d’authentification avant chiffrement est refusée.

Créer un identifiant SMTP

Le relais utilise des identifiants dédiés, distincts de votre clé API (zd_live_…) — créés depuis le tableau de bord, Relais SMTP. Chaque identifiant se compose d’un nom d’utilisateur opaque et d’un mot de passe généré :

zdu_… — nom d’utilisateur (16 caractères hexadécimaux), sans lien avec votre adresse email.
zd_smtp_… — mot de passe généré, affiché une seule fois à la création.

Copiez le mot de passe avant de fermer l'écran

Comme pour une clé API, Zendou ne stocke que l’empreinte du mot de passe, jamais sa valeur en clair : si vous le perdez, révoquez l’identifiant et créez-en un nouveau. Révoquer un identifiant n’affecte ni votre clé API ni vos autres identifiants SMTP.

Exemples de configuration

Remplacez zdu_votre_identifiant et zd_smtp_votre_mot_de_passe par les valeurs affichées à la création de votre identifiant.

Mailer          : Other SMTP
SMTP Host       : smtp.zendou.app
Encryption      : STARTTLS   (TLS pour le port 465)
SMTP Port       : 587
Auto TLS        : Activé
Authentication  : Activé
SMTP Username   : zdu_votre_identifiant
SMTP Password   : zd_smtp_votre_mot_de_passe
From Email      : une adresse de votre domaine vérifié dans Zendou

Domaine d’expédition et adresse de test

Le relais applique exactement les mêmes règles que l’API : l’adresse indiquée dans l’en-tête From: doit appartenir à un domaine vérifié de votre compte, et il en va de même pour l’en-tête Reply-To:, s’il est présent.

L'adresse de test fonctionne aussi en SMTP

Pas encore de domaine vérifié ? L’adresse d’expédition de test de votre compte (copiable sur Clés API) est utilisable pour vos identifiants SMTP, avec la même restriction que sur l’API : vérifiez un domaine pour écrire à vos vrais utilisateurs.

Limites et facturation

✓1 crédit par destinataire réellement remis. Le relais accepte le champ Cc: et la copie cachée (Bcc) : chaque adresse que votre logiciel soumet en RCPT TO — que ce soit via To:, Cc: ou un champ Bcc de votre bibliothèque — consomme un crédit, exactement comme un appel API distinct par destinataire. L’en-tête Bcc: lui-même est retiré des octets transmis (les destinataires en copie ne se voient jamais entre eux), mais un destinataire mis en Bcc reste un destinataire à part entière : il reçoit le message et il est facturé.
✓10 destinataires maximum par message (To + Cc + Bcc confondus). Le 11ᵉ est refusé, les précédents restent acceptés.
✓10 Mo maximum par message, pièces jointes comprises — annoncé dans la poignée de main SMTP et vérifié à la réception.
✓Crédits épuisés → réponse temporaire. La quasi totalité des logiciels d’envoi (WordPress, Laravel, Django, ERP) relivrent automatiquement un message refusé en 4xx après une recharge, sans intervention de votre part.
✓Même journal. Chaque envoi par SMTP apparaît dans le Journal au même titre qu’un envoi API, avec le canal SMTP renseigné, et suit le même cycle de statuts — voir Envoyer un email.

Codes de réponse SMTP

Une seule réponse 250 pour tout le message

Avec plusieurs destinataires, dès qu’au moins un destinataire est accepté (ou reconnu supprimé), le message entier reçoit 250 — le texte détaille alors chaque destinataire (accepté avec son identifiant, supprimé sans expédition, ou refusé avec son motif). Un code de refus (4xx/5xx) n’est renvoyé que si tous les destinataires sont refusés — sans quoi le logiciel client rejouerait tout le message et dupliquerait les destinataires déjà servis.

Code	Cas	Message renvoyé	Marche à suivre
5505.7.1	Domaine d'expédition non vérifié	« Le domaine d'envoi n'est pas vérifié : ajoutez-le à votre compte et validez ses enregistrements DNS avant d'envoyer. »	Vérifiez le domaine de l’adresse `From:` dans Zendou avant d’envoyer — voir Vérifier un domaine.
5505.7.1	Domaine de l'adresse de réponse (Reply-To:) non vérifié	« L'adresse de réponse (reply-to) doit utiliser un domaine vérifié de votre compte : ajoutez-le et validez ses enregistrements DNS avant d'envoyer. »	Même règle que pour `From:`, vérifiez le domaine de l’adresse `Reply-To:` dans Zendou avant d’envoyer, voir Vérifier un domaine.
5505.7.1	Compte suspendu	« Ce compte est suspendu »	Suspension automatique pour protéger la réputation d'envoi (taux de rebonds ou de plaintes trop élevé). Définitif tant qu'un administrateur ne réactive pas le compte — contactez le support.
5505.7.1	Adresse du compte non confirmée	« Adresse email non confirmée : confirmez votre adresse pour activer l'envoi d'emails et la création de clés API. Un lien vous a été envoyé à l'inscription ; vous pouvez en demander un nouveau depuis votre tableau de bord. »	Confirmez l'adresse email de votre compte (lien envoyé à l'inscription, renvoyable depuis le tableau de bord).
5505.7.1	Adresse de test vers un destinataire tiers	« Depuis l'adresse de test, vous ne pouvez écrire qu'à l'adresse email de votre compte. Vérifiez un domaine pour écrire à vos utilisateurs. »	Depuis l'adresse de test, n'écrivez qu'à l'adresse email de votre propre compte, ou vérifiez un domaine pour écrire à vos utilisateurs.
4504.7.0	Crédits épuisés	« Crédits insuffisants : rechargez votre compte pour continuer à envoyer. »	Rechargez votre solde (voir Facturation). Réponse temporaire : votre logiciel d’envoi relivre normalement le message tout seul une fois le solde reconstitué.
4514.7.0	Quota journalier atteint	« Limite journalière atteinte : réessayez demain ou demandez une augmentation de quota. »	Temporaire, se réinitialise à minuit UTC — la plupart des logiciels SMTP relivrent automatiquement.
4514.7.0	Trop de messages en peu de temps (rafale)	« Trop de messages en peu de temps ; réessayez dans un instant. »	Ralentissez la cadence d'envoi — temporaire, réessayez après quelques instants.
4524.5.3	Trop de destinataires pour ce message	« Trop de destinataires pour ce message. »	10 destinataires maximum par message (To + Cc + Bcc confondus), ou solde/quota insuffisant pour couvrir tous les destinataires du message. Répartissez sur plusieurs messages si nécessaire.
5355.7.8	Identifiant ou mot de passe SMTP invalide	« Authentification refusée : identifiant ou mot de passe invalide. »	Vérifiez l’identifiant (`zdu_…`) et le mot de passe (`zd_smtp_…`) sur /dashboard/smtp — même message que l’identifiant soit inconnu, révoqué, ou le mot de passe faux (aucun indice n’est donné sur la cause exacte).
5525.3.4	Message trop volumineux	« Message trop volumineux : la taille dépasse la limite autorisée par ce relais. »	Réduisez la taille du message, pièces jointes comprises — 10 Mo maximum.
5545.6.0	En-têtes MIME illisibles, plusieurs From:, ou plusieurs Reply-To:	« Message MIME invalide, ou plusieurs en-têtes « From: ». »	Vérifiez que le message est un MIME valide avec un seul en-tête From: et un seul Reply-To: bien formés.
5545.6.0	Contenu non encodé en UTF-8	« Message refusé : son contenu n'est pas encodé en UTF-8. Encodez le corps et les pièces jointes avec un transfer-encoding standard (quoted-printable ou base64). »	Encodez le corps et les pièces jointes en quoted-printable ou en base64 — la quasi-totalité des clients SMTP le font par défaut dès qu'un jeu de caractères non-ASCII est déclaré.

D’autres refus, plus rares, protègent la connexion elle-même plutôt qu’un message précis — vous ne les rencontrerez pas avec un logiciel correctement configuré :

Code	Cas
530 5.7.0	MAIL FROM envoyé sans authentification réussie au préalable
538 5.7.11	AUTH tenté avant le chiffrement (avant STARTTLS)
421 4.7.0	Trop de connexions depuis la même IP, trop d'échecs d'authentification, trop de messages sur une même connexion, ou trop de destinataires refusés — la connexion est fermée dans les quatre cas.

Voir aussi Erreurs pour la référence complète des codes HTTP de l’API — le canal SMTP a sa propre table de codes, ci-dessus, parce qu’un serveur SMTP répond en codes à trois chiffres, pas en HTTP.