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.
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:
- 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.
- 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:sendi 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.
| Ustawienie | Wartość |
|---|---|
| Host | submit.bangermail.com |
| Port | 465 (TLS) lub 587 (STARTTLS) |
| Port, jeśli powyższe są blokowane | 2465 (TLS) lub 2587 (STARTTLS) |
| Nazwa użytkownika | banger (dowolna wartość działa; klucz identyfikuje przestrzeń roboczą) |
| Hasło | Twój klucz API |
| Szyfrowanie | TLS 1.2 lub nowszy. Logowanie jest dostępne dopiero po uruchomieniu TLS. |
| Uwierzytelnianie | PLAIN 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
- W Supabase otwórz Authentication › Emails › SMTP Settings i włącz własny SMTP.
- Sender email: adres na torze Produkt, taki jak
noreply@app.example.com. - Sender name: nazwa produktu. Banger zachowuje ją bez zmian.
- Host
submit.bangermail.com, Port465, Usernamebanger, Password twój klucz API. - 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
BcciReturn-Pathoraz dodajeReply-Toz 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.8 | Hasło nie jest działającym kluczem API. Sprawdź, czy klucz nie został unieważniony i ma mail:send. |
421 4.7.0 | Trzy nieudane logowania na jednym połączeniu zamknęły je. Popraw klucz przed ponowieniem. |
454 4.7.0 | Za dużo nieudanych logowań z sieci. Popraw klucz, potem poczekaj do godziny. |
550 5.7.1 | Domena 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.3 | Adres odbiorcy jest nieprawidłowy. |
552 5.3.4 | Wiadomość jest większa niż 10 MiB. |
554 5.6.0 | Wiadomość jest niepoprawna, na przykład ma dwa nagłówki From lub From z kilkoma adresami. |
451 4.7.0 | Wyczerpano 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.0 | Banger 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.