# Descadastros

> Como as pessoas deixam de receber campanhas, o que fazem o link e os cabeçalhos de descadastro, onde os descadastros aparecem nos relatórios e como gerenciar você mesmo os descadastros.

Esta página explica como os destinatários se descadastram das suas campanhas, o que o Emailit adiciona a cada e-mail de campanha para que eles possam fazer isso e como você mesmo pode ver e alterar os descadastros. Ela também explica como os descadastros se relacionam com os e-mails transacionais.

## Três formas de interromper uma campanha

O Emailit verifica três coisas antes de enviar um e-mail de campanha. Cada uma é um tipo diferente de descadastro:

| Nível | Armazenado em | Definido por | Interrompe |
| --- | --- | --- | --- |
| **Inscrição na lista** | O inscrito (`subscribed: false`) | O link de descadastro do destinatário, ou você | Campanhas para essa lista. O link de descadastro desativa todas as listas em que o contato está. |
| **Status de marketing** | O contato (`unsubscribed: true`) | Você, na página de contatos ou pela API | Campanhas para todas as listas. |
| **Supressão** | A lista de supressão | Bounces, reclamações, automações ou você | Campanhas e, com o tipo `recipient`, também todos os outros e-mails. Consulte [Supressões](/pt/docs/suppressions/). |

## Links de descadastro nos e-mails de campanha

### Cabeçalhos adicionados para você

Todo e-mail de campanha inclui estes cabeçalhos, com um link exclusivo do destinatário e da campanha:

```text
List-Unsubscribe: <unsubscribe link>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
```

`List-Unsubscribe-Post` marca o link como de um clique ([RFC 8058](https://www.rfc-editor.org/rfc/rfc8058)). Provedores de e-mail como o Gmail e o Yahoo usam esses cabeçalhos para mostrar o próprio botão **Unsubscribe** ao lado do nome do remetente, e esperam que remetentes de grande volume os incluam. Você não precisa adicionar nem configurar nada.

### O link no seu conteúdo

Coloque também um link de descadastro visível em todas as campanhas, com a tag de mesclagem `{{unsubscribe_url}}`:

```html
<p>
  You're receiving this because you subscribed to Acme news.
  <a href="{{unsubscribe_url}}">Unsubscribe</a>
</p>
```

- No editor **Dragit**, insira-a como link: `{{unsubscribe_url}}` aparece entre os links especiais.
- No editor **Rich-text**, digite `@` e escolha **Unsubscribe URL**.
- No editor **HTML**, digite a tag você mesmo, exatamente como `{{unsubscribe_url}}`, sem espaços dentro das chaves.

A etapa **Send** do assistente de campanha verifica se a tag está presente e mostra “Missing unsubscribe link!” quando ela não está no HTML. O Emailit não bloqueia o envio, mas leis antispam como o CAN-SPAM e o GDPR, e as regras do Gmail e do Yahoo para remetentes de grande volume, esperam um link de descadastro funcional nos e-mails de marketing.

Nos [envios de teste](/pt/docs/campaigns/test-and-schedule/#send-a-test), o link aponta para um endereço de teste e não descadastra ninguém.

## A página de descadastro

Quando um destinatário abre o link de descadastro, o Emailit mostra uma página hospedada e o descadastra na hora. Não é preciso clicar para confirmar.

- **Ele sai de todas as listas.** A inscrição do contato é desativada em todas as listas a que ele pertence, não apenas naquelas para as quais a campanha foi enviada. O contato em si e o status de marketing dele não mudam.
- **Ele pode dizer o motivo.** A página pergunta “Tell us why you're unsubscribing” com as opções **Not interested**, **Too many emails**, **Never signed up**, **This is a spam** e **Other**. Responder é opcional.
- **Ele pode desfazer.** **Resubscribe** reativa a inscrição dele em todas as listas a que ele pertence e mostra “Resubscribe successful!”.

A página não oferece uma central de preferências: as pessoas não podem escolher em quais listas continuar. Se você precisar disso, crie um link para uma página no seu próprio site e atualize as inscrições delas com a API.

Cada descadastro envia um evento `email.unsubscribed` e um evento [`subscriber.updated`](/pt/docs/webhooks/events/subscriber/) para cada lista. Uma reinscrição envia `email.resubscribed` e `subscriber.updated`. Receba-os com [webhooks](/pt/docs/webhooks/) para sincronizar os descadastros com os seus próprios sistemas. Consulte [Tipos de evento](/pt/docs/webhooks/event-types/).

## Descadastros nos relatórios de campanha

Os descadastros feitos pelo link são registrados na campanha que o enviou:

- O card **Unsubscribed** na **Overview** da campanha mostra o número e a parcela dos e-mails enviados.
- A aba **Unsubscribes** lista cada um com **Email**, **First name**, **Last name**, **Reason**, **IP address** e **Unsubscribed At**. Pesquise nela ou filtre por motivo ou data.
- O relatório em PDF inclui um detalhamento **Unsubscribe reasons**.

A coluna **Reason** mostra o motivo registrado com o descadastro, quando houver um. Os motivos registrados aparecem como **Manual**, **Unsubscribe Link** ou **Complaint**.

Os descadastros que você mesmo faz no painel ou pela API alteram a inscrição, mas não ficam vinculados a uma campanha e não aparecem nesses relatórios. Consulte [Relatórios de campanha](/pt/docs/campaigns/reports/).

## Reclamações

Quando um destinatário marca um e-mail de campanha como spam e o provedor de e-mail dele informa isso, o status do e-mail passa a ser **Complained** e, com as configurações padrão de supressão automática, o endereço é adicionado à sua lista de supressão com o tipo `complaint`. As campanhas ignoram endereços suprimidos, então a pessoa não recebe mais campanhas. Consulte [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/).

## Gerenciar os descadastros você mesmo

### No painel

| Para | Faça isto |
| --- | --- |
| Descadastrar ou reinscrever alguém em uma lista | Na página do contato, abra o menu da linha da lista e selecione **Unsubscribe** ou **Resubscribe**. Ou, na página da lista, selecione **Edit** e altere **Subscribed**. |
| Interromper todas as campanhas para alguns contatos | Em **Email Marketing → Contacts**, selecione-os e use **Actions > Unsubscribe**. **Resubscribe** desfaz a ação. |
| Encontrar todos que se descadastraram | Filtre a página de contatos por **Unsubscribed**, ou filtre os inscritos de uma lista por **Subscribed**. |
| Interromper todos os e-mails para um endereço | Adicione-o em **Email API → Suppressions** com o tipo `recipient`. |

### Pela API

Descadastre de uma lista atualizando o inscrito. Você pode usar o endereço de e-mail em vez do ID `sub_`:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "subscribed": false }'
```

Defina o status de marketing de até 100 contatos de uma vez com a [ação em massa](/pt/docs/api-reference/contacts/bulk/) `unsubscribe` ou `resubscribe`, ou de um contato com `unsubscribed` em [Atualizar um contato](/pt/docs/api-reference/contacts/update/):

```bash
curl https://api.emailit.com/v2/contacts/bulk \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "unsubscribe", "ids": ["con_2kq8Vt4xLm7Rz", "con_9fW3pQ1nBc6Yt"] }'
```

Para exportar os seus descadastros, liste os contatos com `unsubscribed=true` ou os inscritos com `subscribed=false`. Consulte [Listar contatos](/pt/docs/api-reference/contacts/list/) e [Listar inscritos](/pt/docs/api-reference/audiences/subscribers/list/).

## E-mails transacionais e descadastros

Os descadastros e o status de marketing controlam apenas as campanhas. Os e-mails que você envia com a [API de e-mail](/pt/docs/email-api/) ou por [SMTP](/pt/docs/smtp/), e os e-mails enviados por [automações](/pt/docs/automations/), continuam chegando às pessoas que se descadastraram. Isso é intencional: recibos, redefinições de senha e avisos da conta precisam continuar funcionando.

Mantenha as coisas assim enviando apenas conteúdo transacional por esses canais. Algumas coisas a saber:

- `{{unsubscribe_url}}` é uma tag de mesclagem de campanhas. Ela não é preenchida em e-mails da API, do SMTP ou de automações, e esses e-mails não recebem os cabeçalhos `List-Unsubscribe` automaticamente.
- Se você enviar e-mails com cara de marketing fora das campanhas, inclua o seu próprio link de descadastro e respeite-o, por exemplo [adicionando uma supressão](/pt/docs/suppressions/manage/) quando alguém pedir para sair.
- Para interromper todos os e-mails para um endereço, incluindo os transacionais, adicione uma supressão com o tipo `recipient`.

> **Dica:** Processe no mesmo dia os pedidos de descadastro que chegam por outros meios, como uma resposta pedindo para ser removido. Descadastrar o contato ou adicionar uma supressão vale imediatamente para a próxima campanha.

## Veja também

  - [Tags de mesclagem](/pt/docs/campaigns/merge-tags/): Todas as tags que você pode usar nas campanhas, incluindo o link de descadastro.
  - [Supressões](/pt/docs/suppressions/): Bloqueie um endereço para todos os envios.

---
Fonte: https://emailit.com/pt/docs/audiences/unsubscribes/