Guide fournisseur · Mailgun
Chez Mailgun, les identifiants appartiennent à un domaine, pas à votre compte, et les serveurs existent en deux régions. Ces deux faits sont invisibles à l’inscription et produisent tous deux des erreurs d’authentification qui ressemblent à un mauvais mot de passe. Voici la carte.
1 · Identifiants
Votre email et votre mot de passe Mailgun authentifient l’humain. WordPress, lui, s’authentifie comme un domaine, avec des identifiants gérés sous ce domaine.
Un compte tout neuf n’a qu’un domaine bac à sable, sandbox….mailgun.org, qui envoie vers une poignée d’adresses que vous autorisez et vers rien d’autre. Le vrai envoi commence avec votre propre domaine, réservé aux offres payantes :
Sous Sending, Domains, choisissez Add new domain. La recommandation de Mailgun lui-même est un sous-domaine du type mail.votredomaine.com, qui laisse le DNS de votre domaine racine intact.
Mailgun vous remet deux enregistrements TXT pour ce sous-domaine, SPF et DKIM. Ajoutez-les chez votre hébergeur DNS, cliquez Verify DNS settings, et Mailgun vous écrit quand la vérification passe.
Dans Domain settings, choisissez le domaine, puis l’onglet SMTP credentials. Le login par défaut a la forme postmaster@votredomaine.com.
L’onglet credentials permet de le définir ou de le réinitialiser ; faites-le et copiez le résultat, car un mot de passe existant ne se relit pas, il se réinitialise seulement.
2 · Dans le plugin
Sélectionner le preset Mailgun remplit le port (587), le chiffrement (TLS) et l’hôte américain. Si votre domaine vit dans la région européenne de Mailgun, cet hôte est faux pour vous.
smtp.mailgun.org pour un domaine en région US, smtp.eu.mailgun.org pour un domaine en région EU. La région a été choisie à l’ajout du domaine et s’affiche dans la liste des domaines.
Le login SMTP de l’onglet credentials, postmaster@votredomaine.com sauf si vous en avez créé un autre.
Celui défini pour ce login.
Une adresse du domaine d’envoi, pour que le DNS configuré s’en porte garant.
Enregistrez, puis utilisez Envoyer un email de test. Sur un domaine bac à sable, envoyez-le d’abord vers une adresse autorisée, sinon Mailgun le déclinera, par conception.
3 · Pièges
Deux de ces trois pièges produisent le même symptôme, une connexion refusée : voilà pourquoi les problèmes Mailgun passent pour des fautes de frappe de mot de passe.
Les identifiants appartiennent à un domaine, et le domaine à une région. Un domaine créé en région EU ne s’authentifie que contre smtp.eu.mailgun.org ; l’hôte américain du preset le refusera à chaque fois, avec une erreur impossible à distinguer d’un mauvais mot de passe. Si l’authentification échoue et que vous êtes en Europe, vérifiez la région avant toute autre chose.
Le domaine bac à sable d’un nouveau compte n’envoie qu’aux adresses explicitement autorisées, cinq au maximum, chacune devant d’abord accepter une invitation. Il existe pour prouver que votre intégration fonctionne. Le trafic réel, vers des clients qui n’ont rien demandé, exige votre propre domaine vérifié, et les domaines personnalisés relèvent des offres payantes.
Se connecter au tableau de bord avec votre email n’en fait pas un identifiant SMTP. Si le champ identifiant contient votre email de compte au lieu de postmaster@votredomaine.com, ou le champ mot de passe celui du tableau de bord, Mailgun refuse la connexion. Les deux valeurs sortent de l’onglet SMTP credentials du domaine, de nulle part ailleurs.
Le journal d'emails conserve le message d'erreur exact renvoyé par le serveur : c'est le chemin le plus court vers la cause. La documentation passe en revue les plus fréquentes.
Chacun des douze presets a son guide, de Gmail à Amazon SES, et le plugin accepte aussi n'importe quel autre serveur SMTP.