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.
Flujos típicos
Sección titulada «Flujos típicos»queued → sending → sent → deliveredqueued → sending → sent → bouncedqueued → sending → (retry …) → sentqueued → sending → (failover to fallback service) → sentqueued → sending → failedheld → (credits added) → queued → sending → sentheld → (hold duration over) → discardedqueued → sending → (auth error, no fallback) → held_service_error → (service fixed) → queued → …Eventos de la cronología
Sección titulada «Eventos de la cronología»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.
Conservación
Sección titulada «Conservació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.