O widget da Base de Conhecimento permite que seus usuários pesquisem e naveguem pela sua base de conhecimento sem sair do site ou aplicativo. Em vez de abrir uma nova aba ou entrar em contato com o suporte, os usuários têm acesso instantâneo aos artigos relevantes exatamente onde estão — reduzindo o volume de tickets e melhorando a experiência geral do suporte.
Você pode configurar até 10 widgets da Knowledge Base em um projeto. No entanto, você pode configurar apenas um widget de Knowledge Database por domínio ou site.
Quando usar o widget da base de conhecimento
O widget é útil em qualquer cenário em que os usuários precisem de ajuda contextual sem sair do aplicativo:
- Integração de usuários — Novos usuários podem aprender o básico, como criar uma conta, navegar pela interface e completar tarefas comuns, tudo isso sem mudar de contexto.
- Suporte técnico — Usuários que encontrarem um erro ou problema podem buscar uma solução diretamente no aplicativo, em vez de abrir um chamado de suporte.
- Descoberta de recursos — Quando você lança novas capacidades, os usuários podem acessar artigos relevantes através do widget para entender o que mudou e como usá-los.
- Vinculação personalizada de recursos — Você pode adicionar links personalizados no widget para direcionar os usuários a recursos externos, como guias para download, planilhas do Google ou outros canais de suporte.
Antes de começar
- Você deve ter acesso de Proprietário do Projeto ou Administrador no Document360.
- Para ativar o Eddy AI dentro do widget, certifique-se de ter um plano ativo do Eddy AI e acesso às configurações do Eddy AI.
Como habilitar a IA Eddy no widget da base de conhecimento
Para ativar a busca assistiva alimentada por IA dentro do widget, complete as duas etapas seguintes.
Etapa 1: Ativar a IA Eddy para widgets nas configurações de IA
- Navegue até Configurações () na barra de navegação da esquerda do portal da Base de Conhecimento.
- No painel de navegação da esquerda, nas configurações de IA, clique em Configurações de IA de Eddy.
- Na seção de busca assistida por IA , selecione a caixa de seleção de widgets do KB, chatbots e extensões .
Etapa 2: Ativar a busca assistida por IA no widget
- Na barra de navegação da esquerda, navegue até o widget Conexões > Base de Conhecimento.
- Para criar um novo widget, clique em Adicionar widget e insira um nome.
- Para editar um widget existente, passe o mouse sobre ele e clique em Editar ().
- Na aba Configurar & Conectar , ative a opção de busca assistida por IA .
.png)
- Clique em Salvar.
Três níveis de conteúdo estão disponíveis ao configurar o widget: Projeto, Espaço de Trabalho e Categoria. Quando você seleciona Categoria, o menu suspenso do Workspace não aparece na configuração do widget.
O que os leitores podem fazer com o widget
Uma vez que o widget está ativo, os leitores podem usá-lo para:
- Busque artigos — Insira uma palavra-chave para encontrar artigos relevantes sem sair da tela atual. Palavras-chave correspondentes são destacadas nos resultados.
- Entre em contato com o suporte — Use links personalizados para adicionar um endereço de e-mail ou um link de suporte, reduzindo as etapas necessárias para obter ajuda.
- Veja artigos sugeridos — Sugestões de artigos contextuais aparecem com base na página em que o leitor está, revelando conteúdo útil de forma proativa.
- Acesse links personalizados — Direcione os leitores a qualquer recurso externo, como download de eBook ou planilha, usando links personalizados adicionados ao widget.
O widget abre no idioma padrão do navegador do usuário. Se essa linguagem não estiver disponível no widget, a linguagem padrão da base de conhecimento é usada em seu lugar.
Especificações de widgets
| Limite | Detalhes |
|---|---|
| Widgets máximos por projeto | 10 |
| Widgets por domínio/site | 1 |
| Atualização do cache de configuração | A cada 15 minutos |
| Embedding privado de KB | Não suportado diretamente; use o widget com JWT para bases de conhecimento privadas |
| Linguagens de IA Eddy suportadas | Inglês (en-US, en-GB), francês (fr), espanhol (es), alemão (de), norueguês (norueguês), holandês (nl) |
Configurações configuráveis de widgets
As seguintes configurações estão disponíveis na configuração do widget:
- Instalação e configuração — Copiar e instalar o código JavaScript do widget
- CSS personalizado — Aplique estilos personalizados para combinar com o design do seu produto
- JavaScript personalizado — Adicionar scripts personalizados para estender o comportamento dos widgets
- Mapeamento de URL — Exibir artigos específicos ou listas de categorias com base na URL da página
A opção de salvamento automático está disponível ao navegar entre essas abas.
O widget usa um cache de 15 minutos. As mudanças de configuração entram em vigor após a atualização do cache.
Melhores práticas
-
Use um widget por domínio. Configurar mais de um widget no mesmo domínio pode causar comportamentos inesperados.
-
Escopar o acesso ao conteúdo. Use as configurações de acesso ao conteúdo para limitar os resultados dos widgets a um espaço de trabalho ou categoria específica, especialmente quando o widget está incorporado em uma área de produto específica.
-
Restringa o widget a domínios confiáveis. Adicione seu domínio à seção de segurança de widgets para evitar o uso não autorizado da chave API do widget.
-
Use mapeamento de URL para sugestões contextuais. Mapeie artigos relevantes ou listas de categorias para páginas específicas para que os usuários vejam conteúdo relevante para sua tarefa atual.
-
Use o JWT para bases de conhecimento privadas. Se sua base de conhecimento for privada ou restrita, configure a autenticação JWT no widget para permitir um acesso simples e contínuo por login único.
FAQ
Como o widget da base de conhecimento é útil para os usuários?
O widget ajuda em três cenários principais: onboarding (novos usuários podem aprender o app sem mudar de contexto), suporte técnico (usuários buscam soluções sem contatar o suporte) e descoberta de recursos (usuários aprendem sobre novas capacidades à medida que são lançadas).
Preciso configurar o widget novamente ao trocar de uma base de conhecimento pública para uma privada?
Não, você não precisa configurar o widget novamente. No entanto, os usuários deverão fazer login para visualizar os artigos no site da base de conhecimento. Para contornar a exigência de login, configure o recurso JWT (JSON Web Token) nas configurações do widget.
Como faço para incorporar uma base de conhecimento privada em outra aplicação?
Incorporar diretamente uma base de conhecimento privada em outra aplicação não é suportado. Use o widget da base de conhecimento com autenticação JWT para integrar sua base de conhecimento privada à sua aplicação.
É possível configurar múltiplos widgets de base de conhecimento?
Sim, você pode configurar até 10 widgets de base de conhecimento em um projeto. No entanto, apenas um widget pode ser configurado por domínio ou site para desempenho ideal.