> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Links de cancelamento de inscrição e cabeçalhos de email

> Aprenda como gerenciar o comportamento de cancelamento de inscrição de email no OneSignal, incluindo links de cancelamento, cabeçalhos List-Unsubscribe, regras de supressão e fluxos de reinscrição.

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](./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):

* No dashboard: Habilite **Advanced Settings > Include sending to unsubscribed users** ao enviar um email.
* Na API: Use a propriedade `include_unsubscribed` na [API de criação de notificação por email](/reference/email).

<Frame caption="Habilitar envio para usuários cancelados">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=5bddf440aae0717dc518b8a43789d3da" width="906" height="616" data-path="images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png" />
</Frame>

***

## 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](./import) e definindo `subscribed` como `no`.
* Você definindo `enabled : false` via as APIs [Create user](/reference/create-user), [Update user](/reference/update-user), ou [Update subscription](/reference/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çalho `List-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](https://onesignal.com/blog/guide-to-2024-gmail-and-yahoo-requirements-for-email-senders/).

<Warning>
  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](https://support.google.com/a/answer/81126?visit_id=638683263663552218-2680312485\&rd=1#requirements-5k\&zippy=%2Crequirements-for-sending-or-more-messages-per-day) e do [Yahoo](https://senders.yahooinc.com/best-practices/).
</Warning>

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](./create-custom-unsubscribe-page).

#### Editor HTML

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

<Frame caption="Editor HTML com link de cancelamento padrão">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8b10e10-default_code.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=0c996973cd6335a81dd8854c8e0e355d" width="1309" height="562" data-path="images/docs/8b10e10-default_code.png" />
</Frame>

Para adicioná-lo manualmente (por exemplo, via API com `email_body`):

```html HTML theme={null}
<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

<Frame caption="Link de cancelamento no editor Drag & Drop">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=46180061304abd272dbcef4c85b3b710" width="1114" height="230" data-path="images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png" />
</Frame>

<Info> 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. </Info>

***

## 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](./create-custom-unsubscribe-page).
* Substitua `[unsubscribe_url]` no seu email pela URL da sua página de cancelamento personalizada.

<Warning>
  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.
</Warning>

***

## 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:

1. Dashboard: Vá para **Audience > Subscriptions > Options > Resubscribe to Email**
2. API: Defina `enabled: true` nas APIs [Create User](/reference/create-user) ou [Update subscription](/reference/update-subscription)
3. Importação CSV: Defina `subscribed = yes` ao importar endereços de email

<Warning> Se você usa um provedor de email terceiro (ESP), verifique a lista de supressão deles e remova o endereço lá também. </Warning>

### 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](./links) para mais detalhes.

***

## Artigos relacionados

* [Criar uma Página de Cancelamento Personalizada](./create-custom-unsubscribe-page)
* [Email Messaging](./email-messaging)
* [API de Email](/reference/email)
* [URLs, Links e Deep Links](./links)

***