
Os convites que a suíte mandava de verdade — 410 e-mails e 72% de bounce
O botão que mandava e-mail de verdade
O Capivara é o hub que eu uso para administrar o resto do ecossistema. Uma das telas dele é o convite: eu informo um endereço, o sistema cria o convite com token e expiração, e o e-mail com o link sai na hora. É um fluxo pequeno, mas é um fluxo com efeito colateral externo — ele fala com o provedor de e-mail, e o provedor cobra (e cobra caro) por má conduta.
No dia 15/11 abri a conta do provedor e encontrei 410 mensagens saindo do remetente de convites entre 10 e 15 de novembro. Todas para endereços de fixture: list-a@, delete-me@, invited@, perm-invited@. Dessas 410, 295 voltaram como bounce — 72% de falha. A cadência era de aproximadamente 71 segundos entre uma mensagem e a seguinte.
As ferramentas que uso neste projeto ficam na loja de skills — a primeira é grátis.
Não era um ataque, nem um vazamento de credencial. Era eu rodando a rotina de testes.
O caminho inteiro, do teste até a caixa postal
A suíte de testes do backend exercita o fluxo de convite de ponta a ponta: ela faz o POST no endpoint, confere a resposta, valida o token, checa a permissão. E o endpoint, por desenho, chama o envio de e-mail sempre que a requisição traz um endereço.
O serviço de e-mail, por sua vez, lê a chave da API do provedor do ambiente do processo no momento do import. A suíte herdava o mesmo ambiente da máquina de desenvolvimento — inclusive o arquivo de configuração com a chave de produção. Resultado: cada execução do conjunto virava um lote de envios reais para caixas que não existem.
O número que fecha a conta é o intervalo entre envios. Setenta e um segundos é o tempo aproximado de uma rodada completa da suíte. O defeito não estava intermitente: estava ligado por cinco dias, uma vez por rodada, sem ninguém ver, porque o teste passava.
Por que 72% de bounce é pior do que parece
Bounce não é um erro do meu código para o meu log — é um evento que fica registrado na reputação do domínio remetente. E esse domínio é compartilhado: é o mesmo que entrega os e-mails da loja, do app de passeio e do portfólio. Não existe reputação por conta, existe reputação por domínio.
Provedores tratam taxa de bounce alta como sinal clássico de lista comprada. A punição escala: classificação em spam primeiro, bloqueio temporário do remetente depois, e no limite a suspensão do domínio. Quando isso acontece, quem para de receber e-mail não é a suíte de testes. São os clientes.
E o pior aspecto é a assimetria de detecção. Um teste que envia e-mail para um endereço inexistente e recebe 202 do provedor continua verde — o provedor aceita a mensagem e só descobre o bounce segundos depois, do lado de lá. O comentário de sucesso está no meu lado; o bounce está no painel de outra pessoa.
Duas barreiras, em camadas diferentes
O conserto não foi um, foram dois, e cada um resolve uma classe de falha distinta.
A primeira barreira corta a causa na origem: a suíte deixa de ter a chave. Antes do primeiro import do serviço de e-mail, o ambiente da suíte remove a variável. A ordem importa mais do que parece — o serviço lê a chave no import, não a cada chamada, então remover depois não vale nada:
# no conftest, antes de importar o serviço de e-mail
os.environ.pop("RESEND_API_KEY", None)
Sem chave, o serviço cai no modo de fallback: monta o corpo, escreve no log e retorna False. O fluxo testado continua o mesmo, o e-mail não sai.
A segunda barreira é mais importante, porque não depende de disciplina de ambiente: o próprio serviço recusa destino de fixture, mesmo que alguém rode a suíte com a chave real na mão — o que mais cedo ou mais tarde alguém vai fazer.
_ROTULOS_DE_TESTE = {"test", "teste", "invalid", "example", "localhost", "local"}
_DOMINIOS_DE_TESTE = {"test.com", "example.com", "example.org", "example.net"}
def destino_de_teste(endereco: str) -> bool:
dominio = (endereco or "").rsplit("@", 1)[-1].lower().strip()
if not dominio:
return False
if dominio in _DOMINIOS_DE_TESTE:
return True
return any(rotulo in _ROTULOS_DE_TESTE for rotulo in dominio.split("."))
A lista de rótulos espelha os domínios reservados por RFC 2606 e RFC 6761: test, invalid, example, localhost. São domínios que não existem por definição, então mantêm a promessa de nunca entregar — todo endereço neles é bounce garantido. O example.org e o example.net entraram junto porque também são reservados e também apareciam nas fixtures.
O detalhe que deixaria passar os próximos 410
A primeira versão da guarda testava o sufixo do domínio contra .test. Parece correto e não é: [email protected] termina em .com. Ali .com é o TLD e test é o segundo nível — o endswith(".test") nunca dispara. Esse é exatamente o tipo de erro que sobrevive a revisão, porque a intenção está certa e a expressão está errada.
A guarda válida compara rótulo por rótulo, e não só o domínio inteiro contra uma lista: quebra o domínio nos pontos e verifica se algum pedaço é um rótulo reservado. Funciona para test.com, para algo.test e para test.example.org. A checagem foi validada em cinco endereços — três de fixture retornando True, um endereço comum e um do domínio próprio retornando False.
O que mudou de fato
O backend passou com 246 testes depois da mudança. O teste que exercita especificamente o caminho do provedor deixou de usar endereço de fixture e passou a usar um domínio real com a chamada HTTP mockada — o objetivo dele é verificar o formato da requisição, não a entrega, então nada precisa sair pela rede para ele valer.
A lição transferível é maior que o bug. Ambiente de teste não deveria ter credencial de produção, mas “não deveria” não é controle: quando a credencial está lá, a única barreira confiável é a que está no código que produz o efeito colateral. O teste não é o lugar de impedir o envio; o serviço de e-mail é. O teste pode esquecer, a configuração pode vazar, a pessoa pode rodar com a chave real para depurar — e a guarda de destino continua valendo em todas essas hipóteses.
Próximo passo
Falta a parte que mede: acompanhar a taxa de bounce por remetente no painel do provedor e transformar isso em alerta, em vez de descoberta casual. Uma guarda impede o envio errado daqui para frente; ela não prova que a reputação do domínio voltou ao normal depois de cinco dias de bounce em 72%. Esse número precisa de um gráfico, não de memória.
Leia também
Mesmo projeto, mesma trilha — as histórias se conectam.
Próximo passo
Se isto te serviu, tem mais: escrevo sobre o mesmo assunto nos outros projetos, e a loja tem as ferramentas que eu uso aqui.
Anotado — aviso quando sair artigo novo.
Sem spam, descadastro de um clique. Também estou aqui: Loja de skills · Portfólio