Wysyłaj wiadomości e-mail za pośrednictwem własnego konta SendGrid

Będą Państwo potrzebować konta SendGrid (Twilio SendGrid) oraz dostępu do strefy DNS swojej domeny.

Własna dokumentacja SendGrid: Sender authentication · API keys · Sign up

1. Uwierzytelnienie domeny

Settings → Sender Authentication → Authenticate Your Domain.

Proszę wybrać swojego dostawcę DNS z listy i zaznaczyć Yes przy pytaniu „Would you like to also brand the links for this domain?” — branding linków podmienia śledzone adresy na Państwa własną domenę zamiast sendgrid.net, a klient po najechaniu kursorem na link w fakturze powinien widzieć Państwa nazwę.

Jako domenę nadawczą należy wpisać subdomenę, na przykład mail.yourdomain.com.

2. Publikacja rekordów CNAME

SendGrid wygeneruje trzy lub pięć rekordów CNAME. Należy dodać je wszystkie.

⭐ SendGrid celowo używa rekordów CNAME zamiast TXT, co jest znacznie lepszym rozwiązaniem: właściwe wartości kluczy znajdują się po stronie SendGrid, dzięki czemu dostawca może dokonywać rotacji kluczy podpisujących bez konieczności jakiejkolwiek ingerencji w Państwa DNS.

⚠️ Jeśli dostawcą DNS jest Cloudflare, rekordy te należy ustawić jako DNS only (szara chmurka), a nie jako proxy. Rekord CNAME z włączonym proxy wskazuje na adresy Cloudflare, przez co weryfikacja SendGrid kończy się niepowodzeniem.

Proszę kliknąć Verify w panelu SendGrid. Weryfikacja może zająć do godziny.

3. Utworzenie klucza API

Settings → API Keys → Create API Key.

Proszę wybrać opcję Restricted Access i przyznać wyłącznie uprawnienie Mail Send → Full Access. Nic więcej.

⛔ Nie należy używać klucza Full Access. Klucz z pełnym dostępem umożliwia odczyt kontaktów, zmianę ustawień konta i tworzenie kolejnych kluczy; my potrzebujemy wyłącznie wysyłać wiadomości. W przypadku ewentualnego wycieku naszej kopii Państwa klucza, różnica między tymi dwoma typami uprawnień to różnica między kilkoma niechcianymi wiadomościami e-mail a przejęciem całego konta.

⚠️ Klucz jest wyświetlany tylko raz. Proszę skopiować go przed opuszczeniem strony — SendGrid nie ma możliwości ponownego go wyświetlić, a jedynie zastąpić nowym.

4. Połączenie w Zinn®

Proszę otworzyć sekcję Wysyłka e-mail w panelu:

• Dostawca — SendGrid
• Wysyłaj z tej domeny — mail.yourdomain.com (domena, nie adres e-mail)
• Klucz API SendGrid — klucz z kroku 3

SendGrid nie wymaga żadnych innych ustawień.

5. Wysłanie wiadomości testowej i wprowadzenie kodu

Proszę kliknąć Wyślij wiadomość testową na skrzynkę pocztową w innej domenie, odczytać z niej kod i go wprowadzić.

Rozwiązywanie problemów

403 Forbidden — klucz API nie posiada uprawnienia Mail Send. Jest to zdecydowanie najczęstszy błąd: klucz Restricted Access utworzony bez zaznaczenia żadnych uprawnień uwierzytelnia się poprawnie, lecz nie zezwala na żadne działania.

„The from address does not match a verified Sender Identity” — uwierzytelnienie domeny nie zostało jeszcze potwierdzone lub domena w polu Wysyłaj z tej domeny nie jest tą, którą uwierzytelniono. SendGrid weryfikuje dokładną domenę: uwierzytelnienie mail.yourdomain.com nie zezwala na wysyłkę z domeny yourdomain.com.

Zaakceptowano, lecz nigdy nie dostarczono — proszę sprawdzić zakładkę Activity w panelu SendGrid. Zupełnie nowe konto bywa czasami wstrzymywane do weryfikacji przez pierwszy dzień lub dwa, przez co wiadomości oczekują w kolejce, zamiast zostać odrzucone.

Konto zostało zawieszone po kilku wysyłkach — SendGrid rygorystycznie podchodzi do nowych kont wysyłających wiadomości na odbijające adresy. Przed przełączeniem należy upewnić się, że lista klientów jest zweryfikowana i aktualna.