Descripción General
Cada email en Emailit tiene un estado que te indica exactamente dónde se encuentra en su ciclo de vida. Hay 12 estados, cada uno con un color y significado específico. El estado siempre refleja la condición más reciente del email.
Referencia de Estados
| Estado | Color | Descripción |
|---|---|---|
| accepted | 🟡 | El email ha sido aceptado para entrega y está siendo procesado. |
| scheduled | 🟡 | El email está programado para ser enviado en un momento futuro especificado por scheduled_at. |
| delivered | 🟢 | El email fue entregado exitosamente al servidor de correo del destinatario. |
| bounced | 🔴 | El email falló permanentemente en su entrega. El servidor de correo del destinatario rechazó el mensaje (rebote duro). |
| attempted | 🟠 | Se intentó la entrega pero resultó en una falla temporal. El sistema puede reintentar automáticamente. |
| failed | 🔴 | El email falló en su entrega debido a un error específico durante el proceso de envío. |
| rejected | 🔴 | El email fue inicialmente aceptado para entrega pero fue rechazado posteriormente. |
| loaded | 🔵 | El contenido del email fue cargado por el destinatario. Se usa para rastrear aperturas y requiere que el seguimiento esté habilitado en el dominio de envío. |
| clicked | 🟣 | Un enlace dentro del email fue clickeado por el destinatario. Requiere que el seguimiento de clics esté habilitado en el dominio de envío. |
| suppressed | ⚪ | La dirección de email del destinatario está en la lista de supresión y el email no fue enviado. |
| received | 🟢 | Se recibió un email entrante en tu dominio. |
| complained | 🔴 | Se registró una queja de spam (bucle de retroalimentación) para este email por parte del destinatario. |
Flujo de Estados
Un email típico pasa por el siguiente flujo:
- accepted — el email ingresa al sistema
- delivered — el servidor de correo del destinatario lo acepta
- loaded — el destinatario abre el email (si el seguimiento está habilitado)
- clicked — el destinatario hace clic en un enlace (si el seguimiento está habilitado)
Si algo sale mal, el email puede terminar en uno de los estados de falla:
- attempted — falla temporal, puede ser reintentado
- bounced — falla permanente, no será reintentado
- failed — error de entrega
- rejected — rechazado después de la aceptación inicial
Emails Programados
Cuando envías un email con una marca de tiempo scheduled_at en el futuro, ingresa al estado scheduled en lugar de accepted. El email será procesado y entregado en el momento especificado.
Puedes cancelar un email programado antes de que sea enviado, o actualizar su hora programada.
Emails Suprimidos
Si el destinatario está en la lista de supresión de tu espacio de trabajo, el email recibirá inmediatamente el estado suppressed y no será entregado. Esto protege tu reputación como remitente evitando direcciones problemáticas conocidas.
Estados de Seguimiento
Los estados loaded y clicked requieren que el seguimiento esté habilitado en tu dominio de envío. Cuando está habilitado:
- loaded se registra cuando se obtiene el píxel de seguimiento en el email
- clicked se registra cuando se sigue un enlace rastreado en el email
Estos estados incluyen metadatos adicionales como la dirección IP del destinatario y el agente de usuario.
Verificar Estado del Email
Puedes verificar el estado actual de cualquier email usando el endpoint Obtener Email, o navegar los estados de email en el Panel de Control de Emailit.