Approvazioni, Log e invii
Invia email tramite SMTP
Connetti Supabase Auth, WordPress o qualsiasi app SMTP a Banger, così le email partono dal tuo dominio e appaiono nei Log.
In questa guida 8 sezioni
Il relay SMTP di Banger permette a qualsiasi app che invia solo tramite SMTP, come Supabase Auth, Auth0, WordPress o il sistema email del tuo framework, di inviare attraverso Banger. L’app accede con una chiave API Banger e ogni messaggio parte dal tuo dominio e appare nei Log.
Prima di iniziare
Ti servono due cose:
- Un canale Prodotto. L’indirizzo From deve trovarsi su un dominio o sottodominio con un canale Prodotto pronto. Apri Domini › Aggiungi canale, scegli Prodotto e aggiungi i record DNS elencati. Vedi Aggiungi il dominio. Un canale Posta (le caselle del team) o Campagna non può inviare email dell’app, così la posta dell’app non influisce mai sulla reputazione delle caselle del team.
- Una chiave API che può inviare. Apri Chiavi API › Crea chiave API, chiamala come l’app (per esempio “Supabase Auth”), seleziona solo
mail:sende scegli Crea chiave. Copiala subito: viene mostrata una volta.
Puoi raggiungere Chiavi API anche da Impostazioni › Sviluppatori › Gestisci chiavi API.
Impostazioni SMTP
Il riquadro SMTP nella pagina Chiavi API mostra queste impostazioni, con un pulsante per copiare l’host.
| Impostazione | Valore |
|---|---|
| Host | submit.bangermail.com |
| Porta | 465 (TLS) o 587 (STARTTLS) |
| Porta, se quelle sono bloccate | 2465 (TLS) o 2587 (STARTTLS) |
| Nome utente | banger (qualsiasi valore funziona; la chiave identifica il workspace) |
| Password | La tua chiave API |
| Crittografia | TLS 1.2 o successivo. L’accesso è disponibile solo dopo l’avvio di TLS. |
| Autenticazione | PLAIN o LOGIN |
Se l’app chiede “SSL” o “TLS”, usa la porta 465. Se chiede “STARTTLS”, usa 587.
Connetti Supabase Auth
- In Supabase, apri Authentication › Emails › SMTP Settings e attiva SMTP personalizzato.
- Sender email: un indirizzo sul tuo canale Prodotto, come
noreply@app.example.com. - Sender name: il nome del prodotto. Banger lo mantiene come scritto.
- Host
submit.bangermail.com, Port465, Usernamebanger, Password la tua chiave API. - Salva, poi inviati un magic link da Authentication › Users.
Le altre app funzionano allo stesso modo: incolla le impostazioni sopra nelle loro impostazioni SMTP o email. Gli esempi di codice sono nella documentazione SMTP per sviluppatori.
Controlla che funzioni
Apri Log. Ogni messaggio inviato dall’app appare con SMTP come origine e lo stato di consegna. Banger registra anche ogni tentativo rifiutato, con cosa correggere.
L’app riceve 250 2.0.0 Queued as … quando Banger accetta un messaggio.
Cosa fa Banger con ogni messaggio
- Lo invia come scritto dall’app, con il nome From, firmato con la chiave DKIM del dominio.
- Rimuove
BcceReturn-Pathe aggiunge unReply-Tocon l’indirizzo From se non c’è. - Salta i destinatari esclusi e invia agli altri.
- Tratta un nuovo tentativo dello stesso messaggio come lo stesso invio, così un timeout non invia mai due volte.
- Conta ogni messaggio nel piano, come qualsiasi altro invio.
Ogni messaggio può arrivare a 10 MiB con fino a 50 destinatari.
Quando un messaggio viene rifiutato
Ogni rifiuto spiega perché e include un riferimento, (ref …), che corrisponde alla voce nei Log. I codici che iniziano con 4 sono temporanei; l’app può riprovare più tardi.
| Risposta | Cosa fare |
|---|---|
535 5.7.8 | La password non è una chiave API funzionante. Controlla che non sia stata revocata e abbia mail:send. |
421 4.7.0 | Tre accessi non riusciti sulla stessa connessione, quindi è stata chiusa. Correggi la chiave prima di riprovare. |
454 4.7.0 | Troppi accessi non riusciti dalla tua rete. Correggi la chiave, poi aspetta fino a un’ora. |
550 5.7.1 | Il dominio From non ha un canale Prodotto pronto (la risposta indica cosa manca), il destinatario è escluso o l’invio è in pausa. Vedi Recapitabilità e pause degli invii. |
553 5.1.3 | Un indirizzo destinatario non è valido. |
552 5.3.4 | Il messaggio supera 10 MiB. |
554 5.6.0 | Il messaggio è malformato, per esempio due intestazioni From o un From con più indirizzi. |
451 4.7.0 | La quota di invio o il limite giornaliero è esaurito. Si rinnova al prossimo periodo o giorno, oppure subito passando a un piano superiore. |
451 4.3.0 | Banger non ha potuto accettare il messaggio ora. L’app deve riprovare. |
Proteggi la chiave
- Dai a ogni app una chiave propria con solo
mail:send. Una password SMTP esposta non potrà leggere il workspace. - Per sostituirla, crea una nuova chiave, aggiorna l’app, poi usa Revoca sulla vecchia. Le app che la usano ancora vengono rifiutate al prossimo accesso.
- Banger conserva solo un hash di ogni chiave e registra gli accessi rifiutati nei Log.
Prova con la tua AI
Crea una chiave API che può solo inviare posta, controlla che il canale Prodotto sia pronto e dammi le impostazioni SMTP da incollare in Supabase.