## Visión general

Los **tours guiados interactivos** son un recorrido paso a paso superpuesto a la propia pantalla de
Conversa Labs: la plataforma oscurece el fondo, ilumina el elemento en foco (la barra lateral, un
botón) y muestra un globo que explica qué hacer allí. A diferencia del artículo estático "Conociendo
la interfaz", aquí te guían por la interfaz real, haciendo clic y avanzando paso a paso.

Los tours son **sensibles al rol** del usuario: existen tours de primera ejecución diferentes para
**agentes** y para **administradores**, cada uno destacando lo que importa a ese perfil. Además, hay
**tours por módulo** — CRM, Agenda, Pagos, WhatsApp Hub, Contactos, Informes y otros — para que
conozcas cada área a tu ritmo.

## Requisitos previos

- La función **Tours guiados** (`guided_tours`) habilitada para la cuenta. Sin ella no aparece ningún
  tour.
- Usuario con sesión iniciada en la plataforma.
- El conjunto de tours por módulo sigue los módulos habilitados en la cuenta y tu perfil de acceso.

## Paso a paso

1. **Primer acceso**: si el inicio automático está activo, la primera vez que inicias sesión el tour
   de bienvenida comienza solo — el de administrador si eres admin, o el de agente en los demás
   casos.
2. **Avanza por los pasos**: cada paso queda anclado a un punto real de la pantalla (elementos de la
   barra lateral, como Conversaciones y Notificaciones) o centrado (pantallas de bienvenida y de
   cierre). Usa los botones para ir al paso siguiente/anterior.
3. **Mira los videos**: algunos pasos incluyen un video tutorial corto para complementar el texto.
4. **Sal cuando quieras**: puedes omitir o cerrar el tour en cualquier momento.
5. **Reabre un tour**: usa la **barra de comandos (⌘K)** y busca el tour deseado, o haz clic en el
   botón **lanzador de tours** (ícono de birrete) en la barra lateral. Si el tour ya se completó, se
   reproduce de nuevo (replay).
6. **Administra la cuenta**: con el permiso de configuración de la cuenta, ve a **Configuración →
   Onboarding y tours** para activar o desactivar el inicio automático y, tras confirmar, volver a
   presentar los tours a todos.

## Configuración y opciones

- **Progreso por usuario**: el estado de cada tour (completado, descartado o en curso) se guarda en
  tus preferencias (`ui_settings.product_tours`). Un tour en curso se retoma donde lo dejaste.
- **Retomar donde quedaste**: si lo cerraste a la mitad, el tour vuelve al último paso visto.
- **Videos tutoriales por idioma**: los gestiona el operador en **Super Admin → Videos de tour**.
  Cada combinación de paso e idioma (`en`, `pt_BR` o `es`) puede tener su propio video. La plataforma
  solicita el idioma actual del panel; si no hay una versión exacta, usa inglés y después otra
  versión disponible en un orden determinista. Los registros heredados sin idioma siguen funcionando
  hasta que se aplique la migración.
- **Inicio automático por cuenta**: en **Configuración → Onboarding y tours**, el administrador
  decide si los tours no vistos pueden comenzar solos (`custom_attributes.guided_tours.autoplay`).
  Desactivarlo no oculta ni elimina tours: el lanzador, la barra de comandos y la repetición siguen
  disponibles.
- **Reiniciar para toda la cuenta (admin)**: un administrador puede volver a presentar los tours de
  primera ejecución a todos desde **Configuración → Onboarding y tours**. Tras confirmar, el servidor
  registra una marca de fecha
  (`custom_attributes.guided_tours.reset_at`): cualquier progreso anterior a esa fecha se trata como
  "no visto" sin borrar el historial individual. Los tours solo comienzan automáticamente si el
  inicio automático está activo.
- **Nueva versión de un tour**: cuando un tour se actualiza, vuelve a tratarse como nuevo.

## Casos de uso

- **Onboarding de nuevos agentes**: el tour de agente presenta la bandeja de entrada y las
  conversaciones desde el primer acceso, sin capacitación manual.
- **Actualizar al equipo tras una novedad importante**: el administrador reinicia los tours para toda
  la cuenta y todos vuelven a ver la presentación actualizada.
- **Aprender un módulo específico**: abre el tour de CRM, Agenda o Pagos desde el lanzador la primera
  vez que uses esa área.
- **Operar el historial comercial con seguridad (admin)**: el tour de Catálogo muestra dónde
  previsualizar y seleccionar explícitamente ventas anteriores de Hotmart o Kiwify, revisar o
  revertir una importación elegible y consultar o repetir entregas de webhooks del catálogo. El tour
  de Configuración señala el historial de entregas de webhooks de la cuenta; cada paso conserva sus
  controles de rol, permiso y función habilitada.

## Consejos, límites y buenas prácticas

- Puedes **omitir o descartar** el tour en cualquier momento — nunca bloquea tu trabajo.
- Agentes y administradores ven **tours diferentes**; es normal que un colega vea otra secuencia.
- Los tours solo aparecen con la función **Tours guiados** activada en la cuenta.
- Para revisar contenido, prefiere el **replay** mediante ⌘K o el lanzador en lugar de buscar el
  artículo — el tour muestra la pantalla real.

## Solución de problemas

- **El tour no apareció en el primer acceso**: verifica que la función **Tours guiados** esté
  habilitada, que el inicio automático esté activo, que no lo hayas completado/descartado antes y que
  el tour corresponda a tu rol (agente vs administrador).
- **Quiero verlo de nuevo**: abre la **barra de comandos (⌘K)** y busca el tour, o usa el **lanzador
  de tours** (ícono de birrete) en la barra lateral — los tours completados se reproducen en replay.
- **Un tour de módulo no está en la lista**: el módulo puede estar deshabilitado en la cuenta o fuera
  de tu perfil de acceso.
- **Quiero volver a presentarlo a todos**: un administrador puede reiniciar los tours de primera
  ejecución para toda la cuenta en **Configuración → Onboarding y tours**. La acción pide confirmación.

## Ver también

- [Conociendo la interfaz](/hc/ajuda/articles/getting-started-tour-interface-es)
- [Onboarding con el Cerebro Maestro](/hc/ajuda/articles/getting-started-onboarding-cerebro-maestro-es)