En un SaaS, el onboarding suele tener una dependencia silenciosa: el email. La persona crea una cuenta, espera un enlace y el equipo interpreta que la activación ocurrió cuando el mensaje salió del backend. Pero un correo puede retrasarse, rebotar o llegar cuando el usuario ya abandonó la página.
Una forma más resistente de construir este flujo es separar la activación del envío. El usuario debe poder avanzar dentro del producto, mientras una cola procesa la bienvenida, la verificación y los recordatorios. El email sigue siendo importante, pero deja de ser el dueño de todo el estado.
El problema: activación atada a una bandeja
El flujo ingenuo es fácil de imaginar:
- El usuario crea una cuenta.
- El servidor envía un email.
- La aplicación marca el onboarding como completo.
El tercer paso es el peligroso. El servidor sabe que pidió un envío, no que el mensaje fue leído ni que el enlace funcionó. Si el proveedor tarda, la interfaz muestra una espera que parece un fallo del producto.
En mis experimentos de producto, separo tres hechos: la cuenta fue creada, el siguiente paso está disponible y el email fue solicitado. Tambien guardo la evidencia de cada uno. Así una métrica de activación no queda mezclada con una métrica de entrega.
Diseña una cola con estados pequeños
No hace falta empezar con una plataforma compleja. Una cola y una tabla de eventos pueden describir el flujo con estados claros:
account_created -> onboarding_ready -> email_queued email_queued -> email_sent | email_retry | email_failed onboarding_ready significa que la persona puede usar la funcionalidad principal del SaaS. email_queued solo indica que existe un trabajo pendiente. Esta distinción parece pequeña, pero evita que un retraso del proveedor bloquee la experiencia.
Cada trabajo debería tener un identificador estable, un tipo de plantilla y una fecha de expiración. El identificador permite que el worker sea idempotente: si recibe el mismo evento dos veces, no crea dos emails ni dos recordatorios.
Un contrato mínimo podría ser así:
{ "event_id": "evt_2048", "account_id": "acc_91", "type": "onboarding.welcome", "template": "welcome-v2", "status": "queued", "attempt": 1 } El campo status no debe ocultar demasiadas situaciones. retry no es lo mismo que failed, y sent no es lo mismo que delivered. Si el proveedor no ofrece confirmación de entrega, registra esa limitación en lugar de inventar certeza.
Un contrato simple para el backend
El endpoint de registro puede responder pronto, sin esperar al proveedor de correo:
crear cuenta guardar evento onboarding_ready encolar email de bienvenida responder 201 Created Luego el worker consume el evento y registra el resultado. Una versión sencilla de la lógica sería:
evento = cola.siguiente() si evento.ya_procesado: confirmar(evento) si no: marcar_como_procesando(evento) resultado = proveedor.enviar(evento) guardar_resultado(evento, resultado) confirmar(evento) Conviene definir también qué pasa cuando el email falla. Un reintento con espera progresiva es razonable para un error temporal; no lo es para una dirección inválida o una plantilla que no existe. El equipo deberia poder consultar el motivo sin abrir el contenido privado del mensaje.
Para una prueba aislada, generar correo desechable ayuda a revisar el asunto, el enlace y la versión de la plantilla. El objetivo es observar el contrato del producto, no probar una bandeja personal. En búsquedas aparecen nombres mal escritos como tempail; pueden servir para entender consultas reales, pero no deben entrar en nombres de estados ni en reglas del backend.
Cómo probar los casos difíciles
Empieza con tests de unidad para las transiciones. Comprueba que un evento repetido no duplica el envío y que un error permanente no se reintenta indefinidamente. Después añade una prueba de integración con una bandeja controlada para verificar el enlace de activación.
También conviene simular tres relojes diferentes:
- El usuario abre la aplicación antes de que salga el email.
- El email llega después de que el usuario complete el onboarding.
- El enlace expira mientras el mensaje sigue visible.
La interfaz debe explicar cada espera. Un botón puede mostrar “procesando” sin prometer que el correo llegó. Para los estados visuales, puedes diseñar estados de carga accesibles. Para comprobar el flujo completo de mensajes, conviene probar emails de onboarding sin ruido.
Una métrica util es medir por separado:
- Tiempo desde el registro hasta
onboarding_ready. - Tiempo desde
email_queuedhastaemail_sent. - Porcentaje de activaciones que no dependieron de abrir el email.
La tercera métrica es especialmente útil para producto. Si sube, quizá la aplicación ya explica mejor el siguiente paso. El email puede seguir ayudando, pero no tiene que cargar con toda la conversión.
Errores comunes y recapitulación
El error más comun es usar email_sent como sinónimo de “usuario activado”. Otro es reintentar todos los fallos con la misma política. Un tercero es borrar los eventos demasiado pronto, justo cuando soporte necesita entender que paso.
Un diseño pequeño y práctico tiene estas reglas:
- La activación principal ocurre dentro del SaaS.
- La cola procesa emails como trabajos independientes.
- Los estados describen hechos observables.
- La idempotencia protege contra duplicados.
- Los tests cubren retrasos, reintentos y expiración.
- Las métricas separan producto de proveedor de correo.
No necesitas resolver cada caso desde el primer día. Empieza con un contrato claro, conserva evidencia suficiente y mejora la cola cuando aparezcan fallos reales. Es mas facil depurar un email tardío cuando la cuenta ya tiene un estado propio y el backend puede contar la historia completa.