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

# Supressões multicanal

> Lista global de não contatar: proteja sua reputação em e-mail, telefone, Telegram e Instagram.

<Tip>
  **Supressão** = identidade na **lista de não contatar** do workspace. Não é tag nem preferência de marketing. É o **cartão vermelho** que impede o envio antes de gastar crédito ou chamar o provedor.
</Tip>

## O que é uma supressão?

É uma entrada na **lista global** que diz: “não mande mensagem para este e-mail, telefone, @ do Telegram ou @ do Instagram”. O sistema checa essa lista **antes de enfileirar** e **de novo no worker**.

Analogia: imagine um **caderno na portaria** com nomes que não podem receber visitas. Não importa qual carteiro (canal) você escolha — se o nome está no caderno, a mensagem **não sai**.

## Supressão × tag × tópico × unsubscribe

|                        | **Supressão**                  | **Tag**            | **Tópico**                 | **Unsubscribe de e-mail**               |
| ---------------------- | ------------------------------ | ------------------ | -------------------------- | --------------------------------------- |
| Para quê               | **Bloquear** contato em canais | **Marcar** contato | **Consentimento** por tema | Preferência de **marketing** por e-mail |
| Escopo                 | Global no workspace            | Na ficha           | Por assunto (Newsletter…)  | Só e-mail marketing                     |
| Exemplo                | `STOP`, bounce, spam           | `VIP`, `Lead`      | Aceita Promoções           | Clicou “descadastrar”                   |
| Bloqueia SMS/WhatsApp? | **Sim** (se for telefone)      | Não                | Não sozinho                | **Não** automaticamente                 |

<Info>
  `STOP` em SMS cria **supressão global** de telefone (SMS, WhatsApp, RCS e voz). Unsubscribe e one-click de e-mail são **preferências de marketing** — não bloqueiam outros canais sozinhos.
</Info>

## Tipos e canais

Uma entrada tem `type` + `value`, normalizada antes de salvar:

| `type`      | Bloqueia                 |
| ----------- | ------------------------ |
| `email`     | E-mail                   |
| `phone`     | SMS, WhatsApp, RCS e voz |
| `telegram`  | Telegram                 |
| `instagram` | Instagram                |

## Motivos comuns

| Motivo             | Quando usar                                    |
| ------------------ | ---------------------------------------------- |
| `bounce`           | Provedor rejeitou o e-mail de forma permanente |
| `complaint`        | Destinatário marcou como spam                  |
| `opt_out`          | Pediu para não ser contatado (`STOP`, etc.)    |
| `manual`           | Operador adicionou no painel ou API            |
| `invalid`          | Identidade inválida                            |
| `legal`            | Bloqueio exigido por obrigação legal           |
| `provider_blocked` | Provedor bloqueou o destinatário               |

Inclusões são **idempotentes**: a mesma identidade ativa não dispara outro evento `suppression.added`.

## Como funciona na prática

1. Abra **Audiência → Supressões** (membros consultam; OWNER/ADMIN adicionam, importam e removem)
2. Adicione manualmente ou **importe CSV/XLSX** (`type`, `value`, `reason`, `channel`)
3. Na hora do envio ou campanha, contatos suprimidos **não entram na fila**
4. O item termina com `RECIPIENT_SUPPRESSED` — **sem crédito** e **sem chamar o provedor**

<Warning>
  Remover uma supressão **reativa o envio imediatamente**. Se o endereço voltar a gerar bounce ou complaint, pode ser suprimido de novo automaticamente.
</Warning>

## Na API

Escopos `suppressions:read` e `suppressions:write`. Eventos: `suppression.added`, `suppression.removed`, `message.suppressed`.

* [Quick start](/suppressions-api/como-funciona/quick-start)
* [Normalização](/suppressions-api/como-funciona/normalizacao)
* [Escopos da API Key](/suppressions-api/como-funciona/escopos-da-api-key)

## Próximos passos

* [Tags na audiência](/contacts-api/como-funciona/tags-na-audiencia): etiquetas não substituem supressão
* [Campanhas no painel](/contacts-api/como-funciona/campanhas-no-painel): quem está suprimido não entra na fila
* [Tópicos de comunicação](/contacts-api/como-funciona/topicos-de-comunicacao): consentimento por tema