Referencia
Estados de los emails
Todos los estados de email de Emailit, qué significa cada uno, si todavía puede cambiar, qué evento de webhook envía y qué hacer a continuación.
Cada email tiene un estado que indica en qué punto de su ciclo de vida se encuentra. Esta página lista los 14 estados, cómo pasa un email de uno a otro y qué hacer cuando un email se detiene donde no esperabas. El estado es solo la situación más reciente; el historial completo está en la página de detalles del email y en los eventos.
Referencia de estados
«Final» significa que Emailit ya no cambiará el estado por su cuenta. Un email en un estado final todavía se puede reintentar, lo que crea un email nuevo con un ID nuevo.
| Estado | Texto emergente del panel | Final | Evento de webhook | Significado y qué hacer |
|---|---|---|---|---|
accepted |
Accepted for delivery | No | email.accepted |
Guardado y en cola para la entrega. Normalmente avanza en cuestión de segundos. Los emails enviados por SMTP no emiten email.accepted. |
scheduled |
Scheduled for delivery in the future | No | email.scheduled |
Esperando a su hora de scheduled_at. Puedes cambiar la hora o cancelarlo hasta 3 minutos antes de que toque enviarlo. |
delivered |
Delivered to the recipient’s mail server | No | email.delivered |
El servidor receptor ha aceptado el mensaje. Todavía puede pasar a loaded o clicked, y un informe de rebote o una queja posteriores pueden cambiarlo a bounced o complained. |
loaded |
Email content was loaded by the recipient | No | email.loaded |
Se ha cargado la imagen de seguimiento (una apertura). Necesita el seguimiento de cargas en un dominio de seguimiento verificado. |
clicked |
A link in the email was clicked | No | email.clicked |
Se ha hecho clic en un enlace con seguimiento. Necesita el seguimiento de clics en un dominio de seguimiento verificado. |
attempted |
Delivery attempted but resulted in a temporary failure | No | email.attempted |
El servidor receptor ha respondido con un error temporal. Emailit lo reintenta automáticamente; consulta el calendario de reintentos. |
bounced |
Email permanently failed to deliver | Sí | email.bounced |
El servidor receptor ha rechazado el mensaje de forma permanente, ha llegado más tarde un informe de rebote o se han agotado los reintentos. Comprueba la dirección antes de volver a enviarle nada. Para saber cuándo se bloquea la dirección automáticamente, consulta Rebotes y quejas. |
failed |
Failed to deliver due to a specific error | Sí | email.failed |
Un error de procesamiento, no una respuesta del servidor del destinatario. Poco habitual. Reinténtalo con la API. |
rejected |
Accepted for delivery but rejected after | Sí | email.rejected |
Emailit se ha negado a enviarlo después de aceptarlo, porque un espacio de trabajo sin verificar solo puede enviar a los miembros. |
suppressed |
Recipient is on the suppression list | Sí | email.suppressed |
No se ha enviado porque la dirección está en tu lista de direcciones bloqueadas. Elimina el bloqueo solo si estás seguro, y después reinténtalo. |
received |
Incoming email was accepted | Sí | email.received |
Se ha recibido un mensaje entrante en tu subdominio de entrada. |
complained |
A complaint was registered for this email | Sí | email.complained |
El destinatario lo ha marcado como spam y su proveedor lo ha notificado. La dirección se añade a las direcciones bloqueadas, salvo que tu configuración de bloqueo automático excluya las quejas. No vuelvas a enviarle emails. |
canceled |
Canceled: pulled from the send queue when possible | Sí | email.canceled |
Lo has cancelado en el panel o con la API. La cancelación se hace sin garantía. |
held |
Email is being held | Sí | email.held |
Emailit no lo ha enviado. Consulta por qué se retiene un email, corrige la causa y reinténtalo. |
Los webhooks reciben email.canceled y email.held cuando están suscritos a todos los eventos, o cuando los añades a la lista de eventos del webhook con la API. Consulta Tipos de eventos.
Ciclo de vida
La mayoría de los emails siguen este recorrido:
- Creación. Un envío por API crea el email como
accepted, o comoscheduledcuandoscheduled_ates una hora futura. Los envíos por SMTP también empiezan comoaccepted. El correo entrante se crea comoreceivedy no cambia nunca. - Comprobación. Antes de cada intento de entrega, Emailit comprueba el espacio de trabajo, el dominio, la clave de API, los créditos, la lista de direcciones bloqueadas y la puntuación de spam. Si una comprobación falla, el email termina como
held,rejectedosuppressedsin enviarse. - Entrega o aplazamiento. El intento de entrega tiene éxito (
delivered), falla temporalmente (attempted, y se reintenta) o falla de forma permanente (bounced). - Interacción. Si el seguimiento está activado, las aperturas y los clics hacen pasar un email entregado a
loadedy después aclicked. - Informes tardíos. Un informe de rebote que llega después de la entrega cambia el estado a
bounced. Una queja por spam lo cambia acomplained.
En cualquier momento antes de la entrega, un email scheduled, accepted o attempted puede pasar a canceled.
La escala de interacción
Los estados de entrega y de interacción solo avanzan:
accepted, scheduled o attempted → delivered → loaded → clicked
Un evento posterior nunca hace retroceder un email en la escala. Si se registra un clic, el email se queda en clicked aunque lleguen más aperturas. Una apertura o un clic pueden saltarse delivered, porque demuestran que el mensaje ha llegado. Los estados que ponen fin a la entrega (bounced, failed, rejected, suppressed, complained y canceled) nunca se sobrescriben con aperturas ni clics.
Calendario de reintentos de attempted
Cuando un servidor receptor responde con un error temporal (una respuesta 4xx como 421 o 451, un tiempo de espera agotado o un error de conexión), el email pasa a attempted y Emailit lo vuelve a intentar. Cada espera dura el doble que la anterior:
| Después del intento fallido | Siguiente paso |
|---|---|
| 1 | Volver a intentarlo al cabo de 10 minutos |
| 2 | Volver a intentarlo al cabo de 20 minutos |
| 3 | Volver a intentarlo al cabo de 40 minutos |
| 4 | Volver a intentarlo al cabo de 80 minutos |
| 5 | Volver a intentarlo al cabo de 160 minutos |
| 6 | Volver a intentarlo al cabo de 320 minutos |
| 7 | Esperar 640 minutos y después marcar el email como bounced |
Son 7 intentos de entrega a lo largo de unas 21 horas. Cuando se agotan, el email se marca como bounced con «Maximum number of delivery attempts (7) has been reached», y el destinatario se añade a las direcciones bloqueadas con el motivo too many soft fails, salvo que tu configuración de bloqueo automático de direcciones excluya los rebotes.
Cada intento aparece en la pestaña Deliveries del email con la respuesta del servidor, y cada uno envía un evento email.attempted que incluye smtp_code, smtp_enhanced_code y smtp_response. Algunas respuestas temporales que indican claramente un problema permanente, como un buzón desactivado, se tratan directamente como rebotes. Cuando un proveedor está limitando los envíos, Emailit también puede pausar brevemente la entrega a ese proveedor; esas filas dicen «Delivery delayed due to…».
Por qué se retiene un email
Un email retenido se ha sacado de la cola de envío sin enviarse. La pestaña Deliveries del email muestra qué motivo se ha aplicado:
| Motivo | Mensaje en la pestaña Deliveries | Qué hacer |
|---|---|---|
| Espacio de trabajo suspendido | Mail server has been suspended. No e-mails can be processed at present. Contact support for assistance. | Consulta Salud de envío y contacta con soporte. |
| Dominio de envío pausado | Sending from this domain is paused. Contact support for assistance. | La tasa de rebote del dominio era demasiado alta. Consulta Salud de envío. |
| Créditos insuficientes | Workspace has not enough email credits to send this email. | Compra créditos o activa la recarga automática. |
| Puntuación de spam demasiado alta | Held because Rspamd scored this message 8.4, which is at or above the threshold of 7. | Lee las comprobaciones de spam del email, corrige el contenido y reinténtalo. |
| Clave de API configurada para retener | Credential is configured to hold all messages authenticated by it. | Los mensajes enviados con esta clave se retienen a propósito. Contacta con soporte. |
Los emails retenidos no se liberan automáticamente. Después de corregir la causa, selecciona Retry en el email o llama a Reintentar un email. Al reintentar se crea un email nuevo con el mismo contenido y se vuelven a cobrar créditos.
Por qué se rechaza un email
Hasta que tu espacio de trabajo tiene acceso de producción, solo puedes enviar a los emails de cuenta de los miembros del espacio de trabajo. Para los demás destinatarios, la API devuelve 403 y SMTP devuelve 550 en el momento del envío, así que casi siempre ves el error en lugar de un email. El estado rejected aparece cuando la misma comprobación falla más tarde, en el momento de la entrega, por ejemplo en un email que se programó antes. La pestaña Deliveries muestra «Unverified workspaces can only send to workspace members’ account emails» y la dirección bloqueada.
Reglas de reintento
| Botón Retry del panel | API Reintentar un email | |
|---|---|---|
| Estados | held, suppressed |
bounced, failed, suppressed, held |
| Antigüedad | Menos de 30 días | Menos de 30 días |
| Contenido | No debe haberlo purgado la retención de datos | No debe estar purgado |
| Resultado | Un email nuevo con un ID nuevo; el original no cambia | Lo mismo; la respuesta incluye original_id |
En un email bloqueado, quita primero la dirección de tu lista de direcciones bloqueadas; si no, el reintento se vuelve a bloquear.