# Gerenciar supressões

> Veja, filtre, adicione, importe, exporte e exclua supressões no painel ou com a API, configure a supressão automática e reenvie e-mails suprimidos.

Este guia cobre todas as tarefas da lista de supressão: encontrar entradas, adicioná-las uma a uma ou a partir de um arquivo CSV, exportar, removê-las e controlar a supressão automática. Para entender como as supressões funcionam, consulte [Supressões](/pt/docs/suppressions/).

## Antes de começar

- Qualquer membro do workspace pode gerenciar a lista no painel. Alterar as configurações de supressão automática exige um administrador.
- Para a API, use uma chave de API com **Full Access**.

## Ver e filtrar a lista

**Painel**

  Acesse **Email API → Suppressions**. A tabela lista o **Email**, o **Reason** e o **Created at** de cada supressão, das mais recentes para as mais antigas.

  - **Search** pesquisa o endereço de e-mail e o motivo.
  - **Filters** adiciona regras sobre **Email**, **Reason**, **Type** ou **Created at**, como *Type equals complaint*. Pressione Enter ou selecione **Apply**.
  - **Display options > Edit columns** mostra a coluna **Type**.
  - Selecione o cabeçalho de uma coluna para ordenar por ela.

**API**

  Chame [Listar supressões](/pt/docs/api-reference/suppressions/list/). Você pode filtrar por `email`, `reason`, `type`, `created_at` e `keep_until`:

```bash
curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"
```

  Para consultar um único endereço, chame [Obter uma supressão](/pt/docs/api-reference/suppressions/get/) com o ID `sup_` ou o endereço de e-mail. Consulte [Filtragem](/pt/docs/api-reference/filtering/) para ver todos os operadores.

## Adicionar uma supressão

**Painel**

  1. **Abra a lista.** Acesse **Email API → Suppressions** e selecione **Add suppression**.

  2. **Informe os dados.** Digite o **Email** e, se quiser, um **Reason** que você vá reconhecer depois.

  3. **Selecione Create.** O endereço é adicionado com o tipo `recipient`, que bloqueia todos os envios para ele.

  Para adicionar outro tipo, ou uma supressão que expira, use a API ou uma importação de CSV.

**API**

  Chame [Criar uma supressão](/pt/docs/api-reference/suppressions/create/):

```bash
curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'
```

  | Campo | Obrigatório | Descrição |
  | --- | --- | --- |
  | `email` | Sim | O endereço a suprimir. |
  | `type` | Não | `recipient` (padrão), `bounce`, `complaint` ou `unsubscribe`. |
  | `reason` | Não | Texto livre. |
  | `keep_until` | Não | Quando a supressão expira: ISO 8601, um timestamp Unix ou inglês simples, como `in 30 days`. Omita-o para suprimir para sempre. |

  O mesmo endereço e tipo só podem ser adicionados uma vez. Uma duplicata retorna `409 Suppression already exists for this email and type`.

## Importar um arquivo CSV

Use uma importação para trazer uma lista de supressão de outro provedor ou para adicionar muitos endereços de uma vez.

1. **Prepare o arquivo.** Use um arquivo `.csv` com as colunas `email`, `type` e `reason`:

```csv title="suppressions.csv"
email,type,reason
ada@example.com,bounce,Hard bounce at previous provider
grace@example.com,unsubscribe,Unsubscribed in 2025
alan@example.com,,Requested removal
```

   - `email` é obrigatório. `type` e `reason` são opcionais.
   - Um `type` vazio ou desconhecido vira `recipient`.
   - A linha de cabeçalho é opcional. Sem ela, o Emailit lê as colunas na ordem `email`, `type`, `reason`.
   - O arquivo precisa ter menos de 8 MB e no máximo 10.000 linhas.

2. **Envie o arquivo.** Em **Email API → Suppressions**, selecione **Import** e escolha o arquivo ou arraste-o para **Select a file or drag it here**.

3. **Confira o resultado.** O Emailit adiciona as entradas novas e ignora os endereços que já têm uma supressão do mesmo tipo. As linhas com endereços de e-mail inválidos são ignoradas.

Para mais de 10.000 endereços, divida o arquivo. Para importar a partir de código, chame [Criar uma supressão](/pt/docs/api-reference/suppressions/create/) para cada endereço.

## Exportar a lista

1. **Restrinja a lista.** Se quiser, pesquise ou filtre a lista em **Email API → Suppressions**. A exportação inclui apenas o que está sendo mostrado.

2. **Exporte.** Selecione **Export** e depois **Export** no pop-over. O Emailit baixa o arquivo `suppressions.csv`.

O arquivo tem as colunas `email`, `type`, `reason` e `created_at` e contém até 10.000 linhas.

## Excluir supressões

Excluir uma supressão permite que o Emailit volte a enviar para o endereço. Confirme que o endereço é válido e que a pessoa quer receber os seus e-mails, senão o próximo envio pode dar bounce ou gerar uma reclamação.

**Painel**

  - **Uma:** selecione o ícone de lixeira na linha dela e confirme.
  - **Várias:** marque as linhas com as caixas de seleção, selecione **Delete suppressions** e confirme.

**API**

  Chame [Excluir uma supressão](/pt/docs/api-reference/suppressions/delete/) com o ID `sup_` ou o endereço de e-mail:

```bash
curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  Se um endereço tiver supressões de mais de um tipo, use o ID `sup_` para excluir a certa.

  Para alterar uma supressão, por exemplo para adicionar uma data de expiração, chame [Atualizar uma supressão](/pt/docs/api-reference/suppressions/update/) com `type`, `reason` ou `keep_until`. Defina `keep_until` como `null` para remover a expiração.

## Configurar a supressão automática

O Emailit adiciona automaticamente à lista os endereços que dão bounce ou reclamam. No Pro e no Business, os administradores podem alterar isso.

1. **Abra as configurações.** Acesse **Workspace → Settings** e selecione a aba **Suppressions**.

2. **Ative ou desative.** Use **Enable automatic suppression**.

3. **Escolha o que suprimir.** Em **Suppress on**, escolha **Bounces and Complaints** (padrão), **Bounces only** ou **Complaints only**.

No Pay as you go e nos planos Custom, a supressão automática está sempre ativada para bounces e reclamações. Os controles mostram um selo **Pro** e não podem ser alterados. Os membros que não são administradores podem ver as configurações, mas não alterá-las. Consulte [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/#automatic-suppression) para saber exatamente quando o Emailit suprime um endereço.

## Tentar enviar de novo e-mails suprimidos

Uma mensagem bloqueada por uma supressão continua `suppressed` mesmo depois que você exclui a supressão. Para enviá-la:

1. **Exclua a supressão** do endereço, como descrito acima. Caso contrário, a nova tentativa é suprimida de novo.

2. **Tente enviar o e-mail de novo.** Abra-o em **Email API → Emails** e selecione **Retry** ou chame [Tentar enviar um e-mail de novo](/pt/docs/api-reference/emails/retry/).

Uma nova tentativa cria um novo e-mail com o mesmo conteúdo e um novo ID e custa créditos como qualquer outro envio. Você pode tentar enviar de novo e-mails com até 30 dias, desde que o conteúdo deles ainda esteja dentro do seu período de [retenção de dados](/pt/docs/data-retention/).

## Veja também

  - [Supressões](/pt/docs/suppressions/): Tipos, supressão automática e expiração.
  - [Bounces e reclamações](/pt/docs/deliverability/bounces-and-complaints/): Quando o Emailit suprime um endereço.
  - [API de supressões](/pt/docs/api-reference/suppressions/): Todos os endpoints de supressão.
  - [Verificação de e-mails](/pt/docs/email-verification/): Remova os endereços ruins antes de enviar.

---
Fonte: https://emailit.com/pt/docs/suppressions/manage/