Pular para o conteúdo

Ativar o descadastro em um clique

Com dois cabeçalhos na mensagem, Gmail, Yahoo e outros provedores podem mostrar um botão Cancelar inscrição ao lado do remetente — e quem não quer mais receber sai por ali, em vez de marcar a mensagem como spam. Gmail e Yahoo pedem esse descadastro em um clique (RFC 8058) a quem envia mensagens de marketing em volume para eles.

  • Um domínio com os registros DNS publicados — sem eles a mensagem não sai assinada. Veja Publicar os registros DNS do domínio.
  • Um endereço https no seu sistema que descadastra o destinatário quando recebe um POST.
  1. Crie o endereço de descadastro no seu sistema. Ele recebe um POST com o corpo List-Unsubscribe=One-Click e precisa:

    • identificar o destinatário pela própria URL — um código por destinatário, como https://suaempresa.com.br/sair/abc123, e não o e-mail aberto na URL;
    • descadastrar na hora, sem login, sem página de confirmação e sem redirecionar;
    • responder 200.

    Quem abre o mesmo endereço no navegador chega por GET: aí mostre uma página com o botão de confirmar. Só o POST descadastra direto.

  2. Inclua os dois cabeçalhos em cada mensagem, com a URL daquele destinatário:

    List-Unsubscribe: <https://suaempresa.com.br/sair/abc123>
    List-Unsubscribe-Post: List-Unsubscribe=One-Click

    O valor de List-Unsubscribe-Post é sempre esse, exatamente assim.

  3. Faça um envio de teste para uma caixa do Gmail e abra a mensagem em Mais (⋮) → Mostrar original. Confira três coisas:

    • os dois cabeçalhos aparecem como você enviou;
    • no DKIM-Signature, o campo h= traz List-Unsubscribe e List-Unsubscribe-Post;
    • o resultado do DKIM é PASS.

Os mesmos envios de Conectar seu sistema ao servidor SMTP, com os dois cabeçalhos.

PHP (PHPMailer)

$mail->addCustomHeader('List-Unsubscribe', '<https://suaempresa.com.br/sair/abc123>');
$mail->addCustomHeader('List-Unsubscribe-Post', 'List-Unsubscribe=One-Click');

Node.js (Nodemailer)

await transporter.sendMail({
from: '"Sua Empresa" <[email protected]>',
subject: 'Novidades da semana',
html: '<p>Olá! Confira as novidades.</p>',
headers: {
'List-Unsubscribe': '<https://suaempresa.com.br/sair/abc123>',
'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
},
});

Python (smtplib)

msg["List-Unsubscribe"] = "<https://suaempresa.com.br/sair/abc123>"
msg["List-Unsubscribe-Post"] = "List-Unsubscribe=One-Click"

Pela API, os dois vão no campo headers do envio de mensagem.

  • A iPORTO assina os dois cabeçalhos com o DKIM do seu domínio. Não há nada a ligar no painel.
  • O botão aparece quando o provedor decide mostrar. Os cabeçalhos são o requisito, não a garantia: cada provedor também pesa o volume e o histórico do remetente.
  • Quando o destinatário clica, o provedor faz o POST direto no seu endereço — o pedido não passa pela iPORTO. Quem registra o descadastro é o seu sistema; para bloquear também do lado da iPORTO, inclua o endereço na lista de supressão.
  • Gmail e Yahoo pedem que o descadastro seja atendido em até dois dias.
Sintoma Causa provável O que fazer
O botão Cancelar inscrição não aparece O provedor ainda não mostra para o seu remetente, ou falta um dos cabeçalhos Confira o original: com os dois cabeçalhos no h= e DKIM PASS, a parte do seu lado está feita
List-Unsubscribe-Post não aparece no original O sistema não enviou o cabeçalho, ou o nome está escrito diferente Confira o nome exato e se o cabeçalho é incluído em todas as mensagens
DKIM FAIL ou sem assinatura O From é de um domínio não cadastrado, ou os registros DNS não estão publicados Use um remetente do domínio cadastrado e confira os registros DNS
O clique não descadastra O endereço só aceita GET, pede login ou redireciona Aceite POST sem login e responda 200, sem redirecionar
Contatos descadastrados sem terem clicado O endereço descadastra no GET, e filtros antispam abrem os links da mensagem Descadastre só no POST; no GET, peça confirmação