Wyślij wiadomość e-mail za pośrednictwem własnego konta SendGrid

Będzie Pan potrzebował konta w SendGrid (Twilio SendGrid) oraz dostępu do DNS swojej domeny.

Własna dokumentacja SendGrid: Uwierzytelnianie nadawcy · Klucze API · Zarejestruj się

1. Uwierzytelnienie domeny

Settings → Sender Authentication → Authenticate Your Domain.

Proszę wybrać swojego dostawcę DNS z listy i odpowiedzieć Tak na pytanie "Would you like to also brand the links for this domain?" — brandowanie linków zmienia adresy śledzone tak, aby wskazywały na Państwa domenę zamiast sendgrid.net, a klient najeżdżający kursorem na link w fakturze powinien widzieć Państwa nazwę.

Proszę wpisać subdomenę, taką jak mail.twojadomena.pl, po wyświetleniu prośby o podanie domeny, z której wysyłane są wiadomości.

2. Opublikowanie rekordów CNAME

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

| Typ | Host | Przeznaczenie | | --- | --- | --- | | CNAME | em1234.twojadomena.pl | Domena ścieżki zwrotnej (bounce) | | CNAME | s1._domainkey.twojadomena.pl | Klucz DKIM 1 | | CNAME | s2._domainkey.twojadomena.pl | Klucz DKIM 2 |

⭐ SendGrid celowo używa rekordów CNAME zamiast rekordów TXT i jest to rozwiązanie obiektywnie lepsze: rzeczywiste wartości kluczy znajdują się w SendGrid, dzięki czemu mogą oni obracać kluczami podpisującymi bez konieczności ponownego modyfikowania konfiguracji DNS przez Pana.

⚠️ Jeśli dostawcą DNS jest Cloudflare, proszę ustawić te rekordy jako tylko DNS (szara chmura), a nie przepuszczane przez proxy. Rekord CNAME przepuszczany przez proxy rozpoznaje adresy Cloudflare i weryfikacja SendGrid kończy się niepowodzeniem.

Proszę nacisnąć Verify w SendGrid. Należy odczekać do godziny.

3. Utworzenie klucza API

Settings → API Keys → Create API Key.

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

⛔ Nie należy używać klucza o pełnym dostępie (Full Access). Klucz z pełnym dostępem może odczytywać kontakty, zmieniać ustawienia konta i tworzyć kolejne klucze; jedyną rzeczą, którą musimy zrobić, jest wysłanie wiadomości. Jeśli nasza kopia Pańskiego klucza kiedykolwiek wycieknie, różnica między tymi dwoma kluczami to różnica między niechcianą wiadomością e-mail a skompromitowanym kontem.

⚠️ Klucz jest wyświetlany tylko raz. Należy go skopiować przed opuszczeniem strony — SendGrid nie może go ponownie pokazać, a jedynie zastąpić nowym.

4. Połączenie w Zinn®

Proszę otworzyć Wysyłkę e-mail w swoim panelu:

• Dostawca — SendGrid
• Wysyłaj z tej domeny — mail.twojadomena.pl (domena, a nie adres)
• Klucz API SendGrid — klucz z kroku 3

SendGrid nie wymaga od Pana żadnych innych ustawień.

5. Wysłanie testu i wpisanie kodu

Proszę nacisnąć Send test message na skrzynkę pocztową w innej domenie, odczytać z niej kod i go wprowadzić.

Gdy to nie działa

403 Forbidden — klucz API nie posiada uprawnienia Mail Send. To zdecydowanie najczęstsza awaria: klucz z ograniczonym dostępem utworzony bez zaznaczonych zakresów uwierzytelnia się idealnie i nie ma uprawnień do robienia czegokolwiek.

"The from address does not match a verified Sender Identity" — uwierzytelnienie domeny nie stało się jeszcze aktywne lub domena w polu Wysyłaj z tej domeny nie jest tą, która została uwierzytelniona. SendGrid sprawdza dokładną domenę: uwierzytelnienie mail.twojadomena.pl nie upoważnia do wysyłania wiadomości z twojadomena.pl.

Zaakceptowane, ale nigdy nie dostarczone — proszę sprawdzić Activity w SendGrid. Zupełnie nowe konto jest czasami wstrzymywane do weryfikacji przez pierwszy dzień lub dwa, a wiadomości zamiast odbijać się, pozostają w kolejce.

Konto zostało zawieszone po wysłaniu kilku wiadomości — SendGrid rygorystycznie podchodzi do nowych kont wysyłających wiadomości na adresy, które generują zwroty. Przed przełączeniem należy upewnić się, że lista klientów jest czysta.