Odesílejte e-maily prostřednictvím vlastního účtu Mailgun

Budete potřebovat účet Mailgun a přístup k DNS své domény.

Vlastní dokumentace Mailgun: Přidání a ověření domény · Klíče API · Registrace

1. Přidejte svou odesílací doménu do Mailgun

V ovládacím panelu Mailgun přejděte na Send → Domains → Add New Domain a zadejte subdoménu, například mail.vasedomena.cz.

⚠️ Vlastní doporučení Mailgun je subdoména a záleží na tom více než u některých jiných poskytovatelů: Mailgun nastavuje své vlastní záznamy SPF a DKIM pro cokoli, co zadáte, a nasměrování na vaši kořenovou doménu znamená, že tyto záznamy budou existovat vedle těch, na kterých závisí vaše firemní poštovní schránky.

Zvolte oblast, která odpovídá místu, kde chcete uchovávat svá data — US nebo EU. Poznamenejte si ji; budete ji potřebovat v kroku 4 a jde o vůbec nejčastější chybu.

2. Publikujte záznamy DNS, které vám Mailgun poskytne

Mailgun vám zobrazí seznam. Přidejte každý z nich u svého poskytovatele DNS.

⛔ Pokud vaše odesílací subdoména již záznam SPF má, upravte jej — nepřidávejte druhý. Doména se dvěma záznamy TXT pro SPF při kontrole SPF zcela selže, což je horší, než kdyby neměla žádný.

Poté stiskněte Verify DNS Settings v Mailgun. Může trvat až hodinu, než se stav změní na zelený.

⭐ Přidejte záznamy MX, i když pouze odesíláte. Pomocí nich Mailgun shromažďuje nedoručené zprávy. Bez nich se zpráva zaslaná na neplatnou adresu odrazí nikam, Mailgun ji nemůže potlačit a vy budete i nadále platit za odesílání na adresu, která nikdy nic nepřijme.

3. Získejte klíč API

Send → Sending → Domain settings → API keys, nebo stránka API Keys vašeho účtu.

Pokud to váš tarif nabízí, použijte raději odesílací klíč (sending key) určený pro tuto doménu než privátní klíč API vašeho účtu. Odesílací klíč může pouze odesílat; privátní klíč může číst vaše protokoly a měnit váš účet. Není žádný důvod, abychom měli k dispozici ten druhý.

4. Propojte jej v Zinn®

Otevřete Email sending ve svém ovládacím panelu a vyplňte:

• Provider — Mailgun
• Send from this domain — mail.yourdomain.com (doména, nikoli adresa)
• Mailgun sending domain — stejná doména, jakou jste přidali do Mailgun
• Region — us nebo eu, odpovídající kroku 1
• Mailgun API key — klíč z kroku 3

⛔⛔ Zvolte správnou oblast. Účty Mailgun hostované v EU jsou obsluhovány ze zcela jiného hostitele API. Odeslání klíče účtu v EU hostiteli v US vrátí chybu „401 Unauthorized“ — což vypadá přesně jako nesprávný klíč. Pokud je váš klíč zcela jistě správný a zobrazuje se vám chyba 401, téměř vždy je to z tohoto důvodu.

5. Odešlete test a zadejte kód

Stiskněte Send test message a použijte doručenou poštu na jiné doméně — ideální je adresa na Gmailu. Přečtěte si kód z této schránky a zadejte jej. Vaše pošta se okamžitě přepne.

Když to nefunguje

401 Unauthorized — nesprávná oblast (viz výše), nebo jste vložili klíč z jiného účtu Mailgun. Klíč raději vygenerujte znovu, než abyste jej přepisovali; počáteční část key- lze snadno ztratit.

Testovací zpráva nikdy nedorazí — zkontrolujte stránku Logs v Mailgun. Pokud o ní Mailgun nemá vůbec žádný záznam, jsou přihlašovací údaje nebo název domény nesprávné. Pokud ji Mailgun přijal a selhala až poté, důvod tam bude jasně popsán a téměř vždy jde o DNS.

„Domain not found“ — pole Mailgun sending domain musí obsahovat přesně takovou doménu, jakou Mailgun uvádí, včetně subdomény. yourdomain.com a mail.yourdomain.com jsou pro Mailgun dvě různé domény.

Fungovalo to a pak přestalo — zkontrolujte, zda vám neskončilo zkušební období. Zkušební účty Mailgun mohou odesílat pouze autorizovaným příjemcům, takže testovací zpráva na vaši vlastní adresu bude stále fungovat, zatímco vše ostatní pro vaše klienty v tichosti selže.