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

Budete potřebovat účet u SendGridu (Twilio SendGrid) a přístup k DNS vaší domény.

Vlastní dokumentace SendGridu: Ověření odesílatele · Klíče API · Zaregistrovat se

1. Ověřte svou doménu

Nastavení (Settings) → Ověření odesílatele (Sender Authentication) → Ověřit vaši doménu (Authenticate Your Domain).

Vyberte svého poskytovatele DNS ze seznamu a odpovězte Ano (Yes) na otázku „Přejete si také opatřit vlastní značkou odkazy pro tuto doménu?“ („Would you like to also brand the links for this domain?“) — přejmenování odkazů přepisuje sledované odkazy na vaši vlastní doménu namísto sendgrid.net a klient, který umístí kurzor myši na odkaz ve vaší faktuře, by měl vidět vaše jméno.

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

2. Publikujte záznamy CNAME

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

| Typ | Hostitel | Účel | | --- | --- | --- | | CNAME | em1234.vasedomena.cz | Doména pro návratovou cestu (odraz) | | CNAME | s1._domainkey.vasedomena.cz | Klíč DKIM 1 | | CNAME | s2._domainkey.vasedomena.cz | Klíč DKIM 2 |

⭐ SendGrid používá záznamy CNAME namísto záznamů TXT záměrně a je to prokazatelně lepší: skutečné hodnoty klíčů jsou uloženy v SendGridu, takže mohou své podpisové klíče obměňovat, aniž byste museli znovu upravovat své DNS.

⚠️ Pokud je vaším poskytovatelem DNS Cloudflare, nastavte tyto záznamy na Pouze DNS (DNS only) (šedý mrak), nikoliv jako proxy. Záznam CNAME s použitím proxy se překládá na adresy Cloudflare a kontrola ze strany SendGridu selže.

Stiskněte tlačítko Ověřit (Verify) v rozhraní SendGrid. Vyčkejte až hodinu.

3. Vytvořte klíč API

Nastavení (Settings) → Klíče API (API Keys) → Vytvořit klíč API (Create API Key).

Zvolte Omezený přístup (Restricted Access) a udělte oprávnění pouze pro položku Odesílání pošty -> Úplný přístup (Mail Send → Full Access). Nic jiného.

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

⚠️ Klíč se zobrazí pouze jednou. Zkopírujte si jej před opuštěním stránky – SendGrid vám jej nemůže zobrazit znovu, může jej pouze nahradit.

4. Propojte jej v Zinn®

Otevřete položku Odesílání e-mailů (Email sending) ve svém přehledu:

Poskytovatel (Provider) — SendGrid
Odesílat z této domény (Send from this domain) — mail.vasedomena.cz (doména, nikoliv adresa)
Klíč API SendGrid (SendGrid API key) — klíč z kroku 3

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

5. Odešlete test a zadejte kód

Stiskněte Odeslat testovací zprávu (Send test message) na schránku v jiné doméně, přečtěte v ní kód a zadejte jej.

Když to nefunguje

403 Forbidden – váš klíč API nemá oprávnění k odesílání pošty (Mail Send). Toto je s odstupem nejčastější selhání: klíč s omezeným přístupem vytvořený bez zaškrtnutých rozsahů se sice ověří naprosto bezchybně, ale nemá povoleno provádět vůbec nic.

„Adresa odesílatele neodpovídá ověřené identitě odesílatele“ („The from address does not match a verified Sender Identity“) – ověření vaší domény ještě nepřejalo zelený stav nebo doména v poli Odesílat z této domény (Send from this domain) není tou, kterou jste ověřili. SendGrid kontroluje přesnou doménu: ověření mail.vasedomena.cz neopravňuje k odesílání z vasedomena.cz.

Přijato, ale nikdy doručeno (Accepted but never delivered) – podívejte se do sekce Aktivita (Activity) v SendGridu. Zbrusu nový účet je někdy první den či dva pozastaven kvůli kontrole a zprávy místo vracení zůstávají uloženy tam.

Váš účet byl po několika odesláních pozastaven (Your account was suspended after a few sends) – SendGrid je přísný ohledně nových účtů odesílajících na adresy, které se vracejí jako nedoručitelné. Než přejdete na novou službu, ujistěte se, že máte čistý seznam klientů.