FM
FlowMetrics · Documento de Requisitos de Producto
Asistente de Onboarding con IA
Guía interactiva in-app para reducir el drop-off en activación y eliminar el onboarding manual del equipo CS
En revisión
Autora
Laura Dominguez
Engineering Lead
Marc Torner
Design Lead
Sara Ibáñez
Última actualización
16 Jun 2026
Versión
v0.4 — Draft
Feature Flag
ai_onboarding_v1
1
Declaración del Problema
¿Qué problema resolvemos?

Los nuevos usuarios de FlowMetrics abandonan el producto en la primera semana sin haber conectado ninguna fuente de datos ni creado su primer dashboard. Al no experimentar el valor core del producto, no tienen motivos para continuar ni para pagar el plan de pago.

El equipo de Customer Success absorbe ese coste con onboardings manuales de 60-90 min, lo que limita la escala y no es sostenible con el crecimiento previsto.

¿Quién tiene este problema?

Segmento primario: Growth Marketers y Analistas de Marketing de empresas B2B (10-200 empleados) que se registran solos, sin apoyo de IT, y no tienen experiencia previa con herramientas de data integration.

Segmento secundario: CMOs que evalúan la herramienta y necesitan ver valor en <10 minutos para aprobar la compra del equipo.

Evidencia del problema
  • 📊
    Mixpanel: 54% de los nuevos usuarios abandona antes del día 7 sin conectar ningún datasource. Solo el 23% crea un dashboard en los primeros 3 días.
  • 💬
    Intercom: 22 tickets/semana con frases como "cómo conecto Google Ads", "no encuentro el botón de integración" o "a qué se refiere con workspace".
  • 🔬
    Entrevistas usuarios (n=8): 6 de 8 usuarios dijeron que "no sabían por dónde empezar" tras el registro. 5 dijeron que no entendían qué configurar primero.
  • Análisis de churn: El 31% churna en los primeros 30 días. El 89% de ese churn corresponde a usuarios que no crearon ningún dashboard activo.
¿Qué ocurre si NO lo resolvemos?

A un CAC de 320€ y con una ventana de conversión trial→paid del 18%, cada punto de drop-off adicional equivale a ~4.800€ de LTV perdido mensual. Con el objetivo de 3× growth en nuevos signups Q3, el problema se multiplica directamente. El equipo de CS ya no puede asumir más onboardings manuales sin una contratación adicional.

2
Objetivos y Métricas de Éxito
Métrica primaria
Drop-off usuarios D7 sin datasource
54% → 25% en 30 días post-lanzamiento
Métrica secundaria
Tiempo hasta primer dashboard activo
45 min → menos de 12 min (mediana)
Métrica secundaria
Tickets CS de onboarding/semana
22 tickets → menos de 8 tickets
Contra-métrica (no dañar)
Retención D30 de usuarios activados
No debe bajar del 69% actual
Contra-métrica (no dañar)
Tiempo de carga del dashboard principal
Mantener bajo 2.5 segundos (p95)
Métrica secundaria
Tasa de completado del wizard
Objetivo: más del 70% en primeros 14 días

No-Goals — Fuera de Alcance

  • NO rediseñar la arquitectura de navegación general del producto
  • NO construir un help center o centro de documentación (iniciativa separada, Q4)
  • NO aplicar este wizard a cuentas enterprise con onboarding dedicado (CS personalizado)
  • NO incluir integración con Salesforce en V1 (requiere OAuth enterprise, scope Q4)
  • NO construir el componente de IA generativa para sugerencias de dashboards (V2)
3
Visión General de la Solución

Un wizard de onboarding in-app de 4 pasos que aparece en el primer login y acompaña al usuario hasta conectar su primera fuente de datos y ver datos reales en un dashboard preconfigurado. La IA personaliza el flujo según el rol declarado del usuario (Growth Marketer, CMO, Analista de Datos), mostrando plantillas de dashboard y fuentes de datos relevantes para ese perfil.

El wizard es persistente (estado guardado en backend) y accesible desde el menú de usuario en cualquier momento hasta que se marque como completado. Un indicador de progreso "Getting Started" visible en el sidebar actúa como recordatorio pasivo.

Diseño: Figma · AI Onboarding Wizard v3 (ver con Sara Ibáñez) · Prototipo: flowmetrics.figma.com/proto/ai-wizard-v3

4
Historias de Usuario
Growth Marketer · Nuevo signup
Como Growth Marketer que acaba de crear una cuenta, quiero que el producto me guíe paso a paso para conectar mi cuenta de Google Ads y ver mis métricas de campaña en un dashboard, para que pueda entender el valor de FlowMetrics sin necesidad de leer documentación ni esperar a una llamada de onboarding.
Criterios de Aceptación
  • El wizard aparece automáticamente en el primer login, no en los siguientes
  • El paso 1 pregunta el rol del usuario con 3 opciones ilustradas: Growth Marketer, CMO, Analista de Datos
  • Al seleccionar Growth Marketer, el paso 2 sugiere Google Ads y Meta como fuentes prioritarias
  • La conexión OAuth se completa en la misma ventana (sin redirección externa que rompa el flujo)
  • Al finalizar el paso 4, el usuario ve un dashboard preconfigurado con datos reales (o datos de demo si la cuenta no tiene datos aún)
  • El flujo completo puede completarse en menos de 8 minutos según tests de usabilidad con 5 usuarios
I ndependiente
N egociable
V aliosa
E stimable
S mall
T esteable
Usuario que saltó el wizard
Como usuario que cerró el wizard sin completarlo, quiero poder retomarlo desde donde lo dejé accediendo desde el menú de mi perfil, para que no tenga que empezar desde cero ni perder el progreso anterior.
Criterios de Aceptación
  • El indicador "Getting Started" permanece visible en el sidebar hasta completar el wizard
  • Al hacer click en "Getting Started", el wizard se abre en el paso donde fue abandonado
  • Los pasos ya completados aparecen marcados y no requieren re-completarse
  • Si el usuario ya conectó una fuente de datos manualmente, el paso de conexión aparece como completado
CMO · Evaluador del plan team
Como CMO evaluando FlowMetrics para mi equipo, quiero ver un dashboard con datos de mi empresa en menos de 10 minutos desde el registro, para que pueda tomar una decisión informada de compra sin necesitar una demo con ventas.
Criterios de Aceptación
  • Al seleccionar rol CMO, el wizard prioriza HubSpot como primera integración sugerida
  • El dashboard preconfigurado para CMO muestra: pipeline, CAC por canal, MRR y churn en un solo vistazo
  • El wizard ofrece opción "Invitar a mi analista" en el paso final para delegar la configuración avanzada
  • El CTA de fin de wizard muestra el plan Team con el precio y un botón de upgrade
5
Requisitos Detallados

Paso 1 — Selección de Rol

  • 3 opciones de rol con ilustración, descripción de 1 línea y ejemplos de métricas típicas del perfil
  • Selección persistida en el perfil de usuario y usada por el motor de recomendación de integraciones
  • Opción "Otro / prefiero explorar solo" que lleva a un wizard genérico sin personalización IA

Paso 2 — Conexión de Primera Fuente de Datos

  • Máximo 3 integraciones sugeridas (ordenadas por popularidad del rol), con buscador para las 47 integraciones restantes
  • OAuth flow sin redirección externa: ventana modal con iframe controlado por FlowMetrics
  • Estado de sincronización en tiempo real: "Conectando...", "Importando datos...", "¡Listo! 3.847 registros importados"
  • Si la primera conexión falla (timeout >30s): ofrecer "Usar datos de demo" para continuar el flujo sin bloquear

Paso 3 — Configuración de Primer Dashboard

  • 3 plantillas de dashboard preconfiguradas para el rol seleccionado (con preview real de la plantilla)
  • Creación del dashboard es asíncrona — UI optimista ("Tu dashboard está listo") con polling cada 3s
  • Nombre del dashboard auto-sugerido: "[Fuente] — [Rol] Dashboard" (editable antes de crear)

Paso 4 — Primer Valor y CTA

  • El dashboard creado se muestra dentro del wizard antes de salir — el usuario ve datos reales antes de cerrar
  • CTA contextual según rol: CMO → ver plan Team; Growth → ver integraciones avanzadas; Analista → ver API docs
  • Confetti animation al completar (puede desactivarse en Accesibilidad → Reducir movimiento)
  • Tracking: evento wizard_completed con propiedades: rol, pasos_saltados, datasource_conectado, tiempo_total_ms
6
Casos Borde y Manejo de Errores
Escenario Comportamiento esperado Tipo
Usuario recarga la página a mitad del wizard Recupera estado desde backend y retoma desde el paso actual sin pérdida de progreso Estado
OAuth de Google Ads falla (scopes insuficientes) Mensaje de error inline explicando qué permiso falta y enlace a la guía de Google; botón "Reintentar" visible Error
La cuenta de Google Ads conectada tiene 0 datos (cuenta nueva) Wizard detecta 0 registros y ofrece automáticamente continuar con datos de demo sin bloquear el flujo Estado
Usuario que ya tiene datos (re-signup o plan upgrade) Wizard detecta datasources existentes en la cuenta y marca el paso 2 como completado automáticamente Estado
Usuario pulsa botón Atrás del navegador dentro del wizard Navega al paso anterior del wizard (history API), no sale de la aplicación UX
Conexión de internet lenta (<1Mbps) durante sincronización Muestra skeleton loader con estimación de tiempo ("~2 min"), permite "continuar en segundo plano" Error
Usuario en mobile (viewport <768px) Wizard usa layout stack vertical; todos los pasos son completables en móvil (OAuth puede abrir nueva pestaña) UX
Timeout de creación del dashboard (>60s) Muestra error recuperable: "El dashboard está tardando más de lo esperado. Te notificaremos por email cuando esté listo." Error
7
Consideraciones Técnicas
💾
Estado del wizardGuardado en DB (tabla onboarding_state) y sincronizado con localStorage como caché offline. Fuente de verdad: backend.
🚩
Feature flagFlag ai_onboarding_v1 en LaunchDarkly. Rollout gradual por porcentaje de nuevos signups. Sin flag = fallback al onboarding actual.
📡
Tracking de eventosEventos: wizard_started, step_viewed, step_completed, step_skipped, wizard_completed, wizard_abandoned con timestamp y metadata de rol.
🤖
Motor de recomendación IAModelo de scoring interno: input = rol + datos del form de signup (company size, industry). Output = ranking de integraciones sugeridas. Inferencia en backend, <200ms.
Dashboard asíncronoCreación de dashboard dispara job en cola (Bull/Redis). UI polling cada 3s con websocket fallback. Timeout a 60s con notificación email.
AccesibilidadWCAG 2.1 AA. Focus trap en modal del wizard. Animaciones desactivadas con prefers-reduced-motion. Screen reader tested con VoiceOver/NVDA.
8
Plan de Lanzamiento
100%
Dogfood interno
Semana 1 · Equipo FlowMetrics (12 personas)
10%
Beta cerrada
Semana 2 · Nuevos signups aleatorios · Monitor diario
50%
Rollout parcial
Semana 3 · Si métricas D7 positivas · Hold 1 semana
100%
GA
Semana 4 · Todos los nuevos signups

Criterios Go/No-Go

  • Todos los criterios de aceptación de US-01, US-02 y US-03 pasan QA
  • Sin bugs P0 ni P1 abiertos en el momento de activar el flag al 10%
  • Todos los eventos de analytics están disparando correctamente (validado en Mixpanel)
  • CS briefed: Pol Viñas ha revisado los nuevos flujos y actualizado macros de Intercom
  • Plan de rollback documentado y probado en staging
  • Tiempo de carga del wizard validado <2.5s en p95 con Lighthouse CI

Plan de Rollback

Desactivar flag ai_onboarding_v1 en LaunchDarkly → usuarios nuevos vuelven al onboarding actual en <60 segundos, sin migración de datos necesaria. El estado guardado en onboarding_state se mantiene; si se reactiva el flag, el usuario retoma donde lo dejó.

9
Preguntas Abiertas
  • [Producto / CS] ¿Deberíamos ofrecer el wizard también a usuarios que invita un admin (invitados a un workspace existente), o solo a quienes se registran solos? Los invitados ya tienen contexto del producto.
  • [Data / Producto] ¿A/B testamos wizard vs no-wizard con una cohorte de control, o comparamos contra la baseline histórica de las últimas 8 semanas? El equipo de Data necesita decidir esto antes del sprint 1.
  • [Engineering] ¿El motor de recomendación IA usa solo el rol o también señales del form de signup (industry, company size)? Impacta en el modelo de datos y el contrato de la API de onboarding.
  • [Legal / Privacidad] ¿Los datos enviados al motor de recomendación (rol + industry) requieren actualización del aviso de privacidad? Consultar a Adrià antes del lanzamiento al 50%.
  • [Producto] ¿El indicador "Getting Started" del sidebar desaparece al completar el wizard, o se convierte en un "Getting Started Checklist" permanente con tareas avanzadas (ej. invitar a 3 compañeros, crear segundo dashboard)?
10
Timeline
Fase Responsable Duración Fechas
Design review final Sara Ibáñez + Laura 1 semana 16–20 Jun
Spike técnico — OAuth modal Marc Torner 2 días 16–17 Jun
Engineering — Backend + API Backend squad 2 semanas 23 Jun – 4 Jul
Engineering — Frontend wizard Frontend squad 2 semanas 30 Jun – 11 Jul
QA + Accessibility audit QA + Sara 3 días 14–16 Jul
Dogfood interno Todo FlowMetrics 1 semana 17–23 Jul
Rollout gradual 10% → 100% Laura + Pol 2-3 semanas 24 Jul – 13 Ago
Resumen de Esfuerzo
Design Review
1 sem
Engineering
3 sem
QA
3 días
Dogfood
1 sem
Rollout gradual
3 sem