Resend krok po kroku: klucz API, weryfikacja domeny i pierwszy mail z aplikacji

👁 115 przeczytań

Resend to usługa do wysyłania maili z aplikacji: rejestracji, resetu hasła, potwierdzeń zamówień, powiadomień. Pierwszego maila wyślesz w pięć minut, a najwięcej czasu zajmuje nie kod, tylko weryfikacja domeny. Ten samouczek prowadzi przez całość według oficjalnej dokumentacji Resend.

Zanim zaczniesz: dostęp do DNS

Najczęstszą blokadą przy starcie z Resend nie jest kod, tylko brak dostępu do ustawień DNS domeny. Zanim zaczniesz, sprawdź, gdzie jest zarządzana domena i czy masz tam uprawnienia do dodawania rekordów. Jeśli domeną opiekuje się ktoś inny, na przykład agencja albo dział IT, poproś o dostęp albo przygotuj się na przekazanie im listy rekordów z panelu Resend.

Ustal też od razu, z jakiego adresu będą wychodzić maile, na przykład powiadomienia@ na subdomenie wysyłkowej.

Krok 1. Klucz API

Po założeniu konta tworzysz klucz API w panelu. Klucz zapisujesz w zmiennej środowiskowej na serwerze, na przykład w pliku z ustawieniami aplikacji, a nie w kodzie. Dokumentacja i poradniki mocno to podkreślają: klucz w kodzie przeglądarki jest publiczny, a każdy, kto go odczyta, może wysyłać maile w imieniu Twojej domeny.

Krok 2. Biblioteka i pierwszy mail

Instalujesz oficjalną bibliotekę dla swojego języka, na przykład dla Node.js przez npm. Pierwszy mail wysyłasz jednym wywołaniem z nadawcą, odbiorcą, tematem i treścią HTML. Do testów możesz wysyłać z adresu testowego Resend, bez konfigurowania domeny.

Tu jest pułapka, na którą trafia wiele osób: z adresu testowego mail dojdzie tylko na adres Twojego konta. Wysyłka do kogokolwiek innego przed weryfikacją domeny kończy się błędem, który pierwszego dnia wygląda zagadkowo.

Krok 3. Weryfikacja domeny

Żeby wysyłać z własnego adresu, dodajesz domenę w panelu Resend. W zakładce z rekordami dostajesz wpisy do dodania u dostawcy DNS: rekordy SPF i DKIM oraz rekord odpowiedzi zwrotnej. Kopiuj je dokładnie, najlepiej przez kopiuj-wklej, bo jedna literówka blokuje weryfikację.

Trzy praktyczne uwagi z dokumentacji:

• Resend poleca osobną subdomenę do wysyłki, na przykład send, zamiast głównej domeny,
• przy Cloudflare wyłącz pośrednictwo dla rekordów CNAME, bo inaczej weryfikacja się nie zakończy,
• propagacja może potrwać do doby, a ostrzeżenia o brakujących rekordach w tym czasie są normalne.

DMARC nie jest wymagany do weryfikacji, ale warto go dodać, bo poprawia wiarygodność Twoich maili.

Krok 4. Szablony w React Email

Resend stworzył ten sam zespół, który stworzył React Email, więc to zalecany sposób budowania szablonów. Mail piszesz jak komponent, z parametrami, na przykład imieniem klienta i nazwą produktu, i przekazujesz go w wywołaniu wysyłki. Resend sam zamienia go na HTML.

Krok 5. Podgląd wysyłek

W panelu widzisz każdą wysłaną wiadomość i jej status: doręczona, odrzucona, oznaczona jako spam. Przy problemach z dostarczaniem to pierwsze miejsce, do którego zaglądasz. Doręczalność zależy też od konfiguracji domeny i zasad serwera odbiorcy, więc poprawne rekordy DNS to podstawa.

Przykład: mail powitalny w aplikacji

Aplikacja ma wysyłać mail powitalny po rejestracji. Tworzysz klucz, zapisujesz go w zmiennej na serwerze, testujesz wysyłkę z adresu testowego na własny adres. Dodajesz subdomenę send w panelu, wklejasz rekordy u dostawcy DNS i czekasz na weryfikację. Szablon powitalny piszesz w React Email z imieniem użytkownika i linkiem do pierwszych kroków. Po weryfikacji zmieniasz nadawcę na własny adres.

W tym przykładzie ważna jest kolejność. Najpierw test z adresu testowego na własną skrzynkę, potem weryfikacja domeny, na końcu zmiana nadawcy. Dzięki temu możesz pisać i testować kod, zanim rekordy DNS się rozpropagują, a przełączenie na własny adres to jedna zmiana w konfiguracji. Warto też od razu wysłać mail powitalny na kilka różnych skrzynek i sprawdzić, czy wygląda dobrze także na telefonie.

Najczęstsze błędy

• Klucz API w kodzie przeglądarki.
• Testowanie wysyłki do innych osób przed weryfikacją domeny.
• Literówki w rekordach DNS.
• Włączone pośrednictwo Cloudflare dla rekordów weryfikacji.

Jak ocenić, czy wszystko działa

Po weryfikacji domeny wyślij testowe maile na kilka różnych skrzynek: Gmail, Outlook, skrzynkę firmową. Sprawdź, czy trafiają do odebranych, a nie do spamu, i czy wyglądają dobrze na telefonie. W panelu Resend zobaczysz status każdej wiadomości.

Przez pierwsze dni po wdrożeniu zaglądaj do panelu codziennie. Odrzucone maile i zgłoszenia spamu wyłapane wcześnie łatwo naprawić, a zignorowane psują reputację domeny.

Gdy podstawowe maile działają, warto dodać osobny szablon dla każdego rodzaju wiadomości, zamiast jednego uniwersalnego. Mail z resetem hasła i potwierdzenie zamówienia mają inne zadania, a osobne szablony łatwiej poprawiać i testować.

Roczny plan Resend Transactional Pro sprzedaję taniej niż w oficjalnym cenniku w sklepie kinetyka.pl.