E-maile: szablony i wysyłka z własnej domeny
Maile transakcyjne są domyślnie obsługiwane przez webhooki. Supabase Auth pozostaje kanałem logowania. Zobacz Maile do kupujących.
Maile logowania Sellfa wysyła Supabase Auth. Skonfiguruj wysyłkę w Supabase, również wtedy, gdy nie możesz jeszcze zalogować się do sklepu.
1. Dlaczego własne SMTP?
Dział zatytułowany „1. Dlaczego własne SMTP?”Wbudowana wysyłka Supabase służy do testów. Nadawcą jest Supabase, a nie Twój sklep. Nie ma gwarancji dostarczenia; wiadomość może trafić do spamu. Obecnie usługa wysyła tylko na adresy członków zespołu organizacji projektu, z limitem 2 wiadomości na godzinę. Nie nadaje się do obsługi klientów. Zobacz instrukcję SMTP Supabase.
Własne SMTP pozwala wysyłać klientom linki logowania z Twojej domeny. Potrzebujesz adresu sklepu, dostępu do DNS domeny i danych SMTP od dostawcy poczty.
2. Skonfiguruj SMTP w Supabase
Dział zatytułowany „2. Skonfiguruj SMTP w Supabase”Supabase Cloud
Dział zatytułowany „Supabase Cloud”- Otwórz projekt w dashboardzie Supabase.
- Przejdź do Authentication → Emails → SMTP Settings i włącz Enable custom SMTP.
- Wypełnij pola danymi otrzymanymi od dostawcy.
- Kliknij Save changes.
| Pole w dashboardzie | Co wpisać |
|---|---|
| Host | Nazwę serwera SMTP dostawcy |
| Port number | Port wskazany przez dostawcę |
| Username | Nazwę użytkownika SMTP |
| Password | Hasło SMTP lub sekret wymagany przez dostawcę do połączenia SMTP |
| Sender email address | Adres w zweryfikowanej domenie, np. [email protected] |
| Sender name | Nazwę Twojego sklepu |
Sekrety wpisuj bezpośrednio w dashboardzie, nigdy na czacie z AI. Nazwy pól sprawdzono w formularzu SMTP Supabase, a ścieżkę menu w checkliście produkcyjnej.
Po włączeniu własnego SMTP początkowy limit wynosi 30 wiadomości na godzinę. Sprawdź Authentication → Rate Limits i dopasuj go do ruchu sklepu oraz limitów dostawcy. Formularz SMTP ma też pole Minimum interval per user; domyślny odstęp między linkami Supabase dla tej samej osoby to 60 sekund. Sellf stosuje dodatkowe limity żądań, więc nie wysyłaj wielu próśb testowych pod rząd. Zobacz limity Auth.
Gdy limit zablokuje link logowania po płatności albo mail z kluczem licencji darmowego produktu, Sellf zachowuje wiadomość i sam ponawia wysyłkę (po około 2, 5, 15, 30, 60 i 120 minutach) w procesie aplikacji; /api/cron?job=auth-mail-retry z Twoim CRON_SECRET uruchamia to samo z zewnętrznego harmonogramu. Strona płatności informuje kupującego, że link jest w drodze.
Supabase / GoTrue na własnym serwerze
Dział zatytułowany „Supabase / GoTrue na własnym serwerze”Ustaw te zmienne w usłudze Supabase Auth, nie w kontenerze Sellfa:
GOTRUE_SMTP_HOST=smtp.twoj-dostawca.exampleGOTRUE_SMTP_PORT=587GOTRUE_SMTP_USER=twoj-uzytkownik-smtpGOTRUE_SMTP_PASS=<ustaw prywatnie w swoim środowisku>GOTRUE_SMTP_ADMIN_EMAIL[email protected]GOTRUE_SMTP_SENDER_NAME=Twój sklepUżyj rzeczywistego hosta i portu dostawcy. Oficjalny stos Docker przyjmuje w .env zmienne SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, SMTP_ADMIN_EMAIL i SMTP_SENDER_NAME; Compose mapuje je na GOTRUE_SMTP_*. Sprawdź mapowanie w swoim stosie i odtwórz usługę Auth, aby wczytała zmiany. Źródła: konfiguracja Auth, mapowanie Docker Compose i wdrożenie pełnego stosu.
Włącz potwierdzanie adresów e-mail
Dział zatytułowany „Włącz potwierdzanie adresów e-mail”W Supabase Cloud otwórz Authentication → Sign In / Providers → Email, włącz Confirm Email i zapisz. Zakupy gościa trafiają na konto po potwierdzeniu adresu, którego użyto przy zakupie.
Dla lokalnego CLI ustaw enable_confirmations = true w sekcji [auth.email] pliku supabase/config.toml, następnie uruchom supabase stop i supabase start. Dla powiązanego projektu Cloud przejrzyj konfigurację i zastosuj supabase config push --project-ref <project-ref>. supabase db push stosuje migracje bazy, nie konfigurację Auth. W Dockerze ustaw GOTRUE_MAILER_AUTOCONFIRM=false i odtwórz usługę Auth.
Wgraj oba szablony Sellfa: Confirm sign up (confirmation.html, type=signup) i Magic link (magic-link.html, type=magiclink). Nowy adres logujący się magic linkiem otrzymuje szablon confirmation. Oba linki muszą prowadzić przez /auth/callback z RedirectTo, TokenHash i właściwym type. Przetestuj nowy adres: przed kliknięciem linku brak dostępu do zakupów gościa, po kliknięciu zakupy pojawiają się na koncie. Rejestracja hasłem również wymaga linku; Google/GitHub potwierdzają adres w swoim procesie logowania.
3. Wybierz dostawcę poczty
Dział zatytułowany „3. Wybierz dostawcę poczty”Szukaj poczty transakcyjnej przez SMTP, weryfikacji domeny z DKIM, logów dostarczenia i odbić oraz limitów odpowiednich dla sklepu. Jeśli potrzebujesz przetwarzania w UE, sprawdź dostępne regiony i warunki przetwarzania danych przed wyborem.
Możesz rozważyć Resend, Postmark, Brevo, Amazon SES, Mailgun lub własny serwer pocztowy. Supabase podaje przykłady zgodnych usług; Mailgun dokumentuje wysyłkę SMTP i region UE. Własny serwer oznacza samodzielne dbanie o uwierzytelnienie, reputację i dostarczalność.
Wyłącz śledzenie kliknięć dla maili uwierzytelniających: może przepisywać linki logowania. Zobacz checklistę Supabase.
4. Zweryfikuj domenę nadawcy w DNS
Dział zatytułowany „4. Zweryfikuj domenę nadawcy w DNS”Dodaj domenę nadawcy u dostawcy poczty, a następnie skopiuj do panelu DNS dokładne nazwy, typy i wartości rekordów podane przez dostawcę.
| Ustawienie | Do czego służy |
|---|---|
| SPF | Wskazuje serwery uprawnione do wysyłania z domeny nadawcy kopertowego. |
| DKIM | Dodaje podpis wiadomości, który odbiorca sprawdza za pomocą klucza publicznego domeny. |
| DMARC | Określa raportowanie i postępowanie z mailami, które nie przechodzą uwierzytelnienia zgodnego z widoczną domeną From. |
| Return-path | Odbiera informacje o niedostarczonych wiadomościach; dostawca może używać osobnej subdomeny dla zgodności SPF. |
Rekordy SPF, DKIM i return-path otrzymasz od dostawcy; jego instrukcja DMARC pomoże wybrać politykę dla domeny. Nie zastępuj rekordów innych usług pocztowych i nie dodawaj drugiego SPF pod tą samą nazwą. Zacznij od monitorowania DMARC, jeśli nie sprawdziłeś wszystkich uprawnionych nadawców.
Poczekaj na propagację DNS, a potem użyj przycisku weryfikacji domeny u dostawcy. Pozytywna weryfikacja to pierwszy etap; rzeczywistą wiadomość sprawdzisz w kroku 7. Źródła: weryfikacja domeny, polityki DMARC i własny return-path.
5. Wgraj szablony Sellfa
Dział zatytułowany „5. Wgraj szablony Sellfa”Użyj plików HTML z supabase/templates/ w swojej kopii Sellfa. Tekst szablonów jest po polsku; możesz dostosować go do sklepu.
Dashboard
Dział zatytułowany „Dashboard”Otwórz Authentication → Emails → Templates (układ menu, dokumentacja Email Templates). Dla każdego szablonu wklej cały plik HTML do edytora treści, ustaw temat i zapisz.
| Plik | Szablon uwierzytelniania | Pole Management API |
|---|---|---|
magic-link.html |
Magic link | mailer_templates_magic_link_content |
confirmation.html |
Confirm sign up | mailer_templates_confirmation_content |
invite.html |
Invite user | mailer_templates_invite_content |
recovery.html |
Reset password | mailer_templates_recovery_content |
email-change.html |
Change email address | mailer_templates_email_change_content |
Management API
Dział zatytułowany „Management API”Alternatywę opisuje templates/README.md. Ustaw SUPABASE_ACCESS_TOKEN prywatnie w środowisku powłoki: to token dostępu Management API, nie klucz anon ani service-role projektu. Przed uruchomieniem zastąp {project_ref} i placeholder HTML:
curl -X PATCH "https://api.supabase.com/v1/projects/{project_ref}/config/auth" \ -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "mailer_templates_magic_link_content": "<treść magic-link.html zakodowana jako ciąg JSON>" }'Powtórz dla pól i plików z tabeli. Cudzysłowy i nowe linie HTML muszą być poprawnie zakodowane w JSON — użyj narzędzia kodującego JSON zamiast wklejać surowy HTML do ciągu znaków. Endpoint i pola potwierdza dokumentacja szablonów Supabase.
Adresy szablonów na własnym serwerze
Dział zatytułowany „Adresy szablonów na własnym serwerze”GoTrue pobiera szablony przez HTTP. Ustaw poniższe zmienne w usłudze Auth i sprawdź, czy może ona odczytać te adresy. Jeśli wpisujesz je do .env, dodaj również mapowanie do auth.environment w Compose; sam wpis w .env nie przekazuje nowej zmiennej do kontenera. Po zmianie odtwórz usługę Auth:
GOTRUE_MAILER_TEMPLATES_MAGIC_LINK=https://twoj-sklep.pl/auth-email-templates/magic-link.htmlGOTRUE_MAILER_TEMPLATES_CONFIRMATION=https://twoj-sklep.pl/auth-email-templates/confirmation.htmlGOTRUE_MAILER_TEMPLATES_INVITE=https://twoj-sklep.pl/auth-email-templates/invite.htmlGOTRUE_MAILER_TEMPLATES_RECOVERY=https://twoj-sklep.pl/auth-email-templates/recovery.htmlGOTRUE_MAILER_TEMPLATES_EMAIL_CHANGE=https://twoj-sklep.pl/auth-email-templates/email-change.htmlSellf udostępnia te pliki. Jeśli adres jest niedostępny lub szablon niepoprawny, GoTrue użyje szablonu domyślnego. Zobacz szablony self-hosted.
Bezpieczna zmiana wyglądu
Dział zatytułowany „Bezpieczna zmiana wyglądu”Możesz zmienić kolory, widoczny tekst, tematy i logo; dla nowego obrazka użyj pełnego adresu HTTPS. Zachowaj zmienne szablonów i linki uwierzytelniające dokładnie w dostarczonej postaci.
Szablony magic-link i confirmation Sellfa używają {{ .RedirectTo }} i {{ .TokenHash }}. Nie zmieniaj pisowni, wielkości liter, nawiasów, parametrów token_hash, type ani separatorów &. RedirectTo zawiera już ścieżkę callback i parametry przekazane przez Sellfa. Nie zastępuj go {{ .SiteURL }} ani domyślnym {{ .ConfirmationURL }}.
Dostarczone pliki invite, recovery i email-change obecnie używają {{ .ConfirmationURL }}. Te linki również zachowaj bez zmian; samo wgranie plików nie potwierdza działania tych osobnych procesów. Przetestuj każdy włączony proces, zanim zaczniesz na nim polegać. Supabase opisuje znaczenie zmiennych.
6. Ustaw adres sklepu i dozwolone przekierowania
Dział zatytułowany „6. Ustaw adres sklepu i dozwolone przekierowania”W Supabase Cloud otwórz Authentication → URL Configuration:
- Ustaw Site URL na publiczny adres sklepu, np.
https://twoj-sklep.pl. - Dodaj
https://twoj-sklep.pl/**w Redirect URLs i zapisz. - Ustaw zmienną środowiskową Sellfa
SITE_URLna ten sam adres.
Wpis na liście dopuszcza ścieżki callback i parametry generowane przez Sellfa. Dodaj każdą domenę sklepu, której faktycznie używasz; nie dopuszczaj dowolnych domen. Supabase wyjaśnia Site URL i działanie wildcardów.
Jeśli przekierowanie callback nie jest dozwolone, Supabase może użyć Site URL. Szablon Sellfa może wtedy wygenerować niepoprawny link, np.:
https://your-shop.com&token_hash=...Brakuje /auth/callback i początku parametrów zapytania. Najpierw sprawdź listę przekierowań, a potem poproś o nowy mail logowania.
Sellf ≥ 2026.10.3 buduje linki z SITE_URL w czasie działania aplikacji. Ustaw tę zmienną w uruchomionej instancji; gotowy release nie zna domeny Twojego sklepu. Nie zastępuje to ustawień Site URL i Redirect URLs w Supabase.
Dla Auth na własnym serwerze ustaw GOTRUE_SITE_URL=https://twoj-sklep.pl i GOTRUE_URI_ALLOW_LIST=https://twoj-sklep.pl/** (lub odpowiednie zmienne .env mapowane przez Twój stos). Zobacz konfigurację Auth.
7. Przetestuj logowanie od początku do końca
Dział zatytułowany „7. Przetestuj logowanie od początku do końca”- Otwórz
/loginw swoim sklepie i poproś o link na własną skrzynkę. - Sprawdź skrzynkę i spam: nazwa nadawcy i domena From powinny być Twoje.
- Sprawdź link prywatnie. Powinien prowadzić do
/auth/callbackw Twoim sklepie z parametramitoken_hashitype; nie udostępniaj aktywnego tokena. - Kliknij raz i potwierdź zalogowanie. Zwykłe logowanie kieruje administratorów do
/dashboard, a pozostałych użytkowników do/my-products. - Sprawdź log dostarczenia u dostawcy i wyniki SPF, DKIM oraz DMARC w nagłówkach wiadomości.
- Oceń spam score przy użyciu jednorazowego konta testowego i narzędzia takiego jak mail-tester. Mail logowania daje odbiorcy dostęp do konta, więc nigdy nie wysyłaj do zewnętrznego testera linku klienta ani administratora. Dobry wynik nie gwarantuje dotarcia do skrzynki odbiorczej.
Jeśli mail nie dociera, sprawdź weryfikację domeny i logi Supabase Auth. Jeśli link nie działa, sprawdź krok 6 oraz wgrany HTML. Pozostałe włączone procesy mailowe przetestuj osobno.
8. Skopiuj prompt dla agenta AI
Dział zatytułowany „8. Skopiuj prompt dla agenta AI”Użyj go w Claude Code, Codex lub ChatGPT z narzędziami:
Pomóż mi skonfigurować maile uwierzytelniające dla MOJEGO sklepu Sellf według https://docs.sellf.app/pl/email-setup/.
Najpierw zapytaj o adres sklepu, wersję Sellfa, identyfikator projektu Supabase (lub stos self-hosted), dostawcę poczty, dostawcę DNS, adres/nazwę nadawcy, oczekiwaną liczbę wiadomości i wymóg przetwarzania w UE. W razie potrzeby zapytaj o brakujące, niebędące sekretami dane: host, port i nazwę użytkownika SMTP.
Nigdy nie proś o wklejenie na czacie haseł, kluczy API, tokenów dostępu, kluczy service-role ani aktywnych linków logowania. Sekrety mam wpisywać bezpośrednio w dashboardzie lub prywatnych zmiennych środowiskowych. Używaj autoryzowanych narzędzi bez wypisywania sekretów; anonimizuj logi.
Sprawdź aktualną oficjalną dokumentację Supabase i dostawcy. Przeprowadź mnie przez wybór dostawcy, DNS (SPF, DKIM, DMARC, return-path), własne SMTP i limity. W Cloud użyj Authentication → Emails → SMTP Settings; w self-hosted podłącz GOTRUE_SMTP_* do usługi Auth.
Wgraj wszystkie pięć szablonów z mojej wersji Sellfa przez dashboard lub Management API albo ustaw adresy szablonów self-hosted. Zachowaj wszystkie dostarczone linki uwierzytelniające, szczególnie TokenHash i RedirectTo w magic-link/confirmation; zmieniaj tylko wygląd i widoczny tekst.
Ustaw Site URL w Supabase, dopuść https://DOMENA-MOJEGO-SKLEPU/** w Redirect URLs i sprawdź SITE_URL Sellfa (od ≥ 2026.10.3 odczytywany w czasie działania). Zdiagnozuj linki bez /auth/callback.
Przeprowadź rzeczywisty test logowania ze sklepu, sprawdzenie nadawcy/domeny i uwierzytelnienia DNS oraz test spam score na jednorazowym koncie. Pozostałe włączone procesy przetestuj osobno. Podaj zweryfikowane wyniki i to, co zostało nieprzetestowane; nie ogłaszaj sukcesu na podstawie samych ustawień.