---
title: Supressões
description: A lista de endereços que o BillionSend não vai mais escrever, para proteger a reputação do seu remetente.
ai:
  exclude: true
---

A lista de supressão guarda endereços que não devem receber e-mails, para você nunca enviar repetidamente a um endereço que deu bounce ou marcou você como spam. Ela protege sua reputação e seus [limites de envio](/docs/pt-br/concepts/sending-limits). No painel, fica em **Público → Supressões**.

## Como os endereços entram na lista

- **Hard bounce.** O servidor de destino recusou o endereço de forma permanente. Soft bounces não contam.
- **Reclamação.** O destinatário marcou um e-mail como spam.
- **Endereço inválido.** A [verificação](/docs/pt-br/concepts/verification) profunda da lista descobriu que nenhuma caixa responde ali.
- **Caixa cheia.** A caixa de um contato informa estar cheia duas vezes, com 1 a 30 dias de intervalo.
- **Manual.** Você adicionou, no painel ou pela API.

Bounces e reclamações são adicionados automaticamente. A lista é por equipe e tem uma entrada por endereço. Ela descreve o endereço, não uma marca: um endereço que não existe é o mesmo fato, qualquer que seja o seu domínio que escreva a ele.

Um destinatário que clica em descadastrar não entra aqui. Essa escolha é registrada como um [descadastro](/docs/pt-br/concepts/unsubscribes) do domínio cujo e-mail trazia o link, e só interrompe e-mails de marketing. A lista de supressão interrompe todos os e-mails ao endereço, inclusive os transacionais.

## O que ela faz

- **Todo envio** pula os destinatários suprimidos: `POST /emails`, o relay SMTP, envios com tópico e transmissões. Eles são removidos de `to`, `cc` e `bcc`.
- **Se todos os destinatários estão suprimidos,** o envio é recusado com `422 all_recipients_suppressed`. O relay SMTP responde `550`. Quando isso esvazia um envio de `POST /emails`, o BillionSend guarda um registro com status `suppressed` e sem conteúdo, que não conta no seu volume, e envia o [webhook](/docs/pt-br/concepts/webhooks) `email.suppressed`.
- **E-mails que esperam** são conferidos de novo quando saem, então um e-mail agendado pula endereços suprimidos nesse meio-tempo.
- **Transmissões** pulam os contatos suprimidos.

Toda mudança na lista envia um webhook `suppression.added` ou `suppression.removed`.

## Revisar e remover

O painel lista cada endereço com o motivo e a data. Os descadastros dos destinatários ficam em outra aba, cada um com seu domínio.

Você pode remover um endereço para voltar a enviar. Faça isso só quando souber que a causa foi resolvida, por exemplo uma caixa que sempre existiu mas foi recusada por um servidor mal configurado. O endereço volta a ser suprimido no próximo bounce ou reclamação.

## API

Os SDKs chamam os endpoints `/suppressions` como `suppressions.*`. Cada entrada é `{ id, email, origin, source_id, created_at }`. `origin` é `bounce`, `complaint` ou `manual`, e `source_id` é o e-mail cujo bounce ou reclamação criou a entrada.

```bash
curl -X POST https://api.billionsend.com/suppressions \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "user@example.org" }'
```

- `GET /suppressions?origin=bounce` lista as entradas, da mais nova à mais antiga, opcionalmente por origem.
- `GET /suppressions/{id}` e `DELETE /suppressions/{id}` aceitam o id da entrada ou o endereço de e-mail.
- `POST /suppressions` adiciona um endereço. O `origin` opcional (`bounce`, `complaint` ou `manual`, padrão `manual`) permite trazer o histórico de bounces e reclamações de outro provedor. Adicionar um endereço que já está na lista devolve a entrada existente.
- `POST /suppressions/batch/add` com `{ "emails": [...] }` e `POST /suppressions/batch/remove` com `{ "emails": [...] }` ou `{ "ids": [...] }` aceitam até 1.000 endereços por chamada.

Remover uma entrada exige uma chave criada por um proprietário ou administrador. Veja [Funções da equipe](/docs/pt-br/team-roles).

Um endereço cujos dados pessoais você apagou continua bloqueando envios, mas fica oculto da lista e das buscas por e-mail. Ele continua acessível pelo id, que mostra `"[erased]"` como o e-mail.

## Amazon SES e sua equipe

O Amazon SES mantém uma lista de supressão própria para a sua equipe, separada da de todas as outras: um bounce no seu e-mail nunca bloqueia o e-mail de outra equipe ao mesmo endereço. O SES adiciona bounces e reclamações a ela sozinho. Quando você remove um endereço aqui, ele é removido lá alguns segundos depois. Um envio que o SES recusa por causa da lista dele aparece como bounce permanente com o subtipo `OnTenantSuppressionList`.

Se suas taxas de bounce ou de reclamação subirem demais, o SES pode pausar sua equipe. Os proprietários recebem um e-mail com o motivo do SES, seus e-mails ficam retidos em vez de falhar, e saem quando o SES voltar a habilitar o envio. Veja [Limites de envio](/docs/pt-br/concepts/sending-limits).
