Envoyer des e-mails via votre propre compte Mailgun

Vous aurez besoin d'un compte Mailgun et d'un accès au DNS de votre domaine.

Documentation officielle de Mailgun : Ajouter et vérifier un domaine · Clés API · S'inscrire

1. Ajoutez votre domaine d'envoi à Mailgun

Dans le tableau de bord de Mailgun, allez dans Send → Domains → Add New Domain et saisissez un sous-domaine, par exemple mail.votredomaine.com.

⚠️ Les consignes de Mailgun recommandent un sous-domaine, et cela importe encore plus ici qu'avec certains autres fournisseurs : Mailgun configure ses propres enregistrements SPF et DKIM sur ce que vous lui fournissez, et le pointer vers votre domaine racine signifie que ces enregistrements cohabiteront avec ceux sur lesquels reposent vos e-mails professionnels.

Choisissez la région correspondant à l'emplacement souhaité pour vos données — US ou EU. Notez-la ; vous en aurez besoin à l'étape 4, et c'est l'erreur la plus fréquente.

2. Publiez les enregistrements DNS fournis par Mailgun

Mailgun vous affiche une liste. Ajoutez-les tous auprès de votre fournisseur DNS.

| Type | Hôte | Objet | | --- | --- | --- | | TXT | mail.votredomaine.com | SPF — v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.votredomaine.com | Clé publique DKIM | | CNAME | email.mail.votredomaine.com | Suivi et gestion des retours (bounces) | | MX | mail.votredomaine.com | Réception des retours (les deux hôtes MX de Mailgun) |

⛔ Si votre sous-domaine d'envoi possède déjà un enregistrement SPF, modifiez-le — n'en ajoutez pas un second. Un domaine doté de deux enregistrements TXT SPF échoue systématiquement au contrôle SPF, ce qui est pire que de n'en avoir aucun.

Cliquez ensuite sur Verify DNS Settings dans Mailgun. Cela peut prendre jusqu'une heure pour passer au vert.

⭐ Ajoutez les enregistrements MX même si vous ne faites qu'envoyer des e-mails. C'est ainsi que Mailgun collecte les retours. Sans eux, une adresse erronée renvoie dans le vide, Mailgun ne peut pas l'exclure, et vous continuez à payer pour envoyer vers une adresse qui ne recevra jamais rien.

3. Obtenez votre clé API

Send → Sending → Domain settings → API keys, ou la page API Keys de votre compte.

Utilisez une clé d'envoi limitée à ce domaine si votre formule le propose, plutôt que la clé API privée de votre compte. Une clé d'envoi sert uniquement à envoyer ; la clé privée peut lire vos journaux (logs) et modifier votre compte. Il n'y a aucune raison pour que nous détenions la seconde.

4. Connectez-le dans Zinn®

Ouvrez Email sending dans votre tableau de bord et remplissez :

• Provider — Mailgun
• Send from this domain — mail.votredomaine.com (un domaine, pas une adresse)
• Mailgun sending domain — le même domaine que celui ajouté dans Mailgun
• Region — us ou eu, correspondant à l'étape 1
• Mailgun API key — la clé de l'étape 3

⛔⛔ Ne vous trompez pas de région. Les comptes Mailgun hébergés dans l'UE sont desservis par un hôte API totalement différent. Envoyer la clé d'un compte UE à l'hôte US renvoie l'erreur "401 Unauthorized" — ce qui ressemble exactement à une clé erronée. Si votre clé est manifestement correcte et que vous obtenez l'erreur 401, c'est presque toujours la raison.

5. Envoyez le test et saisissez le code

Cliquez sur Send test message, en utilisant une boîte de réception située sur un autre domaine — une adresse Gmail est idéale. Récupérez le code dans cette boîte de réception et saisissez-le. Vos e-mails basculent immédiatement.

En cas de dysfonctionnement

401 Unauthorized — mauvaise région (voir ci-dessus), ou vous avez collé une clé provenant d'un autre compte Mailgun. Régénérez la clé plutôt que de la retaper ; le préfixe key- est facile à omettre.

Le message de test n'arrive jamais — consultez la page Logs de Mailgun. Si Mailgun n'en garde aucune trace, les identifiants ou le nom de domaine sont erronés. Si Mailgun l'a accepté mais que l'envoi a échoué par la suite, la raison y figurera en clair, et il s'agit presque toujours du DNS.

"Domain not found" — le champ Mailgun sending domain doit correspondre exactement au domaine tel qu'il est listé par Mailgun, sous-domaine compris. votredomaine.com et mail.votredomaine.com constituent deux domaines distincts pour Mailgun.

Le service a fonctionné puis s'est arrêté — vérifiez si votre essai gratuit a pris fin. Les comptes d'essai Mailgun ne peuvent envoyer qu'à des destinataires autorisés, de sorte que le message de test envoyé à votre propre adresse continue de fonctionner tandis que tous les envois destinés à vos clients échouent silencieusement.