Vai al contenuto

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.

5 min di letturaAggiornato
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:

  1. 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.
  2. Una chiave API che può inviare. Apri Chiavi API › Crea chiave API, chiamala come l’app (per esempio “Supabase Auth”), seleziona solo mail:send e 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.

ImpostazioneValore
Hostsubmit.bangermail.com
Porta465 (TLS) o 587 (STARTTLS)
Porta, se quelle sono bloccate2465 (TLS) o 2587 (STARTTLS)
Nome utentebanger (qualsiasi valore funziona; la chiave identifica il workspace)
PasswordLa tua chiave API
CrittografiaTLS 1.2 o successivo. L’accesso è disponibile solo dopo l’avvio di TLS.
AutenticazionePLAIN o LOGIN

Se l’app chiede “SSL” o “TLS”, usa la porta 465. Se chiede “STARTTLS”, usa 587.

Connetti Supabase Auth

  1. In Supabase, apri Authentication › Emails › SMTP Settings e attiva SMTP personalizzato.
  2. Sender email: un indirizzo sul tuo canale Prodotto, come noreply@app.example.com.
  3. Sender name: il nome del prodotto. Banger lo mantiene come scritto.
  4. Host submit.bangermail.com, Port 465, Username banger, Password la tua chiave API.
  5. 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 Bcc e Return-Path e aggiunge un Reply-To con 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.

RispostaCosa fare
535 5.7.8La password non è una chiave API funzionante. Controlla che non sia stata revocata e abbia mail:send.
421 4.7.0Tre accessi non riusciti sulla stessa connessione, quindi è stata chiusa. Correggi la chiave prima di riprovare.
454 4.7.0Troppi accessi non riusciti dalla tua rete. Correggi la chiave, poi aspetta fino a un’ora.
550 5.7.1Il 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.3Un indirizzo destinatario non è valido.
552 5.3.4Il messaggio supera 10 MiB.
554 5.6.0Il messaggio è malformato, per esempio due intestazioni From o un From con più indirizzi.
451 4.7.0La 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.0Banger 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.

Hai ancora bisogno di aiuto? Contatta l’assistenza indicando la schermata e l’errore esatto.