Guía práctica
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.
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
Ve a Email APISuppressions. 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.
Llama a Listar direcciones bloqueadas. Puedes filtrar por email, reason, type, created_at y keep_until:
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 con su ID sup_ o con la dirección de email. Consulta Filtrado para ver todos los operadores.
Añadir una dirección bloqueada
-
Abre la lista. Ve a Email APISuppressions y selecciona Add suppression.
-
Introduce los datos. Escribe el Email y, si quieres, un Reason que reconozcas más adelante.
-
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.
Llama a Crear una dirección bloqueada:
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.
-
Prepara el archivo. Usa un archivo
.csvcon las columnasemail,typeyreason:email,type,reason ada@example.com,bounce,Hard bounce at previous provider grace@example.com,unsubscribe,Unsubscribed in 2025 alan@example.com,,Requested removalemailes obligatorio.typeyreasonson opcionales.- Un
typevacío o desconocido pasa a serrecipient. - 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.
-
Súbelo. En Email APISuppressions, selecciona Import y después elige el archivo o arrástralo a Select a file or drag it here.
-
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 para cada dirección.
Exportar la lista
-
Acota la lista. Si quieres, busca o filtra la lista en Email APISuppressions. La exportación incluye solo lo que se muestra.
-
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.
- Una: selecciona el icono de la papelera en su fila y confirma.
- Varias: selecciona las filas con las casillas, selecciona Delete suppressions y confirma.
Llama a Eliminar una dirección bloqueada con el ID sup_ o la dirección de email:
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 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.
-
Abre la configuración. Ve a WorkspaceSettings y selecciona la pestaña Suppressions.
-
Actívalo o desactívalo. Usa Enable automatic suppression.
-
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 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:
-
Elimina el bloqueo de la dirección, como se describe más arriba. De lo contrario, el reintento se vuelve a bloquear.
-
Reintenta el email. Ábrelo en Email APIEmails y selecciona Retry, o llama a Reintentar un email.
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.