Guías in-app

Las guías son mensajes que se muestran dentro de tu web a los usuarios que tú decides, sin desplegar código: publicas en el panel y aparecen al recargar.

Tipos

• Tooltip: globo anclado a un elemento de tu UI, con flecha. El estándar para tours y explicaciones contextuales.
• Lightbox: ventana centrada con fondo atenuado. Para anuncios que no pueden pasar desapercibidos.
• Banner: barra superior. Avisos globales (mantenimientos, novedades).
• Checklist: widget fijo con tareas y progreso; cada tarea lanza su paso anclado. Ideal para onboarding.

Qué controla una guía

• Pasos: secuencia de contenidos, cada uno anclable a un selector CSS.
• Audiencia: segmento por metadata (tenant.plan, visitor.rol…), páginas donde aparece y frecuencia (siempre / una vez / por sesión).
• Programa: fechas y entorno (staged solo en dominios de prueba).
• Prioridad: si dos guías compiten por el mismo usuario, gana la de menor valor; el throttle de la app limita cuántas se muestran por semana.

Estados y ciclo

borrador → staged (solo se ve en tus dominios de prueba) → publicada (llega a los usuarios al recargar, vía ETag) → pausada → vuelve a publicarse cuando quieras. Cada guardado crea una versión nueva con historial.

Métricas

Impresiones, avances y completación por guía (vista Guías y POST /v1/query/guias). La completación baja es la señal clásica de "demasiados pasos" o "no aporta valor": recórtala.

Consejos

• Textos cortos y un solo concepto por paso.
• Anclas con data-* propios: sobreviven a rediseños.
• Máximo una guía "pesada" (tour) activa a la vez por flujo; el resto, banners y tips puntuales.