Simplificando los Estados de Correo Electrónico
Los estados de email son una de las partes más importantes de la API: te indican exactamente en qué punto del 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 hacer una limpieza.
Los nuevos estados
Ahora tenemos 12 estados claros, cada uno con un significado y color distintivo:
| Estado | Color | Descripción |
|---|---|---|
| accepted | 🟡 | Aceptado para entrega |
| scheduled | 🟡 | Programado para entrega futura |
| delivered | 🟢 | Entregado al servidor de correo del destinatario |
| bounced | 🔴 | Falló permanentemente (rebote duro) |
| attempted | 🟠 | Se intentó la entrega pero falló temporalmente |
| failed | 🔴 | No se pudo entregar debido a un error específico |
| rejected | 🔴 | Aceptado inicialmente, luego rechazado |
| loaded | 🔵 | El contenido del email fue cargado (seguimiento de apertura) |
| clicked | 🟣 | Se hizo clic en un enlace del email |
| suppressed | ⚪ | El destinatario está en la lista de supresión |
| received | 🟢 | Email entrante fue aceptado |
| complained | 🔴 | Se registró una queja de spam |
Qué cambió de los estados anteriores
Los estados anteriores están obsoletos. Así es como 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 estamos rastreando la carga del contenido del email (no necesariamente que una persona lo abra), attempted es menos ambiguo que softfail, y bounced es universalmente entendido.
Compatibilidad hacia atrás
Todos los emails existentes y sus entregas han sido migrados a los nuevos estados. No verás ningún nombre de estado anterior en los registros de email o entrega, independientemente de cuándo fueron creados.
El único lugar donde los nombres de estados anteriores pueden aparecer aún es en eventos previamente activados y solicitudes de webhook que se enviaron antes de este cambio. Esos payloads históricos son inmutables y conservarán los valores de estado originales con los que fueron creados.
Si estás filtrando o comparando valores de estado en tu código, actualiza tus integraciones para usar los nuevos nombres.
Blog
Las últimas noticias y actualizaciones, directamente desde Emailit.
Mantente al día con los últimos artículos del Blog de Emailit.
