Pular para o conteúdo principal
Gerenciar como os usuários cancelam a inscrição dos seus emails é fundamental para cumprir padrões de email (como CAN-SPAM), garantir forte entregabilidade com provedores como Gmail e Yahoo, e construir confiança com seu público. O OneSignal suporta tanto links de cancelamento visíveis quanto cabeçalhos List-Unsubscribe, garantindo que seus emails estejam totalmente em conformidade enquanto lhe dá controle sobre quando e como os usuários podem optar por não receber.

Estados de inscrição e lógica de supressão

Subscriptions de email podem estar:
  • Subscribed – elegíveis para receber mensagens de email.
  • Unsubscribed – excluídas da maioria dos envios de email, a menos que explicitamente substituído.
Para incluir Subscriptions canceladas no seu email (por exemplo, para mensagens transacionais):

Habilitar envio para usuários cancelados


Como usuários têm a inscrição cancelada

O status de inscrição de email é atualizado via:
  • Cabeçalho List-Unsubscribe: Um cabeçalho de email oculto usado por provedores de caixa de entrada para exibir botões nativos de “Cancelar inscrição” (por exemplo, Gmail, Yahoo).
  • Link de cancelamento: Uma URL clicável visível colocada no conteúdo do seu email usando o token [unsubscribe_url].

Comportamento do cabeçalho List-Unsubscribe

O OneSignal inclui um cabeçalho List-Unsubscribe em todos os emails exceto quando você habilita “Include sending to unsubscribed users.” Isso ajuda a:
O cabeçalho List-Unsubscribe não é incluído se você habilitar “Include sending to unsubscribed users.”Alguns provedores de caixa de entrada podem ocultar este cabeçalho da exibição a menos que você atinja certos limites de volume de envio. Veja os requisitos do Gmail e do Yahoo.
Se um usuário clicar nisto, sua Subscription de email será marcada como cancelada no seu app OneSignal. O OneSignal fornece o token [unsubscribe_url], que insere um link de cancelamento visível no conteúdo do seu email. Você também pode criar uma experiência com sua marca usando sua própria página de cancelamento. Veja Criar uma página de cancelamento personalizada.

Editor HTML

Se estiver usando nosso editor HTML, o template padrão inclui um link de cancelamento automaticamente:

Editor HTML com link de cancelamento padrão

Para adicioná-lo manualmente (por exemplo, via API com email_body):
HTML
<a href="[unsubscribe_url]">Unsubscribe</a>

Editor de arrastar e soltar

Em um bloco de texto:
  1. Clique em Special Links > Suppression > Unsubscribe
  2. O placeholder [unsubscribe_url] é inserido
  3. Você pode destacar texto antes de inserir para transformá-lo em um link

Link de cancelamento no editor Drag & Drop

Sempre torne os links de cancelamento altamente visíveis com tamanhos de fonte legíveis (pelo menos 12px) e forte contraste. Links ocultos ou difíceis de encontrar podem levar os usuários a marcar suas mensagens como spam, prejudicando a entregabilidade futura.

Você pode substituir [unsubscribe_url] pela sua própria página de destino de cancelamento. Para fazer isso:
Se estiver usando um link personalizado, o OneSignal não marcará automaticamente o usuário como cancelado. Você deve lidar com isso através da API ou comportamento da página.

FAQ

Se o seu domínio de envio de email OneSignal ainda não foi verificado, os links de cancelamento em emails de teste não funcionarão. Você verá um texto placeholder, mas nenhum link real. Uma vez que seu domínio seja verificado, os links de cancelamento serão renderizados e funcionarão corretamente.

Como reinscrevo um endereço de email?

Usuários podem ser reinscritos de três maneiras:
  1. Dashboard: Vá para Audience > Subscriptions > Options > Resubscribe to Email
  2. API: Defina enabled: true nas APIs Create User ou Update subscription
  3. Importação CSV: Defina subscribed = yes ao importar endereços de email
Se você usa um provedor de email terceiro (ESP), verifique a lista de supressão deles e remova o endereço lá também.
Se você está usando ESPs como Mailgun ou SendGrid, eles podem inserir seu próprio link de cancelamento. Você pode desabilitar isso nas configurações do seu ESP para evitar duplicação.

Cliques em cancelamento contam para análises?

  • Clicar no [unsubscribe_url] personalizado do OneSignal não conta para análises de cliques.
  • Clicar em uma URL de cancelamento personalizada será contado como um clique. Veja URLs, Links e Deep Links para mais detalhes.

Artigos relacionados