Saltar al contenido principal
Conceptos

Ciclo de vida del email

Los estados por los que pasa un email, del POST a la entrega, y los eventos que recibes en cada uno.

Del envío a la entrega

El POST /emails solo pone el email en la cola y responde 202 con el id. El worker lo saca de la cola, lo entrega al relay SMTP y registra cada paso como evento. Consulta los eventos en GET /emails/{id}/events o recíbelos por webhook.

  • queued: aceptado y en la cola.
  • scheduled: programado para scheduledAt.
  • processing: el worker lo está enviando.
  • sent: el relay aceptó el mensaje.
  • delivered: el servidor del destinatario confirmó la recepción.
GET /emails/{id}/events
{  "id": "8f3a2c1b-4d5e-4f60-9a7b-1c2d3e4f5a6b",  "events": [    { "type": "queued", "timestamp": "2026-11-10T17:02:11.204Z" },    { "type": "sent", "timestamp": "2026-11-10T17:02:11.616Z" },    { "type": "delivered", "timestamp": "2026-11-10T17:02:12.398Z" },    { "type": "opened", "timestamp": "2026-11-10T17:05:40.000Z" }  ]}

Desenlaces negativos

No todo email llega. Cuando no llega, el estado final dice por qué y la dirección puede entrar en la lista de supresión automáticamente.

  • bounced: el servidor lo rechazó (un rebote permanente suprime la dirección).
  • complained: el destinatario lo marcó como spam (la dirección se suprime).
  • failed: el envío falló tras los reintentos.
  • skipped: la dirección estaba suprimida y el email no salió.
  • cancelled: la programación se canceló antes del envío.

Interacción

Con el seguimiento activado en el dominio, aperturas y clics se vuelven eventos opened y clicked. No cambian el estado de entrega.