Descadastro com um clique: cabeçalhos, regras e gerador
Descadastro com um clique
Descadastro com um clique: cabeçalhos RFC 8058 e regras do Gmail | We.Inc
Adicione o descadastro com um clique ao e-mail marketing: os dois cabeçalhos da RFC 8058, o que o Gmail e o Yahoo pedem aos remetentes em massa, o básico da CAN-SPAM e um gerador de cabeçalhos.
O descadastro com um clique permite que alguém saia da sua lista pelo próprio botão Cancelar inscrição da caixa de entrada, sem login nem formulário. Você adiciona dois cabeçalhos da RFC 8058: List-Unsubscribe com um link HTTPS e List-Unsubscribe-Post definido como List-Unsubscribe=One-Click. O Gmail e o Yahoo exigem isso em e-mails de marketing de remetentes em massa.
Quem pede o quê (páginas oficiais, em outubro de 2026)
Fonte
Regra de descadastro
Gmail
Descadastro com um clique em e-mails de marketing para remetentes de 5,000+ por dia; link visível no corpo; atender os pedidos em até 48 horas (recomendado)
Yahoo
Cabeçalho list-unsubscribe funcionando com um clique (RFC 8058); atender os descadastros em até 2 dias
CAN-SPAM (EUA)
Forma clara de sair da lista; atender em até 10 dias úteis; o mecanismo deve funcionar por pelo menos 30 dias após o envio
E-mails transacionais
Gmail: o descadastro com um clique não é exigido em mensagens transacionais
A maioria dos serviços de e-mail adiciona esses cabeçalhos para você quando o gerenciamento de listas está ativado, então confira lá primeiro. Se você envia pelo seu próprio aplicativo ou servidor, o gerador abaixo escreve as duas linhas de cabeçalho, e os exemplos mostram o pequeno endpoint que precisa responder à requisição da caixa de entrada.
Crie um endereço HTTPS de descadastro único por destinatário, com um token difícil de adivinhar.
Coloque esse endereço em List-Unsubscribe entre sinais de menor e maior, opcionalmente seguido de um endereço mailto.
Assine a mensagem com DKIM e inclua os dois cabeçalhos na assinatura, como a RFC 8058 exige.
Quando a caixa de entrada enviar um POST para o seu endereço, remova o inscrito e responda com um status de sucesso, não com um redirecionamento.
Mantenha também o link de descadastro visível no corpo do e-mail. O Gmail pede os dois.
Nunca exija login ou senha no endereço de um clique. O POST da caixa de entrada não leva cookies.
Não responda ao POST com um redirecionamento; a RFC 8058 diz que POSTs redirecionados historicamente falham.
Um GET no mesmo endereço pode vir de um verificador de links, então mostre uma página de confirmação no GET e só descadastre no POST.
Esta página explica regras publicadas; não é aconselhamento jurídico. Confira as leis do lugar onde seus inscritos moram.
Perguntas frequentes
Preciso de descadastro com um clique se envio poucos e-mails?
A exigência do Gmail vale para remetentes de cerca de 5,000 mensagens ou mais por dia para contas do Gmail. Remetentes menores ainda precisam de uma opção de saída funcionando por leis como a CAN-SPAM, e adicionar os cabeçalhos é uma boa prática de qualquer forma.
Confirmações de pedido precisam de cabeçalho de descadastro?
O Gmail diz que o descadastro com um clique só é exigido em mensagens de marketing e promocionais, e as mensagens transacionais ficam de fora. O guia da FTC também trata e-mails puramente transacionais como amplamente isentos da CAN-SPAM.
O List-Unsubscribe pode usar só um endereço mailto?
Não para o descadastro com um clique. A RFC 8058 exige pelo menos um endereço HTTPS no cabeçalho. Um endereço mailto pode ficar ao lado como alternativa para aplicativos de e-mail mais antigos.
Em quanto tempo preciso processar um descadastro?
Em outubro de 2026, o Gmail recomenda em até 48 horas e o Yahoo pede em até 2 dias. A lei americana CAN-SPAM define um prazo legal máximo de 10 dias úteis.
A CAN-SPAM exige que as pessoas se inscrevam antes?
Não. O guia da FTC diz que a lei não exige consentimento prévio, mas exige cabeçalhos e assuntos honestos, identificar a mensagem como anúncio, o seu endereço postal físico e uma opção de saída que você respeite.
O que acontece quando alguém clica
O aplicativo de e-mail lê o seu cabeçalho List-Unsubscribe e envia um POST HTTPS para esse endereço. O corpo da requisição é o valor de List-Unsubscribe-Post, codificado como formulário, então o seu endpoint recebe List-Unsubscribe=One-Click.
Seu servidor encontra o inscrito pelo token no endereço e o remove. Nada mais é enviado: sem cookies, sem login, sem página extra.
A CAN-SPAM em cinco linhas
O guia de conformidade da FTC lista as obrigações centrais para e-mails comerciais: dados verdadeiros de De, Para e roteamento, uma linha de assunto que corresponda ao conteúdo, um aviso claro de que a mensagem é um anúncio, um endereço postal físico válido e uma forma fácil de sair da lista.
Cada e-mail que viola as regras pode custar até $53,088, segundo o guia da FTC em outubro de 2026, então um descadastro funcionando é um seguro barato.
O endpoint que responde ao clique
Um handler mínimo em JavaScript padrão (os objetos Request e Response usados pela maioria das hospedagens modernas). Ele remove no POST e pede confirmação no GET.
Handler de descadastro
Troque removeSubscriber pela sua própria chamada ao banco de dados. O token é a parte difícil de adivinhar do endereço.
Gerador de cabeçalhos
Endereço HTTPS de descadastro (com o token do inscrito)
Endereço mailto opcional
Cabeçalhos a adicionar
O primeiro endereço deve começar com https:// para o descadastro com um clique funcionar.
Pronto para colar. Lembre-se de incluir os dois cabeçalhos na sua assinatura DKIM.