Você pode criar mais de um widget de base de conhecimento dentro de um único projeto Document360. Um caso de uso comum é manter um widget de teste separado junto com um widget de produção ao vivo, para que você possa experimentar com segurança mudanças de configuração sem afetar os leitores.
Quando usar múltiplos widgets
- Você precisa de um widget de staging para testar estilo, mapeamento de URL ou alterações de acesso ao conteúdo antes de aplicá-las à produção.
- Você atende públicos diferentes (produtos, regiões ou níveis de acesso diferentes) e quer configurações separadas de widgets para cada um.
Configurações que permanecem isoladas por widget
Cada widget tem sua própria configuração independente para:
- Nome do widget
- Estilo (cor, ícone, posição, mensagem de boas-vindas, ocultar widget, ocultar artigos mais pesquisados)
- Acesso ao conteúdo (espaço de trabalho, idioma, visibilidade de categoria)
- Links personalizados
- Restrição de domínio
Alterações feitas em qualquer uma das configurações acima em um widget não afetam nenhum outro widget do projeto.
Configurações compartilhadas entre widgets
Se a autenticação JWT estiver ativada, o segredo do cliente é compartilhado entre todos os widgets e chatbots habilitados para JWT no mesmo projeto, independentemente de qual widget você o regenere.
Regenerar o segredo do cliente em um widget — incluindo um widget de teste — quebrará imediatamente a autenticação em todos os outros widgets habilitados para JWT no projeto até que todas as integrações backend sejam atualizadas com o novo segredo.
Se você está usando um widget de teste para tentar mudanças relacionadas ao JWT, evite regenerar o segredo do cliente , a menos que esteja pronto para atualizar todas as integrações backend ao mesmo tempo.
Para detalhes completos da configuração do JWT, veja Configurar JWT para o widget da base de conhecimento.
Melhores práticas
- Use uma convenção clara de nomenclatura para distinguir widgets de teste e de produção (por exemplo, "Widget — Produção", "Widget — Teste").
- Use restrição de domínio no widget de produção para garantir que ele carregue apenas no seu domínio ativo, enquanto o widget de teste pode ser restrito a um domínio de staging.
FAQ
Fiz alterações no meu widget de teste e meu widget live quebrou. Por quê?
A maioria das configurações de widgets (estilo, acesso ao conteúdo, links, restrição de domínio) é isolada por widget e não afeta outros widgets. A única exceção é o segredo do cliente JWT, que é compartilhado entre todos os widgets e chatbots habilitados para JWT no projeto. Se o segredo do cliente foi regenerado no seu widget de teste, ele também invalida a autenticação no seu widget ativo até que o novo segredo seja atualizado na integração backend.
O widget da base de conhecimento não está carregando no site da base de conhecimento. Como posso consertar isso?
O widget pode não carregar se a chave de API no script incorporado estiver desatualizada. Copie o script atual do widget Connections > Knowledge Base > script Copy e substitua o script desatualizado no seu site.