Isenção de responsabilidade: Este artigo foi gerado usando tradução automática.

Gerenciando e personalizando o widget da Base de Conhecimento

Prev Next

Planos compatíveis com este recurso: Business Enterprise

Você pode personalizar cada widget da base de conhecimento para melhorar a experiência do usuário.

Editando um widget

  1. Faça login no Knowledge base portal e selecione o projeto desejado.

  2. Navegue até Conexões Conexões () > widget da base de conhecimento na barra de navegação da esquerda. Você verá uma lista de widgets existentes.

  3. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

    Document360 interface showing knowledge base widget options and edit functionality.

Estilizando o Widget

Na aba Configurar & conectar , expanda o acordeão do widget Estilo .

As seguintes opções de personalização de widgets estão disponíveis:

Cor do widget

Você pode escolher a cor do tema para o widget, que também define a cor do ícone.

  1. Clique em Mudar cor para abrir a paleta de cores.

  2. Selecione uma cor usando o seletor ou insira um código hexadecimal, RGB ou HSL.

Ícone de widget

Da mesma forma, na seção de cor do widget, você pode substituir o ícone por uma imagem ou um ícone disponível.

  1. Clique no ícone de Alterar.

  2. Escolha na aba Conjunto de ícones ou insira uma imagem em Inserir imagem:

    1. A partir da URL: Cole o link da imagem e clique em Inserir.

    2. Do dispositivo: Clique em Enviar uma imagem e selecione um arquivo.

  3. Clique em Padrão para voltar ao ícone original.

Posição do widget

Controle onde o widget aparece no seu site:

  • Escolha esquerda ou direita.

  • Defina os valores de espaçamento lateral e inferior para posicionar o widget.

Mensagem de boas-vindas

Adicione uma mensagem curta para cumprimentar os leitores antes que eles interajam com o widget. A mensagem aparece como um balão de chat acima do ícone do widget e ajuda a perceber o widget e acessar facilmente o conteúdo de ajuda.

NOTA

A mensagem de boas-vindas tem um limite de 50 caracteres.

Ocultar widget

Por padrão, a opção de ocultar widget está desativada, então o widget da Base de Conhecimento permanece visível no site. Para ocultar o widget, basta ativar a opção de ativar o botão de ocultar widget .

Ocultar os artigos mais pesquisados

Ative a opção Ocultar artigos mais pesquisados para esconder os artigos mais pesquisados.

NOTA

Ativar a opção Ocultar artigos mais pesquisados desativará o mapeamento de URL para o widget.

Depois que suas alterações forem feitas, clique em Salvar ao lado do campo Nome do Widget.

NOTA

A opção de salvamento automático está disponível para navegação entre as abas dos widgets da Base de Conhecimento.

Settings panel for customizing widget styles, positions, and visibility options.


Acesso ao conteúdo para o widget da base de conhecimento

Você pode configurar o acesso ao conteúdo no seu widget de base de conhecimento mesmo quando o JWT está ativado para o widget. Isso te dá mais flexibilidade para controlar o que seus usuários finais podem ver.

Para configurar o acesso ao conteúdo com o JWT ativado:

  1. Navegue até Conexões Conexões () > widget da base de conhecimento na barra de navegação da esquerda.

  2. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  3. Na aba Configurar & conectar , expanda a seção de acesso ao conteúdo .

  4. Os níveis de filtro disponíveis são:

    • Projeto

    • Espaço de trabalho

    • Categoria

  5. Escolha os espaços de trabalho, idiomas e categorias desejados para exibir no widget.

  6. Clique em Concluído, depois clique em Salvar para aplicar as alterações.

Validando permissões de conteúdo de grupos de leitores

  • Quando um leitor faz login, o sistema validará se as permissões do grupo de leitores correspondem aos filtros de acesso ao conteúdo do widget. Apenas as permissões intersectáveis entre as configurações em nível de widget e as configurações do grupo de leitores serão consideradas para validação.

  • Isso garante que os usuários vejam apenas os artigos para os quais estão autorizados, tanto em nível de widget quanto em grupos de leitores.

ATENÇÃO

Mudanças feitas no acesso ao conteúdo impactarão diretamente o mapeamento da URL.

Se você modificar as configurações de filtro do widget, o mapeamento de URL existente pode ser removido, levando a links quebrados.

Exemplo 1:
Você definiu o conteúdo do widget de filtro no nível do Projeto e configurou um mapeamento de URL que inclui uma lista de artigos da Categoria A no Workspace V1. Se você atualizar as configurações do filtro para mostrar apenas as Categorias B e C no mesmo espaço de trabalho, o mapeamento de URL anterior se torna inválido — porque os artigos originalmente mapeados da Categoria A não estão mais disponíveis no widget.

Você só pode configurar mapeamentos de URL usando artigos incluídos no conteúdo atual do widget de Filtro.

Exemplo 2:
Se o widget for filtrado para exibir conteúdo apenas do Workspace V1, você não pode criar um mapeamento de URL para um artigo localizado no Workspace V2.


Adicionando links personalizados

Você pode adicionar links personalizados ao widget da Base de Conhecimento. Os links aparecerão na ordem em que foram criados. Use essa opção para direcionar os usuários finais a páginas ou recursos específicos. Todos os links abertos pelo widget sempre serão abertos em uma nova aba do navegador.

Para adicionar um link personalizado:

  1. Navegue até Conexões Conexões () > widget da base de conhecimento na barra de navegação da esquerda.

  2. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  3. Na aba Configurar & conectar, expanda o acordeão Adicionar links

  4. No campo de título da Seção , insira o título desejado para essa seção. Isso aparecerá no widget.

  5. No título da Seção, para cada link, escolha o ícone desejado, o texto do link (que aparecerá no widget) e o link de destino.

    Exemplo:

    • Ícone:

    • Texto do link: Entre em contato conosco

    • Link: support@document360.com

      NOTA

    Você pode usar um mailto: no campo de link. Por exemplo: mailto:<youremail@somedomain.com>

  6. Clique em Adicionar e o link será adicionado. Repita os passos para adicionar links adicionais.

  7. Para editar, clique no ícone Editar (). Clique para salvar e descartar.

  8. Clique no ícone Delete () ao lado dos links para excluí-los.

  9. Quando terminar, clique em Salvar para salvar as alterações.

    Configuration settings for a widget, including links and support section details.


Restrição de domínio

O Document360 permite restringir o widget da Base de Conhecimento a domínios específicos. Uma vez que um domínio é adicionado à lista de segurança de widgets, qualquer membro do projeto que queira instalar o widget da Base de Conhecimento em outro domínio deve adicionar esse domínio à seção de Segurança de Widgets .

Se nenhum domínio for adicionado à lista, o widget da Base de Conhecimento pode ser incorporado em qualquer aplicação SaaS ou site público sem restrições.

Restringa o widget da Base de Conhecimento a um domínio específico

Para restringir seu widget de base de conhecimento a um domínio específico,

  1. Navegue até Conexões Conexões () > widget da base de conhecimento na barra de navegação da esquerda.

  2. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  3. Na aba Configurar & conectar , expanda o acordeão de segurança Widget . Você pode encontrar a lista de domínios adicionados anteriormente (se adicionados).

  4. Insira o domínio onde você quer que o widget da Base de Conhecimento seja exibido.

  5. Clique em Adicionar e clique em Salvar para aplicar alterações.

    Configuration settings for a widget, including security and URL mapping options.

NOTA

O "www" não é uma parte válida do seu domínio. Só adicione o que vier depois do www. na sua URL.

Exemplo: document360.com


Adicionando um defletor de tickets no widget da Base de Conhecimento

Você pode integrar um Defletor de Tickets para ajudar a desviar dúvidas de suporte. Para adicionar um defletor de tickets ao seu widget de base de conhecimento, siga os passos abaixo:

  1. Navegue para Conexões () > widget da base de conhecimento na barra de navegação esquerda.

    A lista de widgets vai aparecer.

  2. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  3. Na aba Configurar & conectar , expanda o acordeão defletor de tickets .

  4. Ative o interruptor do defletor de ingressos para mostrar .

  5. Selecione o defletor de ingressos desejado no menu suspenso.

  6. Se necessário, edite o campo de nome do menu .

  7. Clique em Salvar para aplicar alterações.

    O widget agora inclui o defletor de ingressos selecionado.


Solução de problemas

Esta seção fornece orientações passo a passo para lidar com desafios comuns que você pode encontrar ao gerenciar ou acessar seu widget de base de conhecimento.

O ícone do widget fica visível mesmo após mapear para um botão

Mesmo após mapear o widget da Base de Conhecimento para um botão personalizado, o ícone padrão do widget continua aparecendo no site da Base de Conhecimento. Isso acontece porque o script do widget inclui a exibição padrão do ícone, e ele não fica automaticamente oculto ao usar um botão de disparo.

Passos para resolver:

  1. Navegue até Conexões Conexões () > widget da Base de Conhecimento na barra de navegação da esquerda e uma lista dos widgets criados aparecerá.

  2. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  3. Na aba Configurar & conectar , expanda o acordeão do widget Estilo .

  4. Localize o botão de ocultar widget e certifique-se de que ele está ativado.

  5. Clique em Salvar para aplicar as alterações.

    Atualize seu site de conhecimento para ver as mudanças.

Depois de isso, o ícone do widget não estará mais visível no site, mas continuará funcionando como esperado quando acionado pelo seu botão personalizado.

NOTA

Se você também está usando mapeamentos de URL para controlar a visibilidade dos widgets, consulte Customizing the Knowledge Database widget usando Custom CSS/JavaScript para opções avançadas de ocultação. e um l

Settings for a widget including options to hide and customize its appearance.

A seção "Artigos mais pesquisados" não está visível no site da Base de Conhecimento

A seção de artigos mais pesquisados e a lista mapeada de artigos para uma URL específica não aparecem no widget da Base de Conhecimento.

Esse problema normalmente ocorre quando a opção Ocultar artigos mais pesquisados está ativada nas configurações de estilo do widget. Ativar essa opção esconde tanto a seção de artigos mais pesquisados quanto qualquer lista mapeada de artigos associada a uma URL específica.

Passos para resolver:

  1. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  2. Na aba Configurar & conectar , expanda o acordeão do widget Estilo .

  3. Localize o botão de Ocultar artigos mais pesquisados e certifique-se de que ele está desativado.

  4. Clique em Salvar para aplicar as alterações.

    Atualize o site da Knowledge Base e verifique se os artigos mais pesquisados e a lista de artigos mapeados agora estão visíveis.

NOTA

Se o problema persistir mesmo após desativar a opção de alternância, verifique novamente o mapeamento do artigo para a URL e revise outras configurações de exibição dentro da configuração do widget.

Settings for a knowledge base widget, highlighting the option to hide articles.


Perguntas Freqüentes

Por que algumas categorias estão faltando no widget da Base de Conhecimento?

Esse problema pode ocorrer se o acesso em nível de categoria não tiver sido configurado corretamente para o widget. Para garantir que suas categorias estejam visíveis no widget:

  1. Verifique se o usuário ou leitor tem permissão para visualizar as categorias/artigos específicos no widget da Base de Conhecimento.

  2. Verifique se o acesso em nível de categoria está configurado para o widget. Se for, você precisa adicionar manualmente a categoria desejada na seção de acesso ao conteúdo durante a configuração do widget.

Para adicionar a categoria ao widget:

  1. Navegue até Conexões () > Base de Conhecimento no portal da Base de Conhecimento.

  2. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  3. Na aba Configuração & conectar , expanda o acordeão de acesso ao conteúdo .

  4. Selecione Categoria e escolha a categoria desejada para aparecer no widget.

  5. Clique em Salvar para aplicar as alterações.

O widget da Base de Conhecimento não está carregando no site da Base de Conhecimento. Como posso resolver esse problema?

O widget da Base de Conhecimento pode não carregar no seu site se a chave da API estiver desatualizada. Atualizar a chave API deve resolver o problema e restaurar a funcionalidade do widget.

Como aplico um estilo personalizado ao texto exibido no widget da base de conhecimento?

Para personalizar a aparência de texto específico no seu widget de base de conhecimento, você pode usar o estilo HTML inline. Aqui está um exemplo de um trecho de código HTML:

<div style="font-family:Arial, sans-serif;font-size:14px;color:#333333;line-height:1.6;">
  <p>
    The <strong>test line</strong>
  </p>
</div>

Como você muda a posição do ícone do widget da Knowledge Base no seu site?

  1. Vá para a aba Instalação e Configuração do widget desejado da Base de Conhecimento (widget da Base de Conhecimento > Editar).

  2. Na seção Estilo do seu widget , você pode encontrar a posição do widget.

  3. Selecione o botão Esquerda ou Direita para mudar a posição do ícone para esquerda ou direita.

  4. Insira os valores de espaçamento desejados nos campos de espaçamento lateral e inferior para posicionar o ícone.

  5. Clique no botão Salvar no topo.

Como desligar a busca superior no widget da base de conhecimento?

  1. Vá para a aba Instalação e Configuração do widget desejado da Base de Conhecimento (Widget da Base de Conhecimento > Editar).

  2. Na seção Estilizar seu widget , ative o botão Ocultar busca superior .

  3. Clique no botão Salvar no topo.

Como faço para definir o logo desejado como um ícone de widget?

  1. Vá para a aba Instalação e Configuração do widget desejado da Base de Conhecimento (widget da Base de Conhecimento > Editar).

  2. Na seção Estilizar seu widget , você pode encontrar o ícone do widget.

  3. Clique no botão do ícone de Mudança .

  4. Escolha/envie o ícone desejado.

  5. Clique no botão Salvar no topo.

Como esconder o widget da Base de Conhecimento?

  1. Vá para a aba Instalação e Configuração do widget desejado da Base de Conhecimento (Widget da Base de Conhecimento > Editar).

  2. Na seção Estilizar seu widget , ative a opção de alternar para ocultar widget .

  3. Clique no botão Salvar no topo.

Posso adicionar links personalizados no widget da Base de Conhecimento?

Sim, você pode adicionar links personalizados no widget da Base de Conhecimento.

Como você ativa o defletor de tickets no widget da base de conhecimento?

  1. Vá para a aba Instalação e Configuração do widget desejado da Base de Conhecimento (Widget da Base de Conhecimento > Editar).

  2. Ative a opção de desligar o defletor de ingressos para o show .

  3. Clique no botão Salvar no topo.

Como faço para remover o ícone do widget da Knowledge Base de um artigo?

  1. Vá para a aba de mapeamento de URL do widget desejado da Knowledge Base (Knowledge Database widget > Edit).

  2. Crie um novo mapeamento de URL com a ação Ocultar para o artigo desejado.

Qual é o comportamento padrão da linguagem do widget da Base de Conhecimento?

O widget da Base de Conhecimento agora será aberto no idioma padrão do navegador por padrão. Se o idioma padrão do navegador não estiver disponível no widget da Base de Conhecimento, o idioma padrão da Base de Conhecimento aparecerá.

Como faço para restringir o widget da Base de Conhecimento a um domínio específico?

  1. Vá para a aba Instalação e Configuração do widget desejado da Base de Conhecimento (Widget da Base de Conhecimento > Editar).

  2. Na seção Estilizar seu widget , você pode encontrar o Manter seu widget seguro.

  3. Insira os domínios onde você quer que o widget da Base de Conhecimento seja exibido.

  4. Clique em Adicionar > Salvar.

Posso ocultar o menu suspenso Workspace e Language?

Os menus suspensos Workspace e Language são visíveis por padrão e não podem ser ocultados ou removidos.

É possível localizar ou personalizar o texto do widget no site da base de conhecimento?

Sim. Você pode localizar ou personalizar o texto exibido no widget da base de conhecimento usando o recurso de variáveis de localização . Isso permite que você traduza o texto padrão para outros idiomas. Para atualizar este texto,

  1. Navegue até Configurações () na barra de navegação à esquerda do portal da base de conhecimento.

  2. No painel de navegação à esquerda, navegue até o portal Portal da base de conhecimento > Espaço de trabalho e localização.

  3. Na aba Variáveis de Localização , expanda o acordeão Widget .
    Você pode atualizar elementos como Ajuda de Página, Artigo Mais Pesquisado e Não foi encontrado nenhum artigo de Maior Busca.

    NOTA

    Por padrão, o sistema localiza variáveis para o idioma respectivo.

  4. Clique em Salvar.