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

Budete potřebovat účet u služby SendGrid (Twilio SendGrid) a přístup k DNS své domény.

Vlastní dokumentace služby SendGrid: Ověření odesílatele · Klíče API · Registrace

1. Ověřte svou doménu

Settings → Sender Authentication → Authenticate Your Domain.

Vyberte svého poskytovatele DNS ze seznamu a na otázku „Would you like to also brand the links for this domain?“ odpovězte Yes — branding odkazů přepisuje sledované odkazy na vaši vlastní doménu namísto sendgrid.net, a klient, který najede myší na odkaz ve vaší faktuře, by měl vidět vaše jméno.

Až budete vyzváni k zadání domény, ze které odesíláte, zadejte subdoménu, například mail.vasedomena.cz.

2. Zveřejněte záznamy CNAME

SendGrid vám vygeneruje tři nebo pět záznamů CNAME. Přidejte je všechny.

⭐ SendGrid používá záznamy CNAME namísto TXT záznamů záměrně, a je to skutečně lepší řešení: samotné hodnoty klíčů se nacházejí u služby SendGrid, takže mohou své podpisové klíče obměňovat, aniž byste museli znovu zasahovat do svých DNS záznamů.

⚠️ Pokud je vaším poskytovatelem DNS Cloudflare, nastavte tyto záznamy na DNS only (šedý mrak), nikoli proxied. Záznam CNAME s povolenou proxy směřuje na adresy Cloudflare a ověření služby SendGrid selže.

Klikněte na Verify v rozhraní SendGrid. Vyčkejte až hodinu.

3. Vytvořte klíč API

Settings → API Keys → Create API Key.

Zvolte Restricted Access a udělte pouze oprávnění Mail Send → Full Access. Nic jiného.

⛔ Nepoužívejte klíč typu Full Access. Klíč s úplným přístupem (Full Access) může číst vaše kontakty, měnit nastavení vašeho účtu a vytvářet další klíče; jediné, co potřebujeme dělat, je odesílat zprávy. Pokud by byla naše kopie vašeho klíče někdy kompromitována, rozdíl mezi těmito dvěma klíči představuje rozdíl mezi několika nevyžádanými e-maily a napadeným účtem.

⚠️ Klíč se zobrazí pouze jednou. Zkopírujte si jej před opuštěním stránky — SendGrid vám jej již znovu nezobrazí, lze jej pouze nahradit.

4. Propojte jej v Zinn®

V administračním rozhraní otevřete sekci Odesílání e-mailů:

• Poskytovatel — SendGrid
• Odesílat z této domény — mail.vasedomena.cz (doména, nikoli adresa)
• SendGrid API klíč — klíč z kroku 3

SendGrid od vás žádná další nastavení nevyžaduje.

5. Odešlete testovací zprávu a zadejte kód

Klikněte na Odeslat testovací zprávu do schránky na jiné doméně, přečtěte si z ní kód a zadejte jej.

Když to nefunguje

403 Forbidden — váš klíč API nemá oprávnění Mail Send. Toto je zdaleka nejčastější chyba: klíč s omezeným přístupem (Restricted Access) vytvořený bez zaškrtnutí jakýchkoli rozsahů oprávnění se ověří zcela v pořádku, ale nemá povoleno provádět vůbec nic.

„The from address does not match a verified Sender Identity“ — ověření vaší domény ještě nebylo úspěšně dokončeno, nebo doména v poli Odesílat z této domény neodpovídá doméně, kterou jste ověřili. SendGrid kontroluje přesnou doménu: ověření mail.vasedomena.cz neopravňuje k odesílání z domény vasedomena.cz.

Přijato, ale nikdy nedoručeno — podívejte se do sekce Activity v rozhraní SendGrid. Zcela nový účet je někdy během prvního dne podroben kontrole a zprávy tam zůstávají pozastaveny, místo aby se vrátily jako nedoručitelné.

Váš účet byl po několika odesláních pozastaven — SendGrid přísně postihuje, pokud nové účty odesílají zprávy na adresy, ze kterých se e-maily vracejí jako nedoručitelné. Než systém přepnete do ostrého provozu, ujistěte se, že je váš seznam klientů vyčištěný.