Todos os produtos
Search
Central de documentação

Direct Mail:One-click unsubscribe

Última atualização: Jun 27, 2026

O recurso de cancelamento de inscrição com um clique coleta solicitações de cancelamento e filtra automaticamente os destinatários que optaram por sair das listas de envios futuros. Isso reduz reclamações de spam, melhora a reputação do remetente e aumenta as taxas de entrega na caixa de entrada.

Esse recurso está em conformidade com as RFCs 2369 e 8058. Grandes provedores, como Google, Microsoft e Yahoo, oferecem suporte total a ele.

Nota

A exibição do botão de cancelamento de inscrição depende da política do cliente de e-mail do destinatário. O Gmail, por exemplo, pode ocultá-lo para domínios com baixa reputação.

O Direct Mail adiciona um link de cancelamento de inscrição aos cabeçalhos do e-mail, filtra mensagens futuras para destinatários que cancelaram a inscrição e fornece APIs para gerenciamento de listas.

Mecanismo do link de cancelamento de inscrição

O sistema adiciona o link de cancelamento de inscrição ao campo List-Unsubscribe no cabeçalho do e-mail, sem afetar o conteúdo da mensagem.

Por padrão, o Direct Mail gera um link de cancelamento de inscrição para destinatários no Google, ProtonMail, Feishu Mail e em domínios que contenham as palavras-chave "gmail", "yahoo", "google", "aol.com", "hotmail", "outlook" ou "ymail.com". Nenhum link é gerado para contas do Microsoft 365.

Nota

Não há geração de link de cancelamento de inscrição para e-mails enviados a partir de um endereço de gatilho.

Exemplo: Gmail

  • Cabeçalho de e-mail relevante

image

image

  • Exibição no cliente de e-mail

Método 1: Cancelamento de inscrição com um clique

O cabeçalho do e-mail deve conter List-Unsubscribe-Post: List-Unsubscribe=One-Click.

Existem duas opções de implementação:

  • Defina o cabeçalho X-AliDM-Settings. O Direct Mail configura automaticamente os cabeçalhos List-Unsubscribe-Post e List-Unsubscribe.

    Nota

    Configure o X-AliDM-Settings seguindo as instruções em Controlar recursos usando configurações de cabeçalho de e-mail via SMTP.

  • Use uma URL personalizada: inclua o cabeçalho List-Unsubscribe-Post: List-Unsubscribe=One-Click e seu próprio link de cancelamento de inscrição no campo List-Unsubscribe ao enviar via SMTP.

image

image

Método 2: Redirecionamento para uma página web de cancelamento de inscrição

O cabeçalho do e-mail não deve conter List-Unsubscribe-Post: List-Unsubscribe=One-Click.

  • Use uma URL personalizada: omita o cabeçalho X-AliDM-Settings e forneça seu link de cancelamento de inscrição no cabeçalho List-Unsubscribe ao enviar via SMTP.

image

image

Filtragem da lista de cancelamento de inscrição

Quando um destinatário cancela a inscrição, o sistema adiciona o endereço dele à sua lista de cancelamentos. A cada envio, o Direct Mail verifica essa lista no nível de filtro configurado e bloqueia a entrega para os endereços listados. As solicitações de cancelamento de inscrição entram em vigor em até uma hora. Três níveis de filtro estão disponíveis:

Nível de endereço do remetente: bloqueia a entrega se o destinatário cancelou a inscrição do endereço de remetente específico.

Nível de domínio do remetente: impede a entrega caso o destinatário tenha cancelado a inscrição de qualquer endereço no domínio do remetente. Recomendado para domínios que enviam e-mails em massa, pois permite separar os cancelamentos de e-mails promocionais dos transacionais.

Nível de conta: bloqueia a entrega se o destinatário cancelou a inscrição de todos os endereços de remetente associados à sua conta na nuvem. Indicado quando todos os endereços de remetente são utilizados para campanhas promocionais.

Geração de links e filtragem por cenário:

Cenário

Geração de link (LinkType)

Filtragem (FilterLevel)

E-mail em massa

Sim

Nível de endereço do remetente

Endereço de gatilho

Não

Sem filtragem

Cancelamento de inscrição com um clique implementado pelo usuário

Manter o link do usuário

Sem filtragem

Definido pelo usuário

Definido pelo usuário

Definido pelo usuário

Nota

Para definir configurações personalizadas:

  1. Ao enviar via SMTP, configure o link de cancelamento de inscrição e o nível de filtro seguindo Controlar recursos usando configurações de cabeçalho de e-mail via SMTP.

  2. Ao enviar pela API, utilize a API SingleSendMail ou BatchSendMail.

Gerencie a lista de cancelamento de inscrição

Cancelar inscrição

Os destinatários cancelam a inscrição clicando no botão Unsubscribe no cliente de e-mail.

Caso o cliente de e-mail não exiba um link de cancelamento de inscrição, os destinatários podem encontrá-lo nos cabeçalhos brutos da mensagem.

image

image

Nota

O idioma da página de cancelamento de inscrição é determinado pelas configurações do navegador ou sistema operacional do destinatário, e não pelo parâmetro lang presente no link.

Gerenciamento de cancelamentos de inscrição

Se um destinatário cancelar a inscrição acidentalmente, acesse o console do Direct Mail e navegue até data analytics > Unsubscribes para remover a entrada.

image

Como alternativa, o destinatário pode acessar novamente o link de cancelamento de inscrição e clicar em Resubscribe para ser removido automaticamente da lista.

image

Não remova destinatários da lista de cancelamento de inscrição, a menos que tenham cancelado por engano. Reinscrever usuários sem consentimento pode gerar altas taxas de reclamação, resultando no bloqueio do seu endereço ou domínio de remetente e na redução das taxas de entrega para todos os destinatários.

Evite enviar e-mails de marketing, assinatura ou promocionais para destinatários que cancelaram a inscrição. Para e-mails transacionais, como códigos de verificação, utilize um endereço de gatilho.

APIs relacionadas: UnblockRecipient

QueryUnsubscribeList