Digite para filtrar os verbetes do Glossário.

    Redes e segurança · Formação DevOps

    O que é List-Unsubscribe?

    O List-Unsubscribe informa endereços para cancelar a inscrição numa lista de email. O descadastro em um clique exige cabeçalhos e processamento próprios.

    Também chamado de: cabeçalho List-Unsubscribe

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    O endereço de descadastro dentro do email

    O List-Unsubscribe é um campo do cabeçalho de email que indica endereços para cancelar a inscrição numa lista. O programa que recebe a mensagem pode interpretar esse campo e oferecer uma ação de descadastro na própria interface. A RFC 2369 define a sintaxe, incluindo endereços entre sinais de menor e maior.

    Os endereços podem oferecer duas formas de contato com o serviço de descadastro: o envio de uma solicitação por email, com mailto:, ou o acesso pela web. Ao receber a solicitação, o serviço precisa identificar a inscrição correta e retirar o destinatário dos próximos envios daquela lista.

    Como funciona o descadastro em um clique

    A RFC 8058 acrescenta uma sinalização específica. Neste exemplo de cabeçalhos, o domínio e o token são ilustrativos:

    List-Unsubscribe: <https://listas.example/cancelar/token-da-inscricao>
    List-Unsubscribe-Post: List-Unsubscribe=One-Click

    O primeiro campo indica o destino. O segundo informa que esse destino aceita o descadastro por uma requisição HTTPS com o método POST e o conteúdo List-Unsubscribe=One-Click. O token permite identificar a lista e o destinatário. A retirada deve ser concluída automaticamente, sem uma página adicional de confirmação.

    Esses dois campos precisam estar cobertos por uma assinatura válida de autenticação de email, a DKIM (DomainKeys Identified Mail). O trecho mostra apenas os cabeçalhos de descadastro e, sozinho, não constitui uma mensagem completa com essa assinatura.

    A separação entre consultar o endereço e enviar o POST evita que uma leitura automática do link seja tratada como a solicitação de um clique. Para conferir a implementação, você pode acompanhar a requisição recebida e verificar se a inscrição foi retirada dos próximos envios. A exibição do botão continua sujeita ao comportamento do cliente de email.

    Dúvidas frequentes

    Perguntas frequentes sobre List-Unsubscribe

    Por que o botão de descadastro pode não aparecer?
    O cliente de email escolhe como apresentar a ação e quais verificações aplicar. A presença do cabeçalho fornece os endereços, mas não obriga todos os clientes a exibir o mesmo botão.
    Um endereço mailto permite o descadastro em um clique da RFC 8058?
    Esse mecanismo exige um endereço HTTPS e o campo List-Unsubscribe-Post. Um endereço mailto pode constar como alternativa, mas usa o envio de email para solicitar o descadastro.
    O descadastro deve exigir login ou confirmação numa página?
    O mecanismo de um clique da RFC 8058 deve concluir a retirada automaticamente. O endereço precisa identificar a inscrição porque a requisição não inclui cookies nem autorização HTTP.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Formação DevOps

    O descadastro exige conferir os cabeçalhos do email e o serviço que retira o destinatário dos próximos envios.

    Conhecer a formação
    Capa da Formação DevOps

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano