Resend
Wysyłka maili z aplikacji przez API Resend: weryfikacja domeny, szablony React Email i idempotentne wysyłki.
IntegracjeUżywam od 2023 · Wyróżniony projekt: Budzowska Fiutowski i Partnerzy
- Kategoria
- Integracje
- Używam od
- 2023
- Wyróżniony projekt
- Budzowska Fiutowski i Partnerzy
W praktyce
Resend wybieram do maili, które wysyła aplikacja: potwierdzeń i powiadomień z formularza. Na tej stronie, w ENATIV Portfolio, jedno zgłoszenie z formularza uruchamia dwa maile. Nie zaczynam od szablonu, tylko od domeny, z której mail wyjdzie.
Czym jest Resend?
Resend to usługa wysyłki maili z API, przeznaczona dla programistów. Maile dzielą się na transakcyjne, czyli spersonalizowane wiadomości wywołane zdarzeniem, i kampanie, czyli masowe wysyłki do listy kontaktów. Wysyłać można tylko z domeny, którą się posiada: trzeba ją dodać do konta i zweryfikować rekordami DNS, wśród nich DKIM i SPF. Najlepiej wysyłać z osobnej subdomeny, a nie z domeny głównej.
Z aplikacji korzystasz z SDK, na przykład dla Node.js, a treść maila możesz podać jako komponent React Email. Stan wysyłki śledzisz webhookami, które zgłaszają dostarczenie i odbicie wiadomości. Powtórzone żądanie wysyłki zabezpiecza klucz idempotentności: ten sam klucz w ciągu 24 godzin nie wyśle maila drugi raz. Całość mieści się w zwykłej trasie API aplikacji w Next.js, a szablony piszesz w Reakcie.
- Rodzaj
- API do wysyłki maili
- Szablony
- Komponenty React Email
Jak pracuję z Resend
Zaczynam od domeny i od pytania, co się stanie, gdy mail nie wyjdzie. Szablon piszę dopiero potem. Resend wiąże dostarczalność ze zweryfikowaną domeną, więc to ona decyduje, czy wiadomość ma szansę dojść.
Domena i rekordy DNS
Dodaję domenę, najlepiej subdomenę przeznaczoną do wysyłki, i przekazuję administratorowi DNS rekordy z panelu Resend, które trzeba skopiować co do znaku. Weryfikacja trwa zwykle kilkanaście minut, ale może zająć do 72 godzin, więc nie zostawiam jej na dzień premiery.
Szablony w repozytorium
Szablony piszę jako komponenty React Email i trzymam w repozytorium obok aplikacji, więc zmiana treści przechodzi review jak kod i nie wymaga logowania do panelu dostawcy. W ENATIV Portfolio jedna trasa wysyła z nich powiadomienie dla mnie po polsku i potwierdzenie dla odwiedzającego w jego języku.
Powtórzenia i klucz API
Każdą wysyłkę opatruję kluczem idempotentności, tak jak w trasie kontaktowej ENATIV Portfolio, żeby ponowione żądanie nie wysłało maila drugi raz. W zmiennej środowiskowej na serwerze trzymam klucz API. Webhooków na tej stronie nie używam. Gdy aplikacja ma reagować na odbity mail, podłączam webhook ze zdarzeniem odbicia.
Kiedy tak, a kiedy nie
Resend pasuje do aplikacji, które same decydują, kiedy wysłać mail, a jego treść składa się z danych użytkownika.
Sprawdza się, gdy
- Potwierdzenia i powiadomienia wysyłane po zdarzeniu w aplikacji, na przykład po zgłoszeniu z formularza.
- Projekt w React albo Next.js, w którym szablony mają leżeć w repozytorium obok kodu.
- Firma z własną domeną i kimś, kto doda do niej rekordy DNS.
- Zespół, który chce widzieć stan wysyłki w panelu zamiast w logach serwera.
Nie sprawdza się, gdy
- Zwykła korespondencja firmowa: to zadanie dla poczty, nie dla API.
- Firma, która nie ma domeny albo nie może zmienić jej DNS.
- Aplikacja bez backendu, w której nie ma gdzie schować klucza API.
Gdy firma ma już dostawcę maili z działającą, zweryfikowaną domeną, zostaję przy nim, bo zmiana oznacza ponowną weryfikację i nowe ustawienia. Samą wysyłkę osadzam w trasie API, a nie w przeglądarce.
Często zadawane pytania
Aplikacja ma wysyłać maile do użytkowników?
Napisz, jakie maile mają wychodzić, z jakiej domeny i kto zarządza jej DNS. Odpowiem, co trzeba ustawić przed startem i czy wystarczy Resend.