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.
- No dashboard: Habilite Advanced Settings > Include sending to unsubscribed users ao enviar um email.
- Na API: Use a propriedade
include_unsubscribedna API de criação de notificação por email.

Habilitar envio para usuários cancelados
Como usuários têm a inscrição cancelada
O status de inscrição de email é atualizado via:- O usuário clicando em um link de cancelamento ou cabeçalho List-Unsubscribe
- Você importando um CSV de endereços de email e definindo
subscribedcomono. - Você definindo
enabled : falsevia as APIs Create user, Update user, ou Update subscription. - Você cancelando manualmente a inscrição em Audience > Subscriptions > Options > Unsubscribe from Email
Cabeçalho de cancelamento vs link de cancelamento
- 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çalhoList-Unsubscribe em todos os emails exceto quando você habilita “Include sending to unsubscribed users.” Isso ajuda a:
- Prevenir que seus emails sejam marcados como spam
- Cumprir com as regras do Gmail/Yahoo 2024.
Se um usuário clicar nisto, sua Subscription de email será marcada como cancelada no seu app OneSignal.
Adicionando links de cancelamento em emails
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
email_body):
HTML
Editor de arrastar e soltar
Em um bloco de texto:- Clique em Special Links > Suppression > Unsubscribe
- O placeholder
[unsubscribe_url]é inserido - 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.
Destinos de link de cancelamento personalizados
Você pode substituir[unsubscribe_url] pela sua própria página de destino de cancelamento.
Para fazer isso:
- Siga os passos em Criar uma Página de Cancelamento Personalizada.
- Substitua
[unsubscribe_url]no seu email pela URL da sua página de cancelamento personalizada.
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
Por que o link de cancelamento não está funcionando no meu email de teste?
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:- Dashboard: Vá para Audience > Subscriptions > Options > Resubscribe to Email
- API: Defina
enabled: truenas APIs Create User ou Update subscription - Importação CSV: Defina
subscribed = yesao 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.
Por que há dois links de cancelamento no meu email?
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
- Criar uma Página de Cancelamento Personalizada
- Email Messaging
- API de Email
- URLs, Links e Deep Links