Saltar al contenido

Ingeniería4 min de lectura

Simplificamos los estados de los emails

Hemos sustituido los antiguos estados de email por un conjunto más claro y coherente. Te explicamos qué ha cambiado y cómo se corresponden los nuevos estados con los anteriores.

GPor

Simplificamos los estados de los emails

Los estados de email son una de las partes más importantes de la API: te indican exactamente en qué punto de su ciclo de vida se encuentra un email. Con el tiempo, nuestro conjunto original de estados creció de forma orgánica y se volvió confuso: ¿cuál es la diferencia entre error y softfail? ¿Es held lo mismo que pending? Decidimos poner orden.

Los nuevos estados

Ahora tenemos 12 estados claros, cada uno con su propio significado y color:

Estado

Color

Descripción

accepted

🟡

Aceptado para su entrega

scheduled

🟡

Programado para entregarse más adelante

delivered

🟢

Entregado al servidor de correo del destinatario

bounced

🔴

Falló de forma permanente (rebote duro)

attempted

🟠

Se intentó la entrega, pero falló temporalmente

failed

🔴

No se pudo entregar por un error concreto

rejected

🔴

Aceptado inicialmente y luego rechazado

loaded

🔵

Se cargó el contenido del email (seguimiento de aperturas)

clicked

🟣

Se hizo clic en un enlace del email

suppressed

⚪

El destinatario está en la lista de direcciones bloqueadas

received

🟢

Se aceptó un email entrante

complained

🔴

Se registró una queja de spam

Qué ha cambiado respecto a los estados anteriores

Los estados anteriores quedan obsoletos. Así se corresponden con los nuevos:

Estado anterior (obsoleto)

Estado nuevo

pending

accepted o scheduled

sent

delivered

held

(eliminado)

hold_cancelled

(eliminado)

softfail

attempted

hardfail

bounced

opened

loaded

error

failed

delayed

(eliminado)

processed

(eliminado)

Los estados renombrados son más descriptivos: loaded deja claro que registramos la carga del contenido del email (no necesariamente que una persona lo abra), attempted es menos ambiguo que softfail y bounced lo entiende todo el mundo.

Compatibilidad con versiones anteriores

Hemos migrado todos los emails existentes y sus entregas a los nuevos estados, así que no verás ningún nombre de estado antiguo en los registros de emails ni de entregas, independientemente de cuándo se crearan.

El único lugar donde aún pueden aparecer los nombres de estado antiguos es en los eventos ya generados y las peticiones de webhook enviadas antes de este cambio. Esos payloads históricos son inmutables y conservarán los valores de estado originales con los que se crearon.

Si filtras o comparas valores de estado en tu código, actualiza tus integraciones para que usen los nuevos nombres.

Compartir

Prueba lo que acabas de leer.

3000 emails al mes gratis. Sin tarjeta de crédito.

3000 emails al mes gratis · Sin tarjeta de crédito