E-mail versturen via SMTP

De SMTP-relay van Banger laat elke app die alleen via SMTP kan versturen, zoals Supabase Auth, Auth0, WordPress of de mailer van je framework, via Banger versturen. Je app meldt zich aan met een Banger API-sleutel en elk bericht wordt vanaf je eigen domein verstuurd en verschijnt in Logs.

Voordat je begint

Je hebt twee dingen nodig:

1. Een Product-lane. Het From-adres moet op een domein of subdomein met een gereedstaande Product-lane staan. Open Domeinen › Lane toevoegen, kies Product en voeg de getoonde DNS-records toe. Zie Je domein toevoegen. Een Mail-lane (de mailboxen van je team) of een Campagne-lane kan geen app-e-mail versturen, zodat de mail van je app de inboxreputatie van je team nooit beïnvloedt.
2. Een API-sleutel die mag versturen. Open API-sleutels › API-sleutel maken, geef de sleutel de naam van de app (bijvoorbeeld “Supabase Auth”), selecteer alleen mail:send en kies Sleutel maken. Kopieer die direct: de sleutel wordt één keer getoond.

Je kunt API-sleutels ook bereiken via Instellingen › Ontwikkelaars › API-sleutels beheren.

SMTP-instellingen

Het vak SMTP op de pagina API-sleutels toont deze instellingen, met een kopieerknop voor de host.

Vraagt je app om “SSL” of “TLS”, gebruik dan poort 465. Vraagt die om “STARTTLS”, gebruik dan 587.

Supabase Auth verbinden

1. Open in Supabase Authentication › Emails › SMTP Settings en zet aangepaste SMTP aan.
2. Sender email: een adres op je Product-lane, zoals noreply@app.example.com.
3. Naam afzender: de naam van je product. Banger behoudt die zoals geschreven.
4. Host submit.bangermail.com, Port 465, Username banger, Password je API-sleutel.
5. Sla op en stuur jezelf daarna een magic link vanuit Authentication › Users.

Andere apps werken hetzelfde: plak de instellingen hierboven in hun SMTP- of mailinstellingen. Codevoorbeelden staan in de SMTP-documentatie voor ontwikkelaars.

Controleer of het werkt

Open Logs. Elk bericht dat je app verstuurt verschijnt met SMTP als bron en de bezorgstatus. Banger legt ook elke geweigerde poging vast, met wat je moet oplossen.

Je app krijgt 250 2.0.0 Queued as … wanneer Banger een bericht accepteert.

Wat Banger met elk bericht doet

• Verstuurt het zoals je app het heeft geschreven, met je From-naam, ondertekend met de DKIM-sleutel van je domein.
• Verwijdert Bcc en Return-Path en voegt een Reply-To met het From-adres toe als die ontbreekt.
• Slaat onderdrukte ontvangers over en verstuurt naar de rest.
• Behandelt een nieuwe poging van hetzelfde bericht als dezelfde verzending, zodat een time-out nooit dubbel verstuurt.
• Telt elk bericht mee voor je abonnement, zoals elke andere verzending.

Elk bericht mag maximaal 10 MiB groot zijn met maximaal 50 ontvangers.

Wanneer een bericht wordt geweigerd

Elke weigering vermeldt de reden en bevat een referentie, (ref …), die overeenkomt met het item in Logs. Codes die met 4 beginnen zijn tijdelijk; je app kan het later opnieuw proberen.

Houd de sleutel veilig

• Geef elke app een eigen sleutel met alleen mail:send. Een gelekt SMTP-wachtwoord kan je werkruimte dan niet lezen.
• Maak voor rotatie een nieuwe sleutel, werk de app bij en gebruik dan Intrekken voor de oude. Apps die die nog gebruiken worden bij hun volgende aanmelding geweigerd.
• Banger slaat alleen een hash van elke sleutel op en legt geweigerde aanmeldingen vast in Logs.

Probeer het met je AI

Maak een API-sleutel die alleen mail kan versturen, controleer of mijn Product-lane klaar is en geef me de SMTP-instellingen om in Supabase te plakken.