--- title: "Usando múltiplos widgets dentro de um projeto" slug: "using-multiple-widgets-within-a-project" updated: 2026-08-17T08:55:29Z published: 2026-08-17T08:55:29Z canonical: "docs.document360.com/using-multiple-widgets-within-a-project" --- > ## 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. # Usando múltiplos widgets dentro de um projeto 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 - Aparência (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 NOTA 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. AVISO 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](https://docs.document360.com/docs/pt/configuring-jwt-for-the-knowledge-base-widget). --- ## 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. **Teste sem habilitar o JWT para isolamento adicional** Se você está testando um novo widget e quer garantir que seus widgets de produção e integrações backend não sejam afetados, pode configurar e testar o novo widget sem ativar o JWT. Essa abordagem fornece uma camada adicional de isolamento além das convenções de nomeação e da restrição de domínio. Quando o JWT não está ativado no widget de teste, não há risco de regenerar acidentalmente o segredo compartilhado do cliente e interromper a autenticação de produção. Quando os testes terminarem e você estiver pronto para o lançamento, ative o JWT no widget e atualize sua integração backend com o segredo compartilhado do cliente. --- ## FAQ **Fiz alterações no meu widget de teste e meu widget live quebrou. Por quê?** A maioria das configurações de widgets (aparência, 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 Copiar** e substitua o script desatualizado no seu site.