Freigaben, Protokolle und Versand
E-Mails über SMTP senden
Verbinde Supabase Auth, WordPress oder SMTP-Apps mit Banger, damit E-Mails von deiner Domain kommen und in Protokollen erscheinen.
In diesem Leitfaden 8 Abschnitte
Bangers SMTP-Relay ermöglicht Apps, die nur SMTP unterstützen, etwa Supabase Auth, Auth0, WordPress oder dem Mailmodul deines Frameworks, den Versand über Banger. Die App meldet sich mit einem Banger-API-Schlüssel an. Jede Nachricht kommt von deiner Domain und erscheint unter Protokolle.
Voraussetzungen
Du brauchst zwei Dinge:
- Einen Produkt-Versandweg. Die From-Adresse braucht eine Domain oder Subdomain mit bereitem Produkt-Versandweg. Öffne Domains › Versandweg hinzufügen, wähle Produkt und ergänze die DNS-Einträge. Siehe Domain hinzufügen. E-Mail- oder Kampagnen-Versandwege können keine App-E-Mails senden, damit diese die Reputation der Teampostfächer nie beeinflussen.
- API-Schlüssel mit Versandrecht. Öffne API-Schlüssel › API-Schlüssel erstellen, benenne nach der App (etwa „Supabase Auth“), wähle nur
mail:sendund Schlüssel erstellen. Kopiere ihn sofort: Er wird einmal angezeigt.
API-Schlüssel erreichst du auch über Einstellungen › Entwickler › API-Schlüssel verwalten.
SMTP-Einstellungen
Das Feld SMTP auf API-Schlüssel zeigt diese Einstellungen mit Kopierknopf für den Host.
| Einstellung | Wert |
|---|---|
| Host | submit.bangermail.com |
| Port | 465 (TLS) oder 587 (STARTTLS) |
| Port bei Blockierung | 2465 (TLS) oder 2587 (STARTTLS) |
| Benutzername | banger (beliebiger Wert; der Schlüssel identifiziert den Workspace) |
| Passwort | Dein API-Schlüssel |
| Verschlüsselung | TLS 1.2 oder neuer. Anmeldung erst nach TLS-Start. |
| Authentifizierung | PLAIN oder LOGIN |
Bei „SSL“ oder „TLS“ nutze 465, bei „STARTTLS“ 587.
Supabase Auth verbinden
- Öffne in Supabase Authentication › E-Mails › SMTP-Einstellungen und aktiviere eigenes SMTP.
- Absender-E-Mail: Adresse auf dem Produkt-Versandweg wie
noreply@app.example.com. - Absendername: Produktname. Banger behält die Schreibweise.
- Host
submit.bangermail.com, Port465, Benutzernamebanger, Passwort dein API-Schlüssel. - Speichere und sende dir unter Authentication › Benutzer einen Anmeldelink.
Andere Apps funktionieren genauso: Füge die Angaben in ihre SMTP- oder Maileinstellungen ein. Codebeispiele findest du in der SMTP-Entwicklerdokumentation.
Funktion prüfen
Öffne Protokolle. Jede App-Nachricht erscheint mit Ursprung SMTP und Zustellstatus. Banger protokolliert auch abgelehnte Versuche mit Korrekturhinweisen.
Deine App erhält 250 2.0.0 Queued as …, wenn Banger annimmt.
Behandlung jeder Nachricht
- Versand wie von der App geschrieben, mit deinem From-Namen und DKIM-Signatur deiner Domain.
- Entfernen von
BccundReturn-Path, Ergänzen vonReply-Tomit From-Adresse, wenn keines vorhanden ist. - Gesperrte Empfänger überspringen, an übrige senden.
- Wiederholungsversuche derselben Nachricht gelten als derselbe Versand, damit Zeitüberschreitungen nie doppelt senden.
- Jede Nachricht zählt zum Tarif wie jede Sendung.
Bis zu 10 MiB und 50 Empfänger pro Nachricht.
Ablehnungen
Jede Ablehnung nennt Ursache und Referenz (ref …), passend zum Eintrag unter Protokolle. Codes mit 4 sind vorübergehend; deine App kann später wiederholen.
| Antwort | Maßnahme |
|---|---|
535 5.7.8 | Passwort ist kein gültiger API-Schlüssel. Prüfe Widerruf und mail:send. |
421 4.7.0 | Drei fehlgeschlagene Anmeldungen schließen die Verbindung. Korrigiere den Schlüssel. |
454 4.7.0 | Zu viele Fehlanmeldungen aus deinem Netz. Korrigiere den Schlüssel, warte bis zu eine Stunde. |
550 5.7.1 | From-Domain hat keinen bereiten Produkt-Versandweg (Antwort nennt Fehlendes), Empfänger ist gesperrt oder Versand pausiert. Siehe Zustellbarkeit und Pausen. |
553 5.1.3 | Empfängeradresse ist ungültig. |
552 5.3.4 | Nachricht überschreitet 10 MiB. |
554 5.6.0 | Fehlerhafte Nachricht, etwa zwei From-Kopfzeilen oder mehrere Adressen in From. |
451 4.7.0 | Versandkontingent oder Tageslimit erschöpft. Erneuerung nächste Periode oder nächsten Tag, sofort durch Tarifwechsel. |
451 4.3.0 | Banger konnte gerade nicht annehmen. Die App sollte wiederholen. |
Schlüssel schützen
- Jede App bekommt einen eigenen Schlüssel nur mit
mail:send. Ein offengelegtes SMTP-Passwort kann so den Workspace nicht lesen. - Erstelle zum Wechsel einen neuen Schlüssel, aktualisiere die App und nutze Widerrufen für den alten. Weitere Nutzung wird bei der nächsten Anmeldung abgelehnt.
- Banger speichert nur Schlüsselhashes und protokolliert abgelehnte Anmeldungen unter Protokolle.
Probiere es mit deiner KI
Erstelle einen API-Schlüssel nur zum Versand, prüfe meinen Produkt-Versandweg und gib mir die SMTP-Einstellungen für Supabase.