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

# Supresiones multicanal

> Lista global de no contactar: proteja su reputación en email, teléfono, Telegram e Instagram.

<Tip>
  **Supresión** = identidad en la **lista de no contactar** del workspace. No es una etiqueta ni una preferencia de marketing. Es la **tarjeta roja** que impide el envío antes de gastar crédito o llamar al proveedor.
</Tip>

## ¿Qué es una supresión?

Es una entrada en la **lista global** que dice: "no envíe mensaje a este email, teléfono, @ de Telegram o @ de Instagram". El sistema revisa esta lista **antes de encolar** y **de nuevo en el worker**.

Analogía: imagine un **cuaderno en la portería** con nombres que no pueden recibir visitas. No importa qué mensajero (canal) elija — si el nombre está en el cuaderno, el mensaje **no sale**.

## Supresión × etiqueta × tópico × unsubscribe

|                        | **Supresión**                    | **Etiqueta**        | **Tópico**                  | **Unsubscribe de email**               |
| ---------------------- | -------------------------------- | ------------------- | --------------------------- | -------------------------------------- |
| Para qué               | **Bloquear** contacto en canales | **Marcar** contacto | **Consentimiento** por tema | Preferencia de **marketing** por email |
| Alcance                | Global en el workspace           | En la ficha         | Por asunto (Newsletter…)    | Solo email marketing                   |
| Ejemplo                | `STOP`, bounce, spam             | `VIP`, `Lead`       | Acepta Promociones          | Hizo clic en "darse de baja"           |
| ¿Bloquea SMS/WhatsApp? | **Sí** (si es teléfono)          | No                  | No por sí solo              | **No** automáticamente                 |

<Info>
  `STOP` en SMS crea **supresión global** de teléfono (SMS, WhatsApp, RCS y voz). Unsubscribe y one-click de email son **preferencias de marketing** — no bloquean otros canales por sí solos.
</Info>

## Tipos y canales

Una entrada tiene `type` + `value`, normalizada antes de guardar:

| `type`      | Bloquea                  |
| ----------- | ------------------------ |
| `email`     | Email                    |
| `phone`     | SMS, WhatsApp, RCS y voz |
| `telegram`  | Telegram                 |
| `instagram` | Instagram                |

## Motivos comunes

| Motivo             | Cuándo usar                                       |
| ------------------ | ------------------------------------------------- |
| `bounce`           | El proveedor rechazó el email de forma permanente |
| `complaint`        | El destinatario marcó como spam                   |
| `opt_out`          | Pidió no ser contactado (`STOP`, etc.)            |
| `manual`           | Operador agregó en el panel o API                 |
| `invalid`          | Identidad inválida                                |
| `legal`            | Bloqueo exigido por obligación legal              |
| `provider_blocked` | El proveedor bloqueó al destinatario              |

Las inclusiones son **idempotentes**: la misma identidad activa no dispara otro evento `suppression.added`.

## Cómo funciona en la práctica

1. Abra **Audiencia → Supresiones** (miembros consultan; OWNER/ADMIN agregan, importan y eliminan)
2. Agregue manualmente o **importe CSV/XLSX** (`type`, `value`, `reason`, `channel`)
3. Al enviar o en campaña, contactos suprimidos **no entran en la cola**
4. El ítem termina con `RECIPIENT_SUPPRESSED` — **sin crédito** y **sin llamar al proveedor**

<Warning>
  Eliminar una supresión **reactiva el envío de inmediato**. Si la dirección vuelve a generar bounce o complaint, puede suprimirse de nuevo automáticamente.
</Warning>

## En la API

Alcances `suppressions:read` y `suppressions:write`. Eventos: `suppression.added`, `suppression.removed`, `message.suppressed`.

* [Inicio rápido](/es/suppressions-api/como-funciona/quick-start)
* [Normalización](/es/suppressions-api/como-funciona/normalizacao)
* [Alcances de API Key](/es/suppressions-api/como-funciona/escopos-da-api-key)

## Próximos pasos

* [Etiquetas en la audiencia](/es/contacts-api/como-funciona/tags-na-audiencia): las etiquetas no sustituyen la supresión
* [Campañas en el panel](/es/contacts-api/como-funciona/campanhas-no-painel): quien está suprimido no entra en la cola
* [Tópicos de comunicación](/es/contacts-api/como-funciona/topicos-de-comunicacao): consentimiento por tema