Envie e-mails por SMTP

O relay SMTP do Banger permite que aplicativos que só enviam por SMTP, como Supabase Auth, Auth0, WordPress ou o módulo de e-mail do seu framework, enviem pelo Banger. Seu aplicativo se autentica com uma chave de API do Banger, e cada mensagem sai pelo seu domínio e aparece nos Logs.

Antes de começar

Você precisa de duas coisas:

1. Uma rota de Produto. O endereço From precisa estar em um domínio ou subdomínio com uma rota de Produto pronta. Abra Domínios › Adicionar conexão de envio, escolha Produto e adicione os registros DNS listados. Veja Adicione seu domínio. Uma rota de E-mail (caixas da equipe) ou de Disparo não pode enviar e-mails do aplicativo, para que esses envios nunca afetem a reputação das caixas da equipe.
2. Uma chave de API com permissão de envio. Abra Chaves de API › Criar chave de API, dê o nome do aplicativo (por exemplo, “Supabase Auth”), selecione apenas mail:send e escolha Criar chave. Copie imediatamente: ela aparece uma única vez.

Você também pode acessar Chaves de API em Configurações › Desenvolvedores › Gerenciar chaves de API.

Configurações SMTP

A caixa SMTP na página Chaves de API mostra estas configurações, com um botão para copiar o host.

Se o aplicativo pedir “SSL” ou “TLS”, use a porta 465. Se pedir “STARTTLS”, use 587.

Conecte Supabase Auth

1. No Supabase, abra Authentication › E-mails › Configurações SMTP e ative SMTP personalizado.
2. Sender email: um endereço na sua rota de Produto, como noreply@app.example.com.
3. Nome do remetente: o nome do produto. O Banger mantém como foi escrito.
4. Host submit.bangermail.com, Porta 465, Usuário banger, Senha sua chave de API.
5. Salve e depois envie um link de acesso para você em Authentication › Usuários.

Outros aplicativos funcionam da mesma forma: cole as configurações acima nos ajustes de SMTP ou e-mail. Exemplos de código estão na documentação SMTP para desenvolvedores.

Confira se funcionou

Abra Logs. Cada mensagem enviada pelo aplicativo aparece com SMTP como origem e seu status de entrega. O Banger também registra todas as tentativas recusadas, com o que corrigir.

Seu aplicativo recebe 250 2.0.0 Queued as … quando o Banger aceita uma mensagem.

O que o Banger faz com cada mensagem

• Envia como o aplicativo escreveu, com seu nome From e assinatura DKIM do seu domínio.
• Remove Bcc e Return-Path e adiciona um Reply-To com o endereço From quando não há um.
• Ignora destinatários suprimidos e envia para os demais.
• Trata uma nova tentativa da mesma mensagem como o mesmo envio, para que um tempo limite nunca cause envio duplicado.
• Conta cada mensagem no seu plano, como qualquer outro envio.

Cada mensagem pode ter até 10 MiB e até 50 destinatários.

Quando uma mensagem é recusada

Toda recusa informa o motivo e inclui uma referência, (ref …), que corresponde à entrada nos Logs. Códigos que começam com 4 são temporários; o aplicativo pode tentar de novo depois.

Proteja a chave

• Dê a cada aplicativo sua própria chave com apenas mail:send. Assim, uma senha SMTP vazada não pode ler seu espaço de trabalho.
• Para trocar, crie uma chave nova, atualize o aplicativo e depois use Revogar na antiga. Aplicativos que ainda a usam serão recusados na próxima autenticação.
• O Banger armazena apenas um hash de cada chave e registra autenticações recusadas nos Logs.

Experimente com sua IA

Crie uma chave de API que só possa enviar e-mails, confira se minha rota de Produto está pronta e me dê as configurações SMTP para colar no Supabase.