Ir al contenido

Estados de los mensajes

Estado Significado Crédito
queued Aceptado y a la espera del proceso de envío reservado
sending El proceso de envío lo está renderizando y comunicándose con el proveedor reservado
sent El proveedor lo ha aceptado consumido
delivered El proveedor ha confirmado la entrega al servidor del destinatario (requiere webhooks) consumido
bounced El servidor del destinatario lo ha rechazado; los rebotes permanentes (hard bounces) añaden la dirección a la lista de supresión consumido
complained El destinatario lo ha marcado como spam; la dirección queda suprimida consumido
failed Error permanente, o los errores temporales agotaron todos los reintentos devuelto (no cuando un servidor SMTP propio puede haber recibido ya el mensaje, ni cuando falla una proporción inusualmente alta de los envíos de la organización)
held Esperando créditos en la cola de correos retenidos ninguno todavía
held_service_error Esperando a que se repare un servicio que no funciona devuelto; se vuelve a reservar al liberarse
discarded Eliminado de la cola de correos retenidos: se agotó el tiempo de retención o alguien lo descartó manualmente ninguno

Al enviar, la API devuelve queued o held. Todo lo demás lo ves con getStatus() / GET /v1/messages/:id, en el Historial o con history() del SDK de Node.

queued → sending → sent → delivered
queued → sending → sent → bounced
queued → sending → (retry …) → sent
queued → sending → (failover to fallback service) → sent
queued → sending → failed
held → (credits added) → queued → sending → sent
held → (hold duration over) → discarded
queued → sending → (auth error, no fallback) → held_service_error → (service fixed) → queued → …

Cada mensaje tiene una cronología de eventos con marcas de tiempo. El detalle del mensaje en el Historial del panel los muestra con estas etiquetas:

Evento Etiqueta en el Historial Significado
held Retenido Guardado en la cola de correos retenidos
released Liberado Liberado de la cola de correos retenidos
queued En cola Esperando al proceso de envío
sending Enviando Entregado al proveedor
sent Enviado El proveedor lo ha aceptado
failover Cambio al servicio de respaldo El servicio principal falló y se usó el de respaldo
retry Reintento programado Un error temporal; habrá otro intento
auto_reply Respuesta automática creada Se creó una respuesta automática para este mensaje
delivered Entregado Entrega confirmada mediante webhook
bounced Rebotado Rebote permanente (estado bounced) o temporal (solo evento; el proveedor sigue reintentando)
complained Marcado como spam El destinatario presentó una queja
opened / clicked Abierto / Clic en un enlace Seguimiento de aperturas y clics del proveedor
failed Fallido Error permanente
refunded Crédito devuelto El crédito reservado volvió a su asignación
discarded Descartado Eliminado de la cola de correos retenidos

opened y clicked son eventos, no estados: un mensaje entregado que se ha abierto sigue en delivered. El seguimiento de aperturas depende del proveedor y de que el destinatario cargue las imágenes, así que tómalo como una estimación.

Los mensajes y su contenido renderizado se conservan durante el periodo de historial del plan con el que se enviaron (de 7 a 180 días, consulta Planes) y después se eliminan.