Enviar e-mail por SMTP

Configurações

Antes de começar

1. Crie uma chave de API. Em o app do Banger, abra Configurações → Desenvolvedores → Gerenciar chaves de API, escolha Criar chave de API, selecione mail:send e copie a chave: ela aparece uma única vez. A página mostra essas configurações SMTP ao lado das chaves.
2. Envie de um canal de Produto. O endereço From deve estar em um hostname com canal de Produto ativo, o canal para recibos, alertas e outros e-mails do seu app. Em Domínios, escolha Adicionar canal, depois Produto, e adicione os registros DNS listados. Um canal de E-mail (as caixas da equipe) ou de Disparo não transporta e-mail de app, então o e-mail do seu app não pode afetar a reputação da caixa de entrada da equipe.

Exemplo: Supabase Auth

No seu projeto Supabase, abra Authentication → Emails → SMTP Settings e ative SMTP personalizado:

Salve, depois envie um link mágico de Authentication → Users para verificar se chega.

Exemplo: Node.js

import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "submit.bangermail.com",
  port: 465,
  secure: true,
  auth: { user: "banger", pass: process.env.BANGER_API_KEY },
});

await transport.sendMail({
  from: "Acme <noreply@app.example.com>",
  to: "person@example.com",
  subject: "Your receipt",
  html: "<p>Thanks for your order.</p>",
});

Para testar de um terminal com swaks:

swaks --server submit.bangermail.com:465 --tls-on-connect \
  --auth PLAIN --auth-user banger --auth-password "$BANGER_API_KEY" \
  --from noreply@app.example.com --to you@example.com

O que acontece com cada mensagem

• O Banger entrega a mensagem como seu app a escreveu, com seu nome From, assinada com a chave DKIM do seu domínio e enviada pelo domínio de retorno do seu canal de Produto.
• Remove Bcc, Return-Path e os cabeçalhos próprios do Banger, e adiciona Reply-To indicando o endereço From quando não existe.
• Cada destinatário é verificado em RCPT TO: um endereço suprimido é recusado individualmente e os outros recebem.
• Uma mensagem pode ter até 10 MiB e até 50 destinatários.
• Um cabeçalho Idempotency-Key torna uma nova tentativa o mesmo envio. Sem ele, uma repetição da mesma mensagem e destinatários ainda é reconhecida.
• Cada mensagem aparece em Logs com SMTP como fonte e conta no seu plano como qualquer outro envio.

Respostas e erros

Uma recusa informa sua causa e traz uma referência, (ref …), que corresponde à entrada em Logs. Códigos que começam com 4 são temporários: seu app pode tentar novamente depois.

Segurança

• O Banger armazena apenas um hash de cada chave. Revogue ou rotacione uma chave em Gerenciar chaves de API; clientes SMTP que a usam são recusados no próximo login.
• Dê ao SMTP uma chave própria com apenas mail:send, para que uma senha vazada não possa ler seu espaço de trabalho.
• Logins falhos são limitados por rede do cliente e por chave, e um login recusado com uma das suas chaves é registrado em Logs.

Prefere HTTP? O mesmo envio está disponível pela API do Banger.