Cómo funciona el envío

Entiende el pipeline de Publiq: de la llamada de API a la bandeja, con cola, renderizado, entrega y eventos de observabilidad.

Cuando llamas a emails.send, Publiq acepta y encola el correo y devuelve al instante un id con estado queued. El envío real ocurre de forma asíncrona — tu petición no queda bloqueada esperando al proveedor.

El pipeline

  • Aceptación — la API valida la petición (remitente, destinatario, plantilla) y crea el mensaje con estado queued.
  • Renderizado — el cuerpo se arma: plantilla + variables, tracking de apertura/clic y enlace de baja firmado.
  • Entrega — el proveedor envía; el estado pasa a sent y luego delivered (o bounced).
  • Engagement — aperturas y clics se vuelven eventos opened / clicked.
  • Observabilidad — cada transición se vuelve un evento disponible por Webhooks y en el panel.

Por ser asíncrono, un 202 queued significa "aceptado", no "entregado". Usa Webhooks para saber el resultado final de cada correo.

Cómo funciona el envío — Publiq Docs