Przejdź do treści

Zatwierdzenia, Logi i wysyłka

Wysyłaj e-maile przez SMTP

Połącz Supabase Auth, WordPress lub dowolną aplikację SMTP z Banger, aby poczta wychodziła z twojej domeny i była widoczna w Logach.

5 min czytaniaZaktualizowano
W tym poradniku 8 sekcji

Przekaźnik SMTP Banger pozwala aplikacjom wysyłającym tylko przez SMTP, takim jak Supabase Auth, Auth0, WordPress lub moduł pocztowy frameworka, wysyłać przez Banger. Aplikacja loguje się kluczem API Banger, a każda wiadomość wychodzi z twojej domeny i pojawia się w Logi.

Zanim zaczniesz

Potrzebujesz dwóch rzeczy:

  1. Tor Produkt. Adres From musi być na domenie lub subdomenie z gotowym torem Produkt. Otwórz Domeny › Dodaj tor, wybierz Produkt i dodaj wymienione rekordy DNS. Zobacz Dodaj domenę. Tor Poczta (skrzynki zespołu) lub Kampania nie może wysyłać poczty aplikacji, więc ta poczta nigdy nie wpływa na reputację skrzynek zespołu.
  2. Klucz API z możliwością wysyłki. Otwórz Klucze API › Utwórz klucz API, nazwij jak aplikację (na przykład “Supabase Auth”), wybierz tylko mail:send i Utwórz klucz. Skopiuj od razu: jest pokazywany raz.

Do Klucze API przejdziesz też przez Ustawienia › Deweloperzy › Zarządzaj kluczami API.

Ustawienia SMTP

Pole SMTP na stronie Klucze API pokazuje te ustawienia z przyciskiem kopiowania hosta.

UstawienieWartość
Hostsubmit.bangermail.com
Port465 (TLS) lub 587 (STARTTLS)
Port, jeśli powyższe są blokowane2465 (TLS) lub 2587 (STARTTLS)
Nazwa użytkownikabanger (dowolna wartość działa; klucz identyfikuje przestrzeń roboczą)
HasłoTwój klucz API
SzyfrowanieTLS 1.2 lub nowszy. Logowanie jest dostępne dopiero po uruchomieniu TLS.
UwierzytelnianiePLAIN lub LOGIN

Jeśli aplikacja pyta o “SSL” lub “TLS”, użyj portu 465. Jeśli o “STARTTLS”, użyj 587.

Połącz Supabase Auth

  1. W Supabase otwórz Authentication › Emails › SMTP Settings i włącz własny SMTP.
  2. Sender email: adres na torze Produkt, taki jak noreply@app.example.com.
  3. Sender name: nazwa produktu. Banger zachowuje ją bez zmian.
  4. Host submit.bangermail.com, Port 465, Username banger, Password twój klucz API.
  5. Zapisz, a potem wyślij sobie magic link z Authentication › Users.

Inne aplikacje działają tak samo: wklej powyższe ustawienia w ich ustawienia SMTP lub poczty. Przykłady kodu są w dokumentacji SMTP dla programistów.

Sprawdź działanie

Otwórz Logi. Każda wiadomość aplikacji pojawia się ze źródłem SMTP i stanem doręczenia. Banger zapisuje też wszystkie odrzucone próby i sposób naprawy.

Aplikacja otrzymuje 250 2.0.0 Queued as …, gdy Banger przyjmie wiadomość.

Co Banger robi z wiadomością

  • Wysyła ją tak, jak napisała aplikacja, z nazwą From, podpisaną kluczem DKIM domeny.
  • Usuwa Bcc i Return-Path oraz dodaje Reply-To z adresem From, jeśli go brak.
  • Pomija wykluczonych odbiorców i wysyła do pozostałych.
  • Traktuje ponowienie tej samej wiadomości jako tę samą wysyłkę, więc przekroczenie czasu nigdy nie wysyła dwa razy.
  • Wlicza każdą wiadomość do planu, jak każdą inną wysyłkę.

Każda wiadomość może mieć do 10 MiB i do 50 odbiorców.

Kiedy wiadomość jest odrzucana

Każda odmowa podaje przyczynę i odniesienie, (ref …), pasujące do wpisu w Logi. Kody zaczynające się od 4 są tymczasowe; aplikacja może ponowić później.

OdpowiedźCo zrobić
535 5.7.8Hasło nie jest działającym kluczem API. Sprawdź, czy klucz nie został unieważniony i ma mail:send.
421 4.7.0Trzy nieudane logowania na jednym połączeniu zamknęły je. Popraw klucz przed ponowieniem.
454 4.7.0Za dużo nieudanych logowań z sieci. Popraw klucz, potem poczekaj do godziny.
550 5.7.1Domena From nie ma gotowego toru Produkt (odpowiedź podaje braki), odbiorca jest wykluczony lub wysyłka wstrzymana. Zobacz Dostarczalność i wstrzymanie wysyłek.
553 5.1.3Adres odbiorcy jest nieprawidłowy.
552 5.3.4Wiadomość jest większa niż 10 MiB.
554 5.6.0Wiadomość jest niepoprawna, na przykład ma dwa nagłówki From lub From z kilkoma adresami.
451 4.7.0Wyczerpano pulę wysyłek lub limit dzienny. Odnowi się w następnym okresie lub dniu, albo teraz po zmianie planu na wyższy.
451 4.3.0Banger nie mógł teraz przyjąć wiadomości. Aplikacja powinna ponowić.

Chroń klucz

  • Daj każdej aplikacji osobny klucz tylko z mail:send. Ujawnione hasło SMTP nie pozwoli wtedy czytać przestrzeni roboczej.
  • Aby wymienić klucz, utwórz nowy, zaktualizuj aplikację i wybierz Odbierz dostęp dla starego. Aplikacje nadal używające starego zostaną odrzucone przy następnym logowaniu.
  • Banger przechowuje tylko skrót każdego klucza i zapisuje odrzucone logowania w Logi.

Wypróbuj ze swoim AI

Utwórz klucz API tylko do wysyłki, sprawdź gotowość toru Produkt i podaj ustawienia SMTP do wklejenia w Supabase.

Nadal potrzebujesz pomocy? Skontaktuj się z pomocą techniczną i podaj ekran oraz dokładny komunikat błędu.