--- title: "Mapeo de URL" slug: "url-mapping" description: "With the Knowledge base assistant, you can display specific articles depending on the page the end-user is on with Document360's URL mapping feature. " tags: ["contextual help", "Premium", "Widget"] updated: 2026-08-17T08:54:55Z published: 2026-08-17T08:54:55Z canonical: "docs.document360.com/url-mapping" --- > ## 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. # Mapeo de URL 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](https://docs.document360.com/help/docs/es/installing-the-knowledge-base-widget). --- ## 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](https://docs.document360.com/docs/es/content-access-for-the-knowledge-base-widget) 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. --- ## Añadir un mapeo de URL ![Animated walkthrough showing how to add a URL mapping in the knowledge base widget](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/url%20mapping%20widget.gif) 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 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 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 **Sí** 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](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/url%20mapping%20settings%20new.png) 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 **de configuración avanzada** . 4. 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](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/contextual%20AI%20assistance%20new.png) 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](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/button%20based%20prompting.png) 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](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/trigger%20key%20info.png) ``` ``` 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](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/copy%20code%20info.png) 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](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/button%20based%20prompting.png) 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 regular en [https://regex101.com](https://regex101.com), añade una barra hacia atrás (`\`) antes de cada barra hacia adelante (`/`). --- ## Consideraciones - 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; } ``` 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. ## Related - [Instalación del widget de la Base de Conocimiento](/installing-the-knowledge-base-widget.md) - [Asistente de IA Eddy para widget](/knowledge-base-widget-getting-started.md) - [Editar, clonar y eliminar widget](/edit-clone-and-delete.md)