U hebt een Mailgun-account nodig en toegang tot de DNS van uw domein.
Mailguns eigen documentatie: Adding and verifying a domain · API keys · Sign up
1. Voeg uw verzenddomein toe aan Mailgun
Ga in het Mailgun-dashboard naar Send → Domains → Add New Domain en voer een subdomein in, bijvoorbeeld mail.yourdomain.com.
⚠️ Mailguns eigen advies is een subdomein, en dat is hier belangrijker dan bij sommige providers: Mailgun stelt zijn eigen SPF- en DKIM-records in op wat u ook opgeeft, en door het naar uw rootdomein te laten verwijzen, komen die records naast de records te staan waarvan uw zakelijke mailboxen afhankelijk zijn.
Kies de regio die overeenkomt met waar u wilt dat uw gegevens worden opgeslagen — US of EU. Noteer dit; u hebt het nodig in stap 4, en dit is het meest voorkomende aspect waar men de mist in gaat.
2. Publiceer de DNS-records die Mailgun u verstrekt
Mailgun toont u een lijst. Voeg elk record toe bij uw DNS-provider.
| Type | Host | Doel |
|---|
TXT | mail.yourdomain.com | SPF — v=spf1 include:mailgun.org ~all |
TXT | mailo._domainkey.mail.yourdomain.com | DKIM-openbare sleutel |
CNAME | email.mail.yourdomain.com | Tracking en afhandeling van bounces |
MX | mail.yourdomain.com | Ontvangen van bounces (Mailguns twee MX-hosts) |
⛔ Als uw verzendsubdomein al een SPF-record heeft, bewerk dit dan — voeg geen tweede toe. Een domein met twee SPF TXT-records faalt SPF categorisch, wat erger is dan er helemaal geen hebben.
Druk vervolgens op Verify DNS Settings in Mailgun. Het kan tot een uur duren voordat dit groen kleurt.
⭐ Voeg de MX-records toe, ook al verzendt u alleen maar. Ze zijn de manier waarop Mailgun bounces verzamelt. Zonder deze records bounced een ongeldig adres naar het niets, kan Mailgun het niet onderdrukken en blijft u betalen om te verzenden naar een adres dat nooit iets zal ontvangen.
3. Vraag uw API-sleutel op
Send → Sending → Domain settings → API keys, of de pagina API Keys van uw account.
Gebruik een verzendsleutel die specifiek voor dit domein geldt als uw abonnement dit aanbiedt, in plaats van de persoonlijke API-sleutel van uw account. Een verzendsleutel kan alleen verzenden; de persoonlijke sleutel kan uw logbestanden inzien en uw account wijzigen. Er is voor ons geen enkele reden om die tweede te bewaren.
4. Koppel deze in Zinn®
Open E-mail verzenden in uw dashboard en vul in:
- Provider — Mailgun
- Verzenden vanaf dit domein —
mail.yourdomain.com (een domein, geen adres)
- Mailgun-verzenddomein — hetzelfde domein als u in Mailgun hebt toegevoegd
- Regio —
us of eu, overeenkomstig stap 1
- Mailgun API-sleutel — de sleutel uit stap 3
⛔⛔ Kies de juiste regio. In de EU gehoste Mailgun-accounts worden bediend vanaf een geheel andere API-host. Het verzenden van een sleutel van een EU-account naar de US-host retourneert "401 Unauthorized" — wat precies lijkt op een onjuiste sleutel. Als uw sleutel met zekerheid correct is en u ontvangt een 401, dan is dit bijna altijd de oorzaak.
5. Verzend de test en voer de code in
Druk op Testbericht verzenden en gebruik daarbij een inbox op een ander domein — een Gmail-adres is ideaal. Lees de code af uit die inbox en voer deze in. Uw e-mail wordt direct overgezet.
Wanneer het niet werkt
401 Unauthorized — verkeerde regio (zie hierboven), of u hebt een sleutel van een ander Mailgun-account geplakt. Genereer de sleutel opnieuw in plaats van deze over te typen; het voorvoegsel key- raakt gemakkelijk verloren.
Het testbericht komt nooit aan — controleer de pagina Logs van Mailgun. Als Mailgun er helemaal geen registratie van heeft, is de inloggegeven of de domeinnaam onjuist. Als Mailgun het heeft geaccepteerd en het daarna is mislukt, zal de reden daar in duidelijke woorden staan, en dit ligt bijna altijd aan DNS.
"Domain not found" — het veld Mailgun-verzenddomein moet exact het domein zijn zoals Mailgun het weergeeft, inclusief het subdomein. yourdomain.com en mail.yourdomain.com zijn voor Mailgun twee verschillende domeinen.
Het werkte en stopte er vervolgens mee — controleer of uw gratis proefperiode is afgelopen. Proefaccounts van Mailgun kunnen alleen verzenden naar geautoriseerde ontvangers, waardoor het testbericht naar uw eigen adres blijft werken terwijl alles naar uw klanten stilletjes mislukt.