El widget de la Base de Conocimiento permite a tus usuarios buscar y navegar por tu base de conocimientos sin salir de tu sitio web o aplicación. En lugar de abrir una nueva pestaña o contactar con soporte, los usuarios tienen acceso instantáneo a los artículos relevantes justo donde están, reduciendo el volumen de tickets y mejorando la experiencia general de soporte.
Puedes configurar hasta 10 widgets de la base de conocimiento en un proyecto. Sin embargo, solo puedes configurar un widget de la Knowledge Database por dominio o sitio web.
Cuándo usar el widget de la base de conocimientos
El widget es útil en cualquier situación en la que los usuarios necesiten ayuda contextual sin salir de la aplicación:
- Incorporación de usuarios — Los nuevos usuarios pueden aprender lo básico, como crear una cuenta, navegar por la interfaz y completar tareas comunes, todo ello sin cambiar de contexto.
- Soporte técnico — Los usuarios que se encuentren con un error o problema pueden buscar una solución directamente dentro de la app en lugar de abrir un ticket de soporte.
- Descubrimiento de funcionalidades — Cuando lanzas nuevas capacidades, los usuarios pueden acceder a los artículos relevantes a través del widget para entender qué ha cambiado y cómo utilizarlo.
- Enlace personalizado de recursos — Puedes añadir enlaces personalizados en el widget para dirigir a los usuarios a recursos externos como guías descargables, Google Sheets u otros canales de soporte.
Antes de que empieces
- Debes tener acceso de Propietario del Proyecto o Administrador en Document360.
- Para habilitar Eddy AI dentro del widget, asegúrate de tener un plan activo de Eddy AI y acceso a la configuración de Eddy AI.
Cómo habilitar Eddy AI en el widget de la base de conocimiento
Para activar la búsqueda asistiva impulsada por IA dentro del widget, completa las siguientes dos etapas.
Etapa 1: Habilitar Eddy AI para widgets en configuraciones de IA
- Navega a Configuración () en la barra de navegación izquierda del portal de la Base de conocimiento.
- En el panel de navegación izquierdo, en la sección de ajustes de IA, haz clic en Ajustes de IA de Eddy.
- En la sección de búsqueda asistida por IA , selecciona la casilla de widgets de la tecla, chatbots y extensiones .
Etapa 2: Habilitar la búsqueda asistida por IA en el widget
- En la barra de navegación de la izquierda, navega hasta el widget de Conexiones > Base de conocimiento.
- Para crear un nuevo widget, haz clic en Añadir widget e introduce un nombre.
- Para editar un widget existente, pasa el cursor sobre él y haz clic en Editar ().
- En la pestaña Configurar y Conectar , activa el interruptor de búsqueda asistida por IA .
.png)
- Haz clic en Guardar.
Hay tres niveles de contenido disponibles al configurar el widget: Proyecto, Espacio de trabajo y Categoría. Cuando seleccionas Categoría, el desplegable Workspace no aparece en la configuración del widget.
Qué pueden hacer los lectores con el widget
Una vez que el widget está activo, los lectores pueden utilizarlo para:
- Buscar artículos — Introduce una palabra clave para encontrar artículos relevantes sin salir de la pantalla actual. Las palabras clave que coinciden se destacan en los resultados.
- Contacta con soporte — Utiliza enlaces personalizados para añadir una dirección de correo electrónico o un enlace de soporte, reduciendo así los pasos necesarios para obtener ayuda.
- Ver artículos sugeridos — Las sugerencias contextuales de artículos aparecen según la página en la que se encuentre el lector, mostrando contenido útil de forma proactiva.
- Accede a enlaces personalizados — Dirige a los lectores a cualquier recurso externo, como una descarga de eBook o una hoja de cálculo, utilizando enlaces personalizados añadidos al widget.
El widget se abre en el idioma predeterminado del usuario del navegador. Si ese lenguaje no está disponible en el widget, se utiliza el lenguaje predeterminado de la base de conocimiento.
Especificaciones de widgets
| Límite | Detalle |
|---|---|
| Widgets máximos por proyecto | 10 |
| Widgets por dominio/sitio web | 1 |
| Actualización de la caché de configuración | Cada 15 minutos |
| Incrustación privada de la base de datos | No está soportado directamente; usa el widget con JWT para bases de conocimiento privadas |
| Lenguajes de IA Eddy compatibles | Inglés (en-US, en-GB), francés (fr), español (es), alemán (de), noruego (no), neerlandés (nl) |
Configuración de widgets configurables
Las siguientes configuraciones están disponibles en la configuración del widget:
- Instalación y configuración — Copiar e instalar el código JavaScript del widget
- CSS personalizado — Aplica estilos personalizados para que coincidan con el diseño de tu producto
- JavaScript personalizado — Añadir scripts personalizados para extender el comportamiento de los widgets
- Mapeo de URL — Mostrar artículos específicos o listas de categorías basadas en la URL de la página
La opción de guardado automático está disponible al navegar entre estas pestañas.
El widget utiliza una caché de 15 minutos. Los cambios de configuración entran en vigor después de que la caché se refresca.
Mejores prácticas
-
Usa un widget por dominio. Configurar más de un widget en el mismo dominio puede causar comportamientos inesperados.
-
Averigua el acceso al contenido. Utiliza la configuración de acceso a contenido para limitar los resultados de widgets a un espacio de trabajo o categoría específica, especialmente cuando el widget está integrado en un área de producto específica.
-
Restringir el widget a dominios confiables. Añade tu dominio a la sección de seguridad de widgets para evitar el uso no autorizado de la clave API del widget.
-
Utiliza el mapeo de URL para sugerencias contextuales. Mapea los artículos o listas de categorías relevantes a páginas específicas para que los usuarios vean contenido relevante para su tarea actual.
-
Usa JWT para bases de conocimiento privadas. Si tu base de conocimientos es privada o está restringida, configura la autenticación JWT en el widget para permitir un acceso sencillo sin interrupciones.
Preguntas frecuentes
¿Cómo es útil el widget de la base de conocimiento para los usuarios?
El widget ayuda en tres escenarios principales: incorporación (los nuevos usuarios pueden aprender la app sin cambiar de contexto), soporte técnico (los usuarios buscan soluciones sin contactar con soporte) y descubrimiento de funciones (los usuarios descubren nuevas capacidades a medida que se lanzan).
¿Necesito configurar el widget de nuevo al cambiar de una base de conocimiento pública a una privada?
No, no necesitas configurar el widget de nuevo. Sin embargo, los usuarios deberán iniciar sesión para ver los artículos en el sitio de la base de conocimiento. Para saltarse el requisito de inicio de sesión, configura la función JWT (JSON Web Token) en la configuración del widget.
¿Cómo incrusto una base de conocimiento privada en otra aplicación?
No se soporta incrustar directamente una base de conocimiento privada en otra aplicación. Utiliza el widget de la base de conocimiento con autenticación JWT para integrar tu base de conocimientos privada en tu aplicación.
¿Es posible configurar varios widgets de la base de conocimiento?
Sí, puedes configurar hasta 10 widgets de base de conocimiento en un proyecto. Sin embargo, solo se puede configurar un widget por dominio o sitio web para un rendimiento óptimo.