Primeros Pasos Reconocimiento de Voz & Comandos Funciones Principales Personalización Panel de Control & Almacenamiento

Bienvenido al Centro de Ayuda de voNavPilot

Esta sección proporciona respuestas rápidas, claras y concisas a las preguntas más frecuentes e importantes de nuestros usuarios.
Ya sea que necesites guía para la instalación, personalización, solución de problemas o funciones avanzadas, aquí encontrarás explicaciones breves y consejos prácticos, para que puedas volver a usar voNavPilot de inmediato.

⚙️ Cómo instalo voNavPilot en mi sitio web?

Sigue estos sencillos pasos para instalar voNavPilot rápida y fácilmente:

  1. Descarga el último archivo voNavPilot.zip desde tu cuenta o desde el enlace oficial de descarga.
  2. En WordPress, ve a Plugins → Añadir Nuevo → Subir Plugin.
  3. Selecciona el archivo voNavPilot.zip, haz clic en Instalar Ahora y luego en Activar.
  4. Después de activar el plugin, el widget voNavPilot aparecerá por defecto en la esquina inferior derecha de tu sitio con un mensaje de bienvenida y un botón de micrófono en rojo.
    Asegúrate de que el sonido del sistema esté activado.
  5. Después de presionar cualquier tecla, voNavPilot comenzará a leer el texto introductorio. Tras un tono de aviso, el navegador solicitará el permiso para acceder al micrófono.
  6. Después de confirmar, el ícono del micrófono se vuelve verde, indicando que puedes hablar con voNavPilot—por ejemplo, diciendo saltar esta instrucción

¡A partir de aquí, tu experiencia con los comandos de voz comienza! ;)

⏸️ Cómo activar o desactivar voNavPilot en mi sitio?

Simplemente haz clic en el botón de micrófono para activar o desactivar voNavPilot. Cuando el micrófono está verde, voNavPilot está activo y escuchando; cuando se vuelve gris, voNavPilot está temporalmente desactivado. Para eliminar voNavPilot completamente de tu sitio, desactiva el plugin desde el panel de WordPress.
Ve a Plugins > Plugins Instalados, encuentra voNavPilot y haz clic en Desactivar.

🔇 voNavPilot está activo — el ícono del micrófono está verde (parpadeando) o rojo (en espera)

y veo el mensaje

Reproducción de audio fallida. Haz clic o toca en algún lugar de la página primero y luego vuelve a intentar el comando.

Por qué?

Las funciones de voz de voNavPilot solo se activan después de una interacción del usuario debido a las políticas de seguridad del navegador sobre reproducción de audio. Si se pierde este permiso—por ejemplo, al no interactuar con la página o si la página se carga con voNavPilot activo—los tonos pueden no reproducirse, aunque los comandos de voz funcionen normalmente.

Para solucionar el problema, simplemente haz clic o toca la página de nuevo. Luego vuelve a intentar los comandos de voz; ¡deberías escuchar el tono!

Esto es un problema conocido, especialmente en Chrome para dispositivos móviles al abrir nuevas pestañas usando comandos de voz.

Esta limitación puede afectar funciones como Leer Página, donde el feedback de audio es importante, así como cualquier función que dependa de detectar el final de la reproducción de audio para activar acciones adicionales.

🎯 Qué tan bien entiende voNavPilot mis comandos?

Detrás de escena, voNavPilot está impulsado por un motor de coincidencia avanzado que combina dos tecnologías: fuzzysort y distancia de Levenshtein.
Fuzzysort permite búsquedas rápidas y flexibles, encontrando coincidencias cercanas aunque las palabras no sean exactas, mientras que la distancia de Levenshtein mide cuán similares son dos cadenas contando las modificaciones mínimas necesarias para convertir una en otra.

Esta combinación asegura alta precisión al emparejar la intención del usuario con los comandos—even si se pronuncian incorrectamente o con pequeños errores.

Además, todos los comandos se generan y gestionan usando DeepL Write, un asistente de escritura AI. Esto ayuda a lograr coincidencias óptimas. Nuestro enfoque en reconocimiento de voz y transcripciones fonéticas asegura que los comandos integrados se comprendan de manera precisa, aunque los resultados puedan variar. También puedes añadir y personalizar tus comandos desde el Panel Admin para mejorar la precisión según tus necesidades.

🗣️ Cómo funcionan el reconocimiento de voz y las transcripciones fonéticas en voNavPilot?

voNavPilot utiliza reconocimiento de voz para convertir tu voz en texto y transcripciones fonéticas para emparejarlo con el comando correcto. Los comandos con al menos 2 sílabas claras se reconocen mejor, reduciendo errores. Hablar demasiado rápido puede disminuir la precisión, ya que el sistema puede no separar claramente los sonidos.

Por ejemplo, el comando "ir arriba" se reconoce de manera confiable si se pronuncia claramente a velocidad normal. Comandos muy cortos como "arriba" podrían no detectarse, especialmente si se pronuncian rápido o sin claridad. Pronunciar claramente, con más sílabas y a velocidad moderada ayuda a voNavPilot a responder de manera confiable.

🎤 Por qué la precisión de los comandos de voz es diferente en Desktop (Chrome/Edge) comparado con Android (Chrome/Edge), incluso con los mismos comandos?

voNavPilot utiliza la API Web Speech integrada en el navegador para el reconocimiento de voz. El comportamiento exacto puede variar según el dispositivo, porque los proveedores del navegador eligen qué motor usar.

• Desktop (Chrome/Edge en Windows):
El input de voz se envía al servicio de reconocimiento en la nube de Google, que alimenta la API Web Speech en navegadores de escritorio. Este backend completamente en la nube ofrece mayor precisión y resultados más consistentes con comandos cortos y predefinidos.

• Android (Chrome/Edge):
En Android, la API Web Speech suele apoyarse en un sistema integrado en el dispositivo—típicamente Google Play Services o el motor de voz del fabricante—que también se conecta a la nube para transcripción. Esta configuración híbrida está optimizada para batería y ancho de banda, pero puede dar resultados menos consistentes con comandos cortos y fijos.

Por qué los resultados difieren: Incluso pronunciando el mismo comando, el backend de reconocimiento varía. El desktop usa siempre el modelo completo en la nube de Google (máxima precisión), mientras que Android usa una implementación del dispositivo que puede introducir variaciones. Este comportamiento proviene de la implementación de la API Web Speech y no es un error de voNavPilot.

Consejo: En Android, pronunciar clara y lentamente los comandos mejora la consistencia del reconocimiento.

📖 Cómo funciona la lectura de páginas en voNavPilot?

La lectura de páginas de voNavPilot comienza desde el área visible de la página (normalmente el viewport) y lee en voz alta todo el contenido visible, incluyendo textos y atributos alt o title de las imágenes. La lectura continúa hasta el final de la página.
Esta función se construye con un módulo programado por voNavPilot y no depende de servicios externos.
Durante la lectura, voNavPilot aplica un efecto resaltado sobre textos o imágenes leídos, ayudando a los usuarios a concentrarse mejor. La página también se desplaza automáticamente para seguir el progreso de la lectura.

Comandos de voz relacionados: Puedes decir leer la página para comenzar y cancelar lectura para detenerla en cualquier momento.

🔍 Cómo encuentra voNavPilot los contenidos de mi sitio como páginas, formularios, enlaces internos y otras funciones?
¿Necesito definirlos en algún lugar?

voNavPilot analiza automáticamente cada página mientras los usuarios navegan por tu sitio. Detecta elementos clave como formularios, enlaces internos y secciones de página en tiempo real. Para la navegación, crea comandos de voz combinando los nombres de las páginas con frases del Open Link Commands del Dashboard Admin (como "abrir", "ir a", "navegar a", etc.).

No se requiere configuración manual: los comandos se generan y actualizan dinámicamente para asegurar un control por voz preciso y fluido en todo tu sitio.

🎛️ Los comandos integrados como Zoom, Alto Contraste y Escala de Grises son fijos o personalizables en voNavPilot?

Todos los comandos en voNavPilot son dinámicos y pueden personalizarse o mejorarse desde el Panel Admin. Piensa en voNavPilot como un bot de voz autoalojado que puedes entrenar con más palabras para mejorar la precisión.Es importante evitar comandos superpuestos, lo que disminuye la precisión cuando palabras comunes aparecen en múltiples comandos.

Por ejemplo, puedes añadir "Corrección de Color On/Off" en lugar de "Escala de Grises On/Off", o "Invertir Colores On/Off" en lugar de "Alto Contraste On/Off".
Esta flexibilidad ayuda a mantener los comandos de voz distintos y el sistema más confiable.

✍️ Cómo funciona el Rellenado de Formularios en voNavPilot?

Este módulo ayuda a los usuarios a completar formularios de contacto usando comandos de voz. Ha sido probado principalmente con WP-Forms y Contact Form 7 y está diseñado para formularios estándar.
Durante el rellenado, un modo de deletreo permite ingresar la información letra por letra para asegurar 100% de precisión. Puedes moverte entre campos, borrar un campo o corregir la última entrada.
voNavPilot puede rellenar automáticamente ciertos elementos como selectores (p. ej., elegir la primera opción) y casillas de verificación.
Puedes abrir o cerrar la tabla de deletreo en cualquier momento para asistir tu entrada.

Una vez finalizado, puedes enviar el formulario tras completar la verificación. voNavPilot proporciona una ventana de 2 minutos para completarlo manualmente.
Después, el formulario se enviará automáticamente y se leerá un mensaje de confirmación.

Antes de comenzar, asegúrate de que voNavPilot esté activo (el ícono del micrófono está verde). Luego di abrir probar comandos para iniciar tu experiencia de rellenado de formularios controlado por voz.

✍️ Cómo funciona la Tabla de Deletreo del Formulario?

La Tabla de Deletreo está diseñada para ayudarte a lograr 100% de precisión al rellenar campos complejos usando comandos de voz. Con un mapa de pronunciación para alfabetos, números y caracteres comunes (como arroba, punto y guion), puedes ingresar datos precisos en cualquier formulario.
La tabla proporciona un diseño simple pero efectivo, con solo los elementos esenciales para asegurar un relleno rápido y preciso. Esto te permite concentrarte en lo importante mientras mantienes el proceso optimizado.
También puedes personalizar y actualizar la tabla para mejorar la precisión de pronunciación o probar diferentes configuraciones.

Si necesitas ayuda en cualquier momento, puedes acceder a la tabla diciendo mostrar ortografía o cerrar ortografía. Te guiará en el proceso y asegurará que tus datos se ingresen correctamente.

🤖 Cómo funciona voNavPilot con Google Invisible reCAPTCHA usando comandos de voz?

Google Invisible reCAPTCHA utiliza señales como movimiento del ratón, entrada de teclado, comportamiento de navegación y datos del dispositivo para verificar si eres humano.
Con voNavPilot, la pulsación inicial o clic para activar el asistente de voz sirve como la principal interacción física que ayuda a Google a reconocer al usuario.
Después de la activación, la mayoría de acciones pueden realizarse mediante comandos de voz sin usar teclado o ratón. Google sigue usando señales del navegador y datos de sesión para verificar la autenticidad del usuario.

Si el sistema de Google está seguro de que eres humano, no aparecerá CAPTCHA adicional. Sin embargo, si hay incertidumbre—especialmente por interacción física limitada—puede aparecer un CAPTCHA. En ese caso, voNavPilot proporciona 2 minutos para solicitar asistencia en vivo y completar la verificación.

🎨 Cómo personalizo el nombre o diseño de voNavPilot?

En el Panel Admin, ve a Diseño Visual & TTS. Allí puedes:

✏️ Puedo cambiar textos o etiquetas en el widget?

Sí, todos los textos y etiquetas se pueden personalizar en Panel Admin → Traducciones de Etiquetas.

Presta atención a las notas importantes en cada sección para evitar errores después de guardar.

🌍 Cómo puedo agregar un nuevo idioma a voNavPilot?

Para agregar un nuevo idioma—por ejemplo, Portugués—a voNavPilot, sigue estos pasos:

  1. Actualizar el mapa de idiomas:
    Abre el archivo lanMap.json y añade traducciones de todos los idiomas existentes a tu nuevo idioma. Ejemplo para Portugués:
    • Inglés: "portuguese": "pt"
    • Alemán: "portugiesisch": "pt"
    • Francés: "portugais": "pt"
    • Español: "portugués": "pt"
    • Italiano: "portoghese": "pt"
    • Portugués: "português": "pt"
  2. Habilitar el cambio de idioma:
    Para permitir que los usuarios cambien al nuevo idioma, actualiza controlCommandMaps en vonavPilot.js. Añade tu código de idioma (ej. "pt") con todos los comandos de voz relevantes, por ejemplo: switch to Portuguese, change language Portuguese, set language Portuguese, wechsel zu Portugiesisch, ändere Portugiesisch, setze Portugiesisch, passer en portugais, changer portugais, définir portugais, cambiar a portugués, cambiar idioma portugués, establecer idioma portugués, passa a portoghese, cambia lingua portoghese, imposta lingua portoghese.
    Una vez añadido, voNavPilot reconocerá todos estos comandos, permitiendo a los usuarios cambiar de idioma sin problemas.
  3. Agregar traducciones y comandos:
    Incluye todas tus traducciones, etiquetas y comandos de voz para el nuevo idioma en los archivos JSON correspondientes. La estructura final debe incluir todos los idiomas:
    en[...], de[...], fr[...], es[...], it[...], pt[...]
  4. Agregar palabras vacías (stop words):
    Incluye las stop words específicas del idioma en stopWords.json. VoNavPilot las ignorará y no aparecerán en los comandos reconocidos.
  5. Preparar las páginas de tu sitio:
    Asegúrate de que las páginas para el nuevo idioma estén disponibles en la estructura URL correcta, por ejemplo, www.tudominio/pt/tupagina.

🗃️ He hecho muchas personalizaciones en voNavPilot. Cómo puedo respaldar o transferir la configuración a otro sitio?

La función Exportar & Importar en el Panel Admin permite respaldar y mover fácilmente tu configuración personalizada de voNavPilot entre sitios.

Exportar: Guarda todas tus configuraciones, etiquetas, comandos de voz y traducciones en un solo archivo JSON para respaldo o reutilización.
Importar: Carga un archivo de configuración previamente exportado para restaurar instantáneamente tu diseño visual, comandos, traducciones y otras configuraciones en otro sitio.

🔄 He actualizado algunas traducciones de etiquetas o comandos de voz en el Panel ADMIN, pero los cambios no se reflejan o los nuevos comandos no se detectan.

voNavPilot usa Transients de WordPress para almacenar en caché tus archivos JSON y mejorar el rendimiento. Como resultado, los cambios pueden no reflejarse de inmediato. Para asegurarte de que tus actualizaciones surtan efecto, instala un Plugin Gestor de Transients en tu panel. Luego, borra todos los archivos JSON en caché de voNavPilot para refrescar el sistema y habilitar la detección de nuevos comandos y etiquetas actualizadas.

🗄️ Dónde y cómo guarda voNavPilot mis comandos del panel?

voNavPilot no utiliza una base de datos tradicional. Toda la información se guarda en archivos JSON separados. Este enfoque permite un procesamiento más rápido y sencillo durante el manejo de comandos de voz en tiempo real.

Si aún tienes preguntas, ¡no dudes en contactarnos!