Descadastro com um clique, o cabeçalho que de fato conta.

O que são exatamente os dois cabeçalhos?

O um clique é um par de cabeçalhos que trabalham juntos, definidos pela RFC 8058 (o sinal de um clique via POST, sobre os cabeçalhos List-* da RFC 2369). O primeiro anuncia o mecanismo de descadastro; o segundo sinaliza que ele é de fato um clique e que deve ser processado com um POST HTTP. Omita qualquer um dos dois e você não tem um clique — tem um link comum.

# Dois cabeçalhos em cada mensagem promocional — ambos assinados com DKIM
List-Unsubscribe: <https://example.com/u/9f2c4a8e>,
                  <mailto:unsub@example.com?subject=unsubscribe>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
# o valor de -Post deve ser EXATAMENTE este; é o sinal de um clique

Três detalhes decidem se isto funciona. O cabeçalho List-Unsubscribe deve conter ao menos um URI HTTPS, dentro de colchetes angulares — os colchetes ausentes são o motivo mais comum de um cabeçalho estar presente e não fazer nada. O valor de List-Unsubscribe-Post deve ser exatamente List-Unsubscribe=One-Click. E ambos os cabeçalhos devem estar cobertos por uma assinatura DKIM válida e alinhada, porque um receptor que não consegue verificá-los pode ignorá-los por completo — que é como falham em silêncio os cabeçalhos injetados por middleware após a assinatura.

Incluir um URI mailto: junto ao HTTPS é boa prática, mas um mailto por si só não cumpre o requisito, porque não pode garantir o processamento instantâneo e automatizado. O URI HTTPS é o que carrega o mecanismo POST; o mailto está ali para o Apple Mail e os clientes antigos que o preferem.

O próprio URI HTTPS merece um momento de reflexão, porque é onde a segurança e a confiabilidade se encontram. A RFC 8058 recomenda que a URL de descadastro carregue um identificador opaco e difícil de falsificar em vez de um endereço de e-mail em texto claro na string de consulta. A razão é dupla: um endereço em claro é trivial de manipular para qualquer um, e vaza o endereço do destinatário para qualquer coisa que registre URLs pelo caminho. Um token opaco — uma string aleatória e imprevisível que o seu sistema mapeia de volta ao destinatário e à lista corretos — permite que o POST se complete de imediato mantendo o endereço privado e a requisição difícil de abusar. Também significa que a URL carrega tudo o que o endpoint precisa para agir por si só, que é justo o que o um clique exige: o descadastro deve ter êxito a partir do POST só, sem o endpoint recorrer a uma sessão, um cookie ou um estado de sessão iniciada que o servidor de um provedor de caixa nunca terá.

Como verifico que funciona de verdade?

Não o julgue por se o botão aparece na caixa. O botão de Cancelar inscrição frequentemente não é exibido num envio de teste mesmo quando a implementação é perfeita, em parte porque os provedores pesam a reputação do remetente antes de exibi-lo. A única verificação confiável é ler os cabeçalhos em bruto de uma mensagem entregue e depois exercitar o endpoint diretamente.

# Verifique que o endpoint descadastra só com POST — sem login, sem redirecionamento, 200 OK
curl -i -X POST \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data "List-Unsubscribe=One-Click" \
  https://example.com/u/9f2c4a8e
# esperado: 200 OK, e o destinatário de fato removido da lista

O teste deve confirmar duas coisas: que o endpoint devolve 200 e que o destinatário é genuinamente removido da lista pretendida, sem login, cadeia de redirecionamentos nem página de confirmação no caminho. Se qualquer uma dessas aparecer, você tem um link que funciona mas não um clique da RFC 8058, e os provedores o tratarão como descumprimento.

Como o um clique se liga à sua taxa de reclamações e à lei

O um clique não é uma caixa isolada a marcar; ele se assenta diretamente sobre o limiar de taxa de reclamações que governa a sua entregabilidade. O Gmail e o Yahoo querem os remetentes em massa abaixo de uma taxa de reclamações de spam de 0,1% e tratam qualquer coisa acima de 0,3% como gatilho de filtragem. Em escala, isso é uma margem finíssima, e um descadastro sem atrito é uma das poucas alavancas que a move a seu favor: cada destinatário que sai limpo pelo cabeçalho é um destinatário que não apresentou uma reclamação. Uma implementação correta de um clique é, nesse sentido, gestão da taxa de reclamações com outro nome.

Ele também vive dentro de um marco legal que merece respeito por si mesmo. Um link de descadastro visível no corpo é obrigatório pela lei antispam independentemente do que o Gmail e o Yahoo peçam, e as sanções por errar no descadastro não são triviais — sob a CAN-SPAM nos Estados Unidos, as infrações são avaliadas por e-mail individual, não por campanha, o que transforma um fluxo de descadastro desleixado numa responsabilidade real em volume. O um clique baseado em cabeçalho e o link do rodapé exigido por lei são duas obrigações distintas que por acaso apontam na mesma direção.

O alentador é que aqui o cumprimento e a boa prática convergem por completo. Não há versão disto em que a escolha ótima para a entregabilidade e a escolha respeitosa com o destinatário divirjam: a mesma saída sem atrito que o mantém abaixo do limiar de reclamações é também a que respeita a pessoa que já não quer o seu e-mail. Esse alinhamento é raro o bastante em entregabilidade para ser nomeado — a maioria das alavancas implica um compromisso, e esta não.