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.
Antes de começar
Seção intitulada “Antes de começar”- 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
httpsno seu sistema que descadastra o destinatário quando recebe umPOST.
Passo a passo
Seção intitulada “Passo a passo”-
Crie o endereço de descadastro no seu sistema. Ele recebe um
POSTcom o corpoList-Unsubscribe=One-Clicke 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ó oPOSTdescadastra direto. - identificar o destinatário pela própria URL — um código por destinatário, como
-
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-ClickO valor de
List-Unsubscribe-Posté sempre esse, exatamente assim. -
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 campoh=trazList-UnsubscribeeList-Unsubscribe-Post; - o resultado do DKIM é
PASS.
Exemplos
Seção intitulada “Exemplos”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({ 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.
O que acontece depois
Seção intitulada “O que acontece depois”- 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
POSTdireto 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.
Se der errado
Seção intitulada “Se der errado”| 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 |
