# Gestionar las direcciones bloqueadas

> Consulta, filtra, añade, importa, exporta y elimina direcciones bloqueadas en el panel o con la API, configura el bloqueo automático de direcciones y vuelve a enviar los emails bloqueados.

Esta guía cubre todas las tareas de la lista de direcciones bloqueadas: encontrar entradas, añadirlas de una en una o desde un archivo CSV, exportarlas, eliminarlas y controlar el bloqueo automático de direcciones. Para saber cómo funcionan las direcciones bloqueadas, consulta [Direcciones bloqueadas](/es/docs/suppressions/).

## Antes de empezar

- Cualquier miembro del espacio de trabajo puede gestionar la lista en el panel. Para cambiar la configuración del bloqueo automático se necesita un administrador.
- Para la API, usa una clave de API con **Full Access**.

## Ver y filtrar la lista

**Panel**

  Ve a **Email API → Suppressions**. La tabla lista el **Email**, el **Reason** y el **Created at** de cada bloqueo, de más reciente a más antiguo.

  - **Search** busca coincidencias en la dirección de email y en el motivo.
  - **Filters** añade reglas sobre **Email**, **Reason**, **Type** o **Created at**, como *Type equals complaint*. Pulsa Intro o selecciona **Apply**.
  - **Display options > Edit columns** muestra la columna **Type**.
  - Selecciona el encabezado de una columna para ordenar por ella.

**API**

  Llama a [Listar direcciones bloqueadas](/es/docs/api-reference/suppressions/list/). Puedes filtrar por `email`, `reason`, `type`, `created_at` y `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 una dirección, llama a [Obtener una dirección bloqueada](/es/docs/api-reference/suppressions/get/) con su ID `sup_` o con la dirección de email. Consulta [Filtrado](/es/docs/api-reference/filtering/) para ver todos los operadores.

## Añadir una dirección bloqueada

**Panel**

  1. **Abre la lista.** Ve a **Email API → Suppressions** y selecciona **Add suppression**.

  2. **Introduce los datos.** Escribe el **Email** y, si quieres, un **Reason** que reconozcas más adelante.

  3. **Selecciona Create.** La dirección se añade con el tipo `recipient`, que bloquea todo el correo a esa dirección.

  Para añadir otro tipo, o un bloqueo que caduque, usa la API o una importación CSV.

**API**

  Llama a [Crear una dirección bloqueada](/es/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 | Obligatorio | Descripción |
  | --- | --- | --- |
  | `email` | Sí | La dirección que se va a bloquear. |
  | `type` | No | `recipient` (por defecto), `bounce`, `complaint` o `unsubscribe`. |
  | `reason` | No | Texto libre. |
  | `keep_until` | No | Cuándo caduca el bloqueo: ISO 8601, una marca de tiempo Unix o inglés natural como `in 30 days`. Omítelo para bloquear la dirección para siempre. |

  La misma dirección con el mismo tipo solo se puede añadir una vez. Un duplicado devuelve `409 Suppression already exists for this email and type`.

## Importar un archivo CSV

Usa una importación para trasladar una lista de direcciones bloqueadas desde otro proveedor o para añadir muchas direcciones a la vez.

1. **Prepara el archivo.** Usa un archivo `.csv` con las columnas `email`, `type` y `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` es obligatorio. `type` y `reason` son opcionales.
   - Un `type` vacío o desconocido pasa a ser `recipient`.
   - La fila de encabezado es opcional. Si no la hay, Emailit lee las columnas en el orden `email`, `type`, `reason`.
   - El archivo debe pesar menos de 8 MB y no tener más de 10.000 filas.

2. **Súbelo.** En **Email API → Suppressions**, selecciona **Import** y después elige el archivo o arrástralo a **Select a file or drag it here**.

3. **Comprueba el resultado.** Emailit añade las entradas nuevas y omite las direcciones que ya tienen un bloqueo del mismo tipo. Las filas con direcciones de email no válidas se omiten.

Si tienes más de 10.000 direcciones, divide el archivo. Para importar desde el código, llama a [Crear una dirección bloqueada](/es/docs/api-reference/suppressions/create/) para cada dirección.

## Exportar la lista

1. **Acota la lista.** Si quieres, busca o filtra la lista en **Email API → Suppressions**. La exportación incluye solo lo que se muestra.

2. **Exporta.** Selecciona **Export** y después **Export** en la ventana emergente. Emailit descarga `suppressions.csv`.

El archivo tiene las columnas `email`, `type`, `reason` y `created_at`, y contiene hasta 10.000 filas.

## Eliminar direcciones bloqueadas

Al eliminar un bloqueo, Emailit puede volver a enviar a esa dirección. Asegúrate de que la dirección es válida y de que la persona quiere tu correo, o el siguiente envío puede rebotar o provocar una queja.

**Panel**

  - **Una:** selecciona el icono de la papelera en su fila y confirma.
  - **Varias:** selecciona las filas con las casillas, selecciona **Delete suppressions** y confirma.

**API**

  Llama a [Eliminar una dirección bloqueada](/es/docs/api-reference/suppressions/delete/) con el ID `sup_` o la dirección de email:

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

  Si una dirección tiene bloqueos de más de un tipo, usa el ID `sup_` para eliminar el correcto.

  Para modificar un bloqueo en lugar de eliminarlo, por ejemplo para añadir una fecha de caducidad, llama a [Actualizar una dirección bloqueada](/es/docs/api-reference/suppressions/update/) con `type`, `reason` o `keep_until`. Configura `keep_until` como `null` para quitar la caducidad.

## Configurar el bloqueo automático de direcciones

Emailit añade automáticamente a la lista las direcciones que rebotan o presentan quejas. En Pro y Business, los administradores pueden cambiarlo.

1. **Abre la configuración.** Ve a **Workspace → Settings** y selecciona la pestaña **Suppressions**.

2. **Actívalo o desactívalo.** Usa **Enable automatic suppression**.

3. **Elige qué bloquear.** En **Suppress on**, elige **Bounces and Complaints** (por defecto), **Bounces only** o **Complaints only**.

En Pay as you go y en los planes Custom, el bloqueo automático de direcciones siempre está activado para los rebotes y las quejas. Los controles muestran un distintivo **Pro** y no se pueden cambiar. Los miembros que no son administradores pueden ver la configuración, pero no cambiarla. Consulta [Rebotes y quejas](/es/docs/deliverability/bounces-and-complaints/#automatic-suppression) para saber exactamente cuándo bloquea Emailit una dirección.

## Reintentar los emails bloqueados

Un mensaje que se bloqueó sigue en `suppressed` aunque elimines el bloqueo. Para enviarlo:

1. **Elimina el bloqueo** de la dirección, como se describe más arriba. De lo contrario, el reintento se vuelve a bloquear.

2. **Reintenta el email.** Ábrelo en **Email API → Emails** y selecciona **Retry**, o llama a [Reintentar un email](/es/docs/api-reference/emails/retry/).

Un reintento crea un email nuevo con el mismo contenido y un ID nuevo, y cuesta créditos como cualquier otro envío. Puedes reintentar emails de hasta 30 días de antigüedad, siempre que su contenido siga dentro de tu periodo de [retención de datos](/es/docs/data-retention/).

## Ver también

  - [Direcciones bloqueadas](/es/docs/suppressions/): Tipos, bloqueo automático de direcciones y caducidad.
  - [Rebotes y quejas](/es/docs/deliverability/bounces-and-complaints/): Cuándo bloquea Emailit una dirección.
  - [API de direcciones bloqueadas](/es/docs/api-reference/suppressions/): Todos los endpoints de direcciones bloqueadas.
  - [Verificación de emails](/es/docs/email-verification/): Quita las direcciones incorrectas antes de enviar.

---
Fuente: https://emailit.com/es/docs/suppressions/manage/