--- title: "Mapeamento 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", "Knowledge base widget", "Premium"] updated: 2026-08-17T08:55:29Z published: 2026-08-17T08:55:29Z 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. # Mapeamento de URL O mapeamento de URL permite configurar o que o widget da Knowledge Database exibe página a página. Para cada URL no seu site ou aplicativo, você pode mostrar um artigo específico, uma lista de categorias, uma barra de busca com um marcador personalizado ou ocultar o widget completamente. Isso torna o widget consciente do contexto — os usuários veem o conteúdo de ajuda mais relevante com base em sua posição no produto. ATENÇÃO Para que o mapeamento de URL funcione, o widget da Base de Conhecimento deve estar instalado dentro do seu site ou aplicativo. Para mais informações, leia o artigo sobre [Instalação do widget da Base de Conhecimento](https://docs.document360.com/help/docs/pt/installing-the-knowledge-base-widget). --- ## Quando usar o mapeamento de URL - Destaque um artigo específico diretamente no widget em uma página onde os usuários frequentemente precisem. - Mostre uma lista selecionada de artigos de uma categoria quando um usuário estiver em um módulo específico de produto. - Esconda o widget em páginas onde ele não deveria aparecer (por exemplo, páginas de login, fluxos de checkout). - Exiba um marcador de busca personalizado para orientar os usuários sobre o que buscar em determinado contexto. - Use assistência contextual alimentada por IA (prompting em nível de página) para URLs específicas. --- ## Antes de começar O conteúdo que você deseja mapear (artigos ou categorias) deve estar dentro do escopo de [acesso ao conteúdo](https://docs.document360.com/docs/pt/content-access-for-the-knowledge-base-widget) configurado pelo widget. --- ## Ações Existem cinco ações que você pode executar com mapeamento de URL: | Ação | O que ele faz | | --- | --- | | **Artigo do programa** | Exibe um único artigo na URL especificada | | **Mostrar lista de artigos** | Lista artigos selecionados na seção Recomendados dentro do widget na URL especificada | | **Assistência de IA contextual** | Permite criar e usar prompts baseados em IA dentro do widget | | **Mostrar resultados da busca** | Define um termo de busca específico para consultar sua base de conhecimento, retornando resultados relevantes na URL especificada | | **Ocultar widget** | Impede que o ícone do widget apareça na URL especificada | NOTA A ação **Mostrar lista de artigos** exibe o conteúdo na seção de artigos mais pesquisados do widget. Se a opção **Ocultar artigos mais pesquisados** estiver ativada nas configurações do widget, essa seção ficará oculta e a lista de artigos mapeados não aparecerá. Certifique-se de que essa configuração esteja desativada para que o mapeamento de URL funcione como esperado. --- ## Parâmetros da URL Ao configurar a URL do widget, você pode incluir três tipos de parâmetros: - **Inclua o Caminho**: `/thisis/a/path` - **Inclua Consulta**: `?animal=bear` - **Inclua Hash**: `#inbox` Você também pode ativar o **botão Is Regex** para incorporar expressões regulares nas configurações de URL. --- ## Adicionar um mapeamento 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. Na barra de navegação da esquerda, navegue até **Conexões** () > **widget da base de conhecimento**. 2. Passe o mouse sobre o widget desejado e clique **em Editar** (). 3. Clique na aba **de mapeamento de URL** . 4. Clique **em novo mapeamento de URL** e especifique o seguinte: - **Nome** — O nome do mapeamento de URL é mostrado apenas no registro de mapeamento de URL dentro do Document360. - **Estrutura de URL** — Selecione o tipo de parâmetro de URL desejado (**Incluir caminho** / **Incluir consulta** / **Incluir hash**). Você deve ativar pelo menos um parâmetro de URL. Insira a URL onde deseja que o artigo ou ação apareça. NOTA Seu nome de domínio *não* está incluído no caminho da URL. Por exemplo, para `https://document360.com/ebook/rapid-guide/`, o caminho da URL seria `/ebook/rapid-guide/`. - **Ação** — Selecione a ação desejada. - **Selecione o espaço de trabalho** — Selecione a versão desejada (se você tiver várias versões). - **Idioma para** — Selecione o idioma desejado (se você tiver vários idiomas). - **Artigo a mostrar** — Na barra de busca, selecione os artigos ou categorias que deseja mostrar. NOTA Categorias de pastas não estão disponíveis para seleção. Apenas tipos **de categorias de página** e **índice** estão disponíveis. 5. Clique **em Criar**. Assim que o usuário final acessa a URL especificada e abre o widget, ele verá o artigo ou categoria mapeada. Esse conteúdo é mantido enquanto eles navegam entre as abas de widgets dentro da mesma versão e idioma. --- ## Editando mapeamentos de URL 1. Navegue até **Conexões** () **> widget de Base de Conhecimento**. 2. Passe o mouse sobre o widget desejado e clique **em Editar** (). 3. Na aba **de mapeamento de URLs** , encontre a lista de mapeamentos disponíveis. 4. Passe o mouse sobre o mapeamento desejado e clique **em Editar** (). 5. O painel **de mapeamento Update URL** aparece. 6. Atualize as informações desejadas e clique **em Atualizar**. --- ## Excluindo mapeamentos de URL 1. Navegue até **Conexões** () > **Widget da Base de Conhecimento**. 2. Passe o mouse sobre o widget desejado e clique **em Editar** (). 3. Na aba **de mapeamento de URLs** , encontre a lista de mapeamentos disponíveis. 4. Passe o mouse sobre o mapeamento desejado e clique **em Excluir** (). 5. Clique **em sim** no prompt **de confirmação de Exclusão** . --- ## Configurações de mapeamento de URL (comportamento padrão) Você pode definir o comportamento do widget para URLs que não têm mapeamento 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. Navegue até **Conexões** () > **Widget da Base de Conhecimento**. 2. Passe o mouse sobre o widget desejado e clique **em Editar** (). 3. Clique na aba **Configurações Avançadas** . 4. Expanda a seção **de configurações de mapeamento de URL** . 5. Selecione a opção desejada: - **Navegue até a página de ajuda/base de conhecimento** — Exiba o artigo ou categoria na aba de ajuda de página ou na aba Knowledge base no widget. - **Não faça nenhuma alteração na configuração existente** — Exiba o último artigo ou categoria aberto no widget. 6. Clique **em Salvar**. --- ## Configuração da assistência contextual de IA A ação **de assistência de IA Contextual** permite exibir prompts alimentados por IA no widget com base no contexto da página. Os prompts podem aparecer quando os usuários clicam em um botão ou automaticamente ao abrir uma 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 a assistência de IA Contextual, certifique-se de que a busca assistida por IA esteja habilitada para o widget. Você pode configurar a assistência de IA Contextual de duas maneiras: - **Prompting baseado em botões** — Exibe ajuda contextual quando os leitores clicam em botões específicos no seu site ou aplicativo. - **Prompting em nível de página** — Fornece ajuda automática impulsionada por IA quando os usuários abrem uma página específica, sem necessidade de interação com botões. ### Prompting baseado em botões Cada prompt que você adiciona gera uma **chave de gatilho** única. O prompt é validado automaticamente ao pressionar Enter para confirmar se uma resposta está presente nas suas fontes conectadas. Você pode configurar até 5 mapeamentos de botão e prompt 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. Na seção **Configurar assistência de IA contextual** , deixe a caixa de seleção **Ativar prompts em nível de página** desmarcada. 2. Insira o **prompt de busca**. 3. Pressione **Enter** para validar. - Se uma resposta for encontrada, um rótulo **verde de Resposta encontrada** aparece. - Se nenhuma resposta for encontrada, aparece um rótulo **vermelho de Resposta não encontrada** . 4. Se estiver atualizando um botão existente, copie a **tecla Trigger** e adicione-a ao código do botão usando o `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. Se estiver criando um novo botão, clique **em Copiar código** ao lado de Código de instalação e cole o trecho no HTML da sua 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 adicionar outro prompt, clique **em Adicionar mais** e repita. Para remover um prompt, clique **em Remover**. ### Prompts em nível 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. Selecione a caixa **de seleção Ativar prompts em nível de página** . 2. No **campo de prompt de busca** , insira sua consulta. 3. Pressione **Enter** para validar o prompt. - Resposta verde **encontrada** = resposta disponível. - **Resposta vermelha não encontrada** = sem correspondência. 4. Para adicionar outro prompt, clique **em Adicionar mais**. Você pode adicionar até 5 prompts por URL. - O primeiro prompt aparece como a pergunta principal. - Os prompts restantes aparecem como consultas sugeridas. 5. Para excluir um prompt, clique **em Remover** ao lado. Depois de configurado, clique **em Criar**. Você pode combinar ações padrão de mapeamento de URLs (como **Mostrar artigo**) com **assistência de IA Contextual** entre diferentes URLs para oferecer uma experiência de usuário personalizada e inteligente. --- ## Uso de regex no mapeamento de URL Entender a correspondência de URLs é importante para um mapeamento eficaz de URLs. Ative a opção **Is Regex** ao adicionar ou editar um mapeamento para usar expressões regulares. ### Padrões regex comuns | Estrutura da URL | Configuração Regex | | --- | --- | | `/buckets` | `/buckets$` (corresponde a URLs terminando com `buckets`) | | `/buckets?isCreatingBucket` | `/buckets\?[a-z]*` (corresponde URLs com texto aleatório após o parâmetro da consulta) | **Mapeie um padrão de URL como `/users/{id}`:** ``` ^/users/[0-9]+$ ``` **Mapa `/blog/*` (coringa):** ``` ^/blog/.*?$ ``` **Mapa `/search?q={query}`:** ``` ^/search?q=[a-zA-Z0-9]+$ ``` **URLs dos subdomínios do mapa:** ``` ^https?://?[a-zA-Z0-9-]+.example.com$ ``` NOTA Ao testar sua regex de URL no [https://regex101.com](https://regex101.com), adicione uma barra para trás (`\`) antes de cada barra para frente (`/`). --- ## Considerações - Os mapeamentos de URL devem usar conteúdo **dentro do escopo de acesso ao conteúdo do widget**. Se o escopo mudar, mapeamentos existentes podem ser invalidados. - As alterações de configuração ficam armazenadas em cache por até **15 minutos**. Limpe o cache do aplicativo para ver mudanças imediatamente. NOTA A opção **Ocultar artigos mais pesquisados** , se ativada, também desativa o mapeamento de listas de artigos baseada em URL. Se você usar mapeamento de URL para listas de categorias de superfície, mantenha essa opção desativada. --- ## Melhores práticas - Mapeie primeiro suas páginas de suporte mais visitadas — as análises mostrarão onde os usuários mais frequentemente buscam ajuda. - Use a ação **Ocultar** em páginas de alto atrito (login, pagamento, primeira configuração) onde o widget distrairia em vez de ajudar. - Use **o Is Regex** para mapeamentos baseados em padrões que precisam cobrir múltiplas URLs semelhantes. --- ## FAQ **O que é mapeamento de URLs?** O mapeamento de URL permite que você controle o que o widget da base de conhecimento exibe — ou se ele aparece — em páginas específicas do seu site ou aplicativo. Você pode mapear artigos, listas de categorias, uma barra de busca ou esconder o widget para qualquer URL. **Por que um mapeamento de URL configurado parece quebrado?** Isso normalmente acontece quando o filtro **de acesso ao conteúdo** do widget foi alterado. Se o filtro não incluir mais o espaço de trabalho ou categoria usada no mapeamento, o mapeamento se torna inválido. Verifique as configurações de acesso ao conteúdo e atualize ou recrie o mapeamento. **Como posso ver mudanças imediatas no mapeamento de URLs sem esperar 15 minutos?** A configuração do widget é armazenada em cache por 15 minutos para performance. Para ver mudanças imediatamente, limpe o cache da aplicação no seu navegador ou na camada de cache da sua aplicação web. **Posso adicionar expressões regulares (regex) no mapeamento de URLs?** Sim. Ative o botão **Is Regex** ao adicionar ou editar um mapeamento de URL para usar padrões de expressão regular. Regex permite que um único mapeamento cubra múltiplas URLs semelhantes. **Posso adicionar mapeamento de URL para categorias?** Sim. O mapeamento de URL suporta categorias — aplica-se apenas a tipos de páginas e categorias de índice. Categorias de pastas não estão disponíveis para seleção. **Como posso remover a aba de ajuda de página e a barra de busca do widget quando o mapeamento de URL para um único artigo está configurado?** Navegue até o **widget de Conexões > Base de Conhecimento > Editar**. Cole o seguinte na aba **CSS Personalizada** : ``` li#page-help-tab { display: none; } ``` Depois, cole o seguinte na aba **JavaScript Personalizado** e clique **em Salvar**: ``` setTimeout(function() { $('.search-container').hide(); }, 2000); setTimeout(function() { $("#knowledge-base-tab").click(); }, 2000); ``` Isso esconde a aba de ajuda da Página e a barra de Busca no widget quando o mapeamento de URL para um único artigo é configurado. **O que é regex?** Regex (expressão regular) é uma sequência de caracteres que define um padrão de busca usado para corresponder e manipular cadeias de texto. No mapeamento de URLs, ativar regex permite configurar um único mapeamento para cobrir múltiplas URLs com padrões semelhantes. Por exemplo, em vez de adicionar mapeamentos individuais para `https://example.com/drive-General`, `https://example.com/drive-settings`, e assim por diante, você pode usar `docs/drive` a opção Incluir caminho para combinar todos eles em um único mapeamento. ## Related - [Instalando o widget da Base de Conhecimento](/installing-the-knowledge-base-widget.md) - [Eddy AI Assistant para widgets](/knowledge-base-widget-getting-started.md) - [Editar, Clonar e Excluir widget](/edit-clone-and-delete.md)