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

Budete potřebovat účet u služby Mailgun a přístup k DNS vaší domény.

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

1. Přidání odesílající domény do služby Mailgun

Na řídicím panelu služby Mailgun přejděte na Send → Domains → Add New Domain (Odesílání → Domény → Přidat novou doménu) a zadejte subdoménu, například mail.vasedomena.com.

⚠️ Vlastní doporučení služby Mailgun hovoří o subdoméně a zde to hraje větší roli než u některých jiných poskytovatelů: Mailgun nastavuje vlastní záznamy SPF a DKIM pro cokoli, co mu zadáte, a nasměrování na kořenovou doménu znamená, že tyto záznamy budou vedle záznamů, na nichž závisí vaše firemní schránky.

Zvolte region, který odpovídá místu, kde mají být vaše data uložena – US nebo EU. Poznamenejte si jej; budete jej potřebovat v kroku 4 a je to vůbec nejčastější věc, kterou lze udělat špatně.

2. Zveřejnění záznamů DNS poskytnutých službou Mailgun

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

| Typ | Hostitel | Účel | | --- | --- | --- | | TXT | mail.vasedomena.com | SPF – v=spf1 include:mailgun.org ~all | | TXT | mailo._domainkey.mail.vasedomena.com | Veřejný klíč DKIM | | CNAME | email.mail.vasedomena.com | Sledování a zpracování nedoručených zpráv | | MX | mail.vasedomena.com | Příjem nedoručených zpráv (oba hostitelé MX služby Mailgun) |

⛔ Pokud vaše odesílající subdoména již záznam SPF má, upravte jej – nepřidávejte druhý. Doména se dvěma záznamy SPF TXT SPF zcela selže, což je horší než nemít žádný.

Poté ve službě Mailgun stiskněte Verify DNS Settings (Ověřit nastavení DNS). Může trvat až hodinu, než se zobrazí zeleně.

⭐ Přidejte záznamy MX, přestože pouze odesíláte. Slouží službě Mailgun ke sběru nedoručených zpráv. Bez nich se neplatná adresa vrátí do prázdna, Mailgun ji nemůže potlačit a vy budete dál platit za odesílání na adresu, která nikdy nic nepřijme.

3. Získání klíče API

Send → Sending → Domain settings → API keys (Odesílání → Odesílání → Nastavení domény → Klíče API) nebo stránka API Keys (Klíče API) vašeho účtu.

Pokud váš tarif nějaký nabízí, použijte odesílací klíč s platností pro tuto doménu namísto soukromého klíče API vašeho účtu. Odesílací klíč může pouze odesílat; soukromý klíč může číst vaše protokoly a měnit váš účet. Nemáme žádný důvod uchovávat ten druhý.

4. Propojení ve službě Zinn®

Otevřete Odesílání e-mailů na svém řídicím panelu a vyplňte:

Poskytovatel — Mailgun
Odesílat z této domény — mail.vasedomena.com (doména, nikoli adresa)
Odesílající doména Mailgun — stejná doména, jakou jste přidali ve službě Mailgun
Region — us nebo eu, odpovídající kroku 1
Klíč API služby Mailgun — klíč z kroku 3

⛔⛔ Zvolte správný region. Účty Mailgun hostované v EU jsou obsluhovány ze zcela jiného hostitele API. Odeslání klíče účtu EU hostiteli US vrátí chybové hlášení "401 Unauthorized" (401 Neoprávněno), což vypadá přesně jako chybný klíč. Pokud je váš klíč zcela jistě správný a dostáváte hlášení 401, je to téměř vždy tento důvod.

5. Odeslání testu a zadání kódu

Stiskněte Send test message (Odeslat zkušební zprávu) pomocí schránky na jiné doméně – ideální je adresa Gmail. Přečtěte si kód v dané schránce a zadejte jej. Vaše pošta se okamžitě přepne.

Když to nefunguje

401 Unauthorized (401 Neoprávněno) – nesprávný region (viz výše) nebo jste vložili klíč z jiného účtu Mailgun. Klíč raději vygenerujte znovu, než abyste jej přepisovali; úvodní část key- se snadno přehlédne.

Zkušební zpráva nikdy nepřijde – zkontrolujte stránku Logs (Protokoly) ve službě Mailgun. Pokud o ní Mailgun nemá vůbec žádný záznam, přihlašovací údaje nebo název domény jsou nesprávné. Pokud ji Mailgun přijal a následně selhala, důvod bude uveden prostými slovy a je to téměř vždy DNS.

„Doména nebyla nalezena“ – pole Mailgun sending domain (Odesílající doména Mailgun) musí být přesně taková doména, jakou uvádí Mailgun, včetně subdomény. vasedomena.com a mail.vasedomena.com jsou pro Mailgun dvě různé domény.

Fungovalo to a pak to přestalo – zkontrolujte, zda neskončila vaše bezplatná zkušební verze. Zkušební účty Mailgun mohou odesílat zprávy pouze autorizovaným příjemcům, takže zkušební zpráva na vaši vlastní adresu funguje dál, zatímco všechno ostatní pro vaše klienty tiše nefunguje.