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
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.