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.

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 configurado pelo widget.

Ações

Existem cinco ações que você pode executar com mapeamento de URL:

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.

Como adicionar um mapeamento de URL

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.

1. Navegue para Conexões () > Widget da Base de Conhecimento.
2. Passe o mouse sobre o widget desejado e clique em Editar ().
3. Clique na aba Configurar & conectar .
4. Em Definir controles, 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.

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.

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:

<button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>

5. 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.

6. Para adicionar outro prompt, clique em Adicionar mais e repita. Para remover um prompt, clique em Remover.

Prompts em nível de página

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

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$

Limites e limitaçõ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.

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

li#page-help-tab { display: none; }
.article-header .article-back-icon { display: none; }

.search-container { display: none !Important; }

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