Documentation Index

Fetch the complete documentation index at: https://docs.document360.com/llms.txt

Use this file to discover all available pages before exploring further.

Descargo de responsabilidad: Este artículo se generó mediante traducción automática.

Mapeo de URL

Prev Next

El mapeo de URL te permite configurar lo que muestra el widget de la Base de Conocimiento página por página. Para cada URL de tu sitio web o aplicación, puedes mostrar un artículo específico, una lista de categorías, una barra de búsqueda con un marcador personalizado o ocultar el widget por completo. Esto hace que el widget sea consciente del contexto: los usuarios ven el contenido de ayuda más relevante según su posición en tu producto.

PRECAUCIÓN

Para que el mapeo de URL funcione, el widget de la Base de Conocimiento debe estar instalado dentro de tu sitio o aplicación. Para más información, lee el artículo sobre Instalación del widget de la Base de Conocimiento.


Cuándo usar el mapeo de URL

  • Muestra un artículo específico directamente en el widget de una página donde los usuarios lo necesiten con frecuencia.
  • Mostrar una lista seleccionada de artículos de una categoría cuando un usuario esté en un módulo de producto específico.
  • Oculta el widget en páginas donde no debería aparecer (por ejemplo, páginas de inicio de sesión, flujos de pago).
  • Mostrar un marcador de posición personalizado para guiar a los usuarios sobre qué buscar en un contexto determinado.
  • Utiliza asistencia contextual impulsada por IA (prompting a nivel de página) para URLs específicas.

Antes de que empieces

El contenido que quieres mapear (artículos o categorías) debe estar dentro del alcance de acceso al contenido configurado por el widget.


Acciones

Hay cinco acciones que puedes ejecutar con mapeo de URL:

Acción Qué hace
Artículo del programa Muestra un solo artículo en la URL especificada
Mostrar lista de artículos Lista los artículos seleccionados bajo la sección Recomendados dentro del widget en la URL especificada
Asistencia de IA contextual Te permite crear y usar prompts impulsados por IA dentro del widget
Mostrar resultados de búsqueda Establece un término de búsqueda específico para consultar tu base de conocimientos, devolviendo los resultados relevantes en la URL especificada
Ocultar widget Impide que el icono del widget aparezca en la URL especificada
NOTA

La acción Mostrar lista de artículos muestra el contenido en la sección de artículos más buscados del widget. Si el interruptor Ocultar artículos más buscados está activado en la configuración de widgets, esta sección quedará oculta y la lista de artículos mapeados no aparecerá. Asegúrate de que esta opción esté desactivada para que el mapeo de URL funcione como se espera.


Parámetros de URL

Al configurar la URL del widget, puedes incluir tres tipos de parámetros:

  • Incluye el camino: /thisis/a/path
  • Incluye consulta: ?animal=bear
  • Incluye hash: #inbox

También puedes activar el interruptor Is Regex para incorporar expresiones regulares en tus configuraciones de URL.


Cómo añadir un mapeo de URL

Animated walkthrough showing how to add a URL mapping in the knowledge base widget

  1. En la barra de navegación de la izquierda, navega a Conexiones () > widget de la base de conocimientos.

  2. Pasa el cursor sobre el widget deseado y haz clic en Editar ().

  3. Haz clic en la pestaña de mapeo de URL .

  4. Haz clic en Nueva asignación de URL y especifica lo siguiente:

    • Nombre — El nombre de mapeo de URL solo se muestra en el registro de mapeo de URL dentro de Document360.

    • Estructura de URL — Seleccione el tipo de parámetro de URL deseado (Incluir ruta / Incluir consulta / Incluir hash). Debes habilitar al menos un parámetro de URL. Introduce la URL en la que quieres que aparezca el artículo o la acción.

      NOTA

      Tu nombre de dominio no está incluido en la ruta de la URL. Por ejemplo, para https://document360.com/ebook/rapid-guide/, la ruta URL sería /ebook/rapid-guide/.

    • Acción — Seleccione la acción deseada.

    • Seleccionar espacio de trabajo — Seleccione la versión deseada (si tiene varias versiones).

    • Idioma para — Selecciona el idioma deseado (si tienes varios idiomas).

    • Artículo a mostrar — En la barra de búsqueda, selecciona los artículos o categorías que quieres mostrar.

      NOTA

      Las categorías de carpetas no están disponibles para la selección. Solo están disponibles los tipos de páginas e indexados.

  5. Haz clic en Crear.

Una vez que un usuario final accede a la URL especificada y abre el widget, verá el artículo o categoría asignado. Este contenido se mantiene mientras navegan entre las pestañas de widgets dentro de la misma versión y idioma.


Edición de mapeos de URL

Animated walkthrough showing how to edit an existing URL mapping

  1. Navega a Conexiones () > widget de la base de conocimiento.
  2. Pasa el cursor sobre el widget deseado y haz clic en Editar ().
  3. En la pestaña de mapeo de URLs , encuentra la lista de mapeos disponibles.
  4. Pasa el cursor sobre el mapeo deseado y haz clic en Editar ().
  5. Aparece el panel de mapeo de URL de Actualización .
  6. Actualiza la información deseada y haz clic en Actualizar.

Eliminación de mapeos de URL

URL mapping list showing the delete icon on hover

  1. Navega a Conexiones () > widget de la base de conocimiento.
  2. Pasa el cursor sobre el widget deseado y haz clic en Editar ().
  3. En la pestaña de mapeo de URLs , encuentra la lista de mapeos disponibles.
  4. Pasa el cursor sobre el mapeo deseado y haz clic en Borrar ().
  5. Haz clic en en el prompt de confirmación de Eliminar .

Configuración de mapeo de URL (comportamiento por defecto)

Puedes definir el comportamiento del widget para URLs que no tengan mapeo configurado.

URL mapping settings panel showing the two default behavior options

  1. Navega a Conexiones () > widget de la base de conocimiento.
  2. Pasa el cursor sobre el widget deseado y haz clic en Editar ().
  3. Haz clic en la pestaña Configurar y conectar .
  4. En Establecer controles, amplía la sección de configuración de mapeo de URL.
  5. Selecciona la opción deseada:
    • Navega a la página de ayuda/base de conocimiento — Muestra el artículo o la categoría en la pestaña de ayuda de página o en la pestaña de la Base de conocimientos del widget.
    • No hagas ningún cambio en la configuración existente — Muestra el último artículo o categoría abierto en el widget.
  6. Haz clic en Guardar.

Configuración de la asistencia contextual de IA

La acción de asistencia de IA Contextual te permite mostrar indicaciones impulsadas por IA en el widget según el contexto de la página. Los avisos pueden aparecer cuando los usuarios hacen clic en un botón o automáticamente al abrir una página específica.

Widget configuration interface showing URL mapping and contextual AI assistance options

NOTA

Para configurar la asistencia de IA contextual, asegúrate de que la búsqueda asistida por IA esté habilitada para el widget.

Puedes configurar la asistencia de IA contextual de dos maneras:

  • Indicación basada en botones — Muestra ayuda contextual cuando los lectores hacen clic en botones específicos de tu sitio web o aplicación.
  • Prompting a nivel de página — Proporciona ayuda impulsada por IA automáticamente cuando los usuarios abren una página específica, sin necesidad de interacción con botones.

Prompting basado en botones

Cada prompt que añades genera una clave de disparo única. El prompt se valida automáticamente al pulsar Enter para confirmar si se encuentra una respuesta en tus fuentes conectadas. Puedes configurar hasta 5 asignaciones de botones y prompts por URL.

Configuration options for contextual AI assistance showing button-based prompting setup

  1. En la sección Configurar asistencia contextual de IA , deja desmarcada la casilla Habilitar indicaciones a nivel de página .
  2. Introduce tu prompt de búsqueda.
  3. Pulsa Enter para validar.
    • Si se encuentra una respuesta, aparece una etiqueta verde de Respuesta encontrada .
    • Si no se encuentra respuesta, aparece una etiqueta roja de Respuesta no encontrada .
  4. Si actualizas un botón existente, copia la tecla Trigger y añádela al código del botón usando el d360AIHelp atributo:

Instructions for adding URL mapping and contextual AI assistance in a widget interface

<button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>
  1. Si creas un nuevo botón, haz clic en Copiar código junto a Código de instalación y pega el fragmento en el HTML de tu página.

Instructions for configuring contextual AI assistance with a widget installation code

  1. Para añadir otro prompt, haz clic en Añadir más y repite. Para eliminar un prompt, haz clic en Eliminar.

Prompting a nivel de página

Configuration options for a widget including page-level prompting settings

  1. Seleccione la casilla Activar indicaciones a nivel de página .
  2. En el campo de búsqueda , introduce tu consulta.
  3. Pulsa Enter para validar el prompt.
    • Respuesta verde encontrada = respuesta disponible.
    • Respuesta roja no encontrada = no coincidencia.
  4. Para añadir otro prompt, haz clic en Añadir más. Puedes añadir hasta 5 prompts por URL.
    • La primera pregunta aparece como la pregunta principal.
    • Los prompts restantes aparecen como consultas sugeridas.
  5. Para eliminar un prompt, haz clic en Eliminar al lado.

Una vez configurado, haz clic en Crear.

Puedes combinar acciones estándar de mapeo de URLs (como Mostrar artículo) con asistencia de IA contextual en diferentes URLs para ofrecer una experiencia de usuario personalizada e inteligente.


Uso de regex en el mapeo de URL

Comprender la coincidencia de URLs es importante para un mapeo efectivo de URLs. Activa el interruptor Is Regex al añadir o editar una asignación para usar expresiones regulares.

Patrones regex comunes

Estructura de la URL Configuración Regex
/buckets /buckets$ (coincide con URLs que terminan en buckets)
/buckets?isCreatingBucket /buckets\?[a-z]* (empareja URLs con texto aleatorio tras el parámetro de consulta)

Mapea un patrón de URL como /users/{id}:

^/users/[0-9]+$

Mapa /blog/* (comodín):

^/blog/.*?$

Mapa /search?q={query}:

^/search?q=[a-zA-Z0-9]+$

URLs de subdominios del mapa:

^https?://?[a-zA-Z0-9-]+.example.com$
NOTA

Al probar tu URL regex en https://regex101.com, añade una barra hacia atrás (\) antes de cada barra hacia adelante (/).


Límites y limitaciones

  • Los mapeos de URL deben utilizar contenido dentro del alcance de acceso al contenido del widget. Si el alcance cambia, los mapeos existentes pueden ser invalidados.
  • Los cambios de configuración se almacenan en caché durante hasta 15 minutos. Borra la caché de la aplicación para ver los cambios inmediatamente.
NOTA

El interruptor Ocultar artículos más buscados , si está activado, también desactiva el mapeo de listas de artículos basado en URL. Si usas mapeo de URL a listas de categorías de superficie, mantén ese interruptor desactivado.


Mejores prácticas

  • Primero mapea tus páginas de soporte más visitadas — las analíticas te mostrarán dónde buscan más los usuarios para pedir ayuda.
  • Usa la acción Ocultar en páginas de alta fricción (inicio de sesión, pago, primera configuración) donde el widget distraería en lugar de ayudar.
  • Utiliza Is Regex para mapeos basados en patrones que deben cubrir múltiples URLs similares.

Preguntas frecuentes

¿Qué es el mapeo de URLs?

El mapeo de URL te permite controlar qué muestra el widget de la base de conocimiento — o si aparece en absoluto — en páginas específicas de tu sitio web o aplicación. Puedes mapear artículos, listas de categorías, una barra de búsqueda o ocultar el widget para cualquier URL.

¿Por qué una asignación de URL configurada parece estar rota?

Esto suele ocurrir cuando se ha cambiado el filtro de acceso al contenido del widget. Si el filtro ya no incluye el espacio de trabajo o la categoría utilizada en el mapeo, el mapeo se vuelve inválido. Revisa la configuración de acceso al contenido y actualiza o recrea el mapeo.

¿Cómo puedo ver cambios inmediatos en el mapeo de URL sin tener que esperar 15 minutos?

La configuración de los widgets se almacena en caché durante 15 minutos para la interpretación. Para ver los cambios inmediatamente, borra la caché de la aplicación en tu navegador o en la capa de caché de tu aplicación web.

¿Puedo añadir expresiones regulares (regex) en el mapeo de URL?

Sí. Activa el interruptor Is Regex al añadir o editar una asignación de URL para usar patrones de expresión regular. Regex permite que un único mapeo cubra múltiples URLs similares.

¿Puedo añadir mapeo de URL para categorías?

Sí. El mapeo de URL admite categorías — solo se aplica a tipos de páginas e índice. Las categorías de carpetas no están disponibles para la selección.

¿Cómo puedo eliminar la pestaña de ayuda de página y la barra de búsqueda del widget cuando el mapeo de URL para un solo artículo está configurado?

Navega a Conexiones > widget de la base de conocimiento > Editar. Pega lo siguiente en la pestaña CSS Personalizada :

li#page-help-tab { display: none; }

.article-header .article-back-icon { display: none; }
.search-container { display: none !Important; }

Luego pega lo siguiente en la pestaña de JavaScript personalizado y haz clic en guardar:

setTimeout(function() { $('.search-container').hide(); }, 2000);
setTimeout(function() { $("#knowledge-base-tab").click(); }, 2000);

Esto oculta la pestaña de ayuda de página y la barra de búsqueda en el widget cuando se configura el mapeo de URL para un único artículo.

¿Qué es regex?

Regex (expresión regular) es una secuencia de caracteres que define un patrón de búsqueda utilizado para coincidir y manipular cadenas de texto. En el mapeo de URLs, activar regex te permite configurar un único mapeo para cubrir múltiples URLs con patrones similares. Por ejemplo, en lugar de añadir asignaciones individuales para https://example.com/drive-General, https://example.com/drive-settings, y demás, puedes usar docs/drive con la opción Incluir ruta para emparejar todas en una sola asignación.