# Documentação WiseMind
> Documentação completa da plataforma WiseMind de chatbots com IA
This file contains all documentation content in a single document following the llmstxt.org standard.
## Customizar Aparência
Crie uma experiência única para seus clientes personalizando completamente a aparência do seu chatbot! Configure cores, estilos e mensagens que reflitam a identidade da sua marca e se adaptem perfeitamente ao seu site.
:::info Contexto Atual
A aparência está sendo editada no contexto: **[CONTEXTO_ATUAL]**. Cada contexto pode ter sua própria personalização visual.
:::
## Layout da Página
A página de customização é dividida em duas seções principais:
### 🎨 Seção Esquerda: Configurações
Painel com todas as opções de personalização do chatbot
### 👁️ Seção Direita: Preview
Área de pré-visualização em tempo real das mudanças
---
## Modo Avançado
### Alternar Modo Avançado
❌ **Desabilitado** (padrão): Opções básicas de customização.
☑️ **Habilitado**: Acesso a configurações avançadas e detalhadas
:::tip Quando usar o Modo Avançado
Ative o modo avançado quando precisar de controle total sobre cores, espaçamentos e elementos específicos da interface.
:::
---
## Aparência do Chatbot
### Informações Básicas
#### Nome do Bot
- **Personalização**: Define como o chatbot se apresenta
- **Exemplo**: "Assistente Virtual", "Maya - Atendimento", "Bot da Loja"
- **Impacto**: Aparece no cabeçalho do chat
#### Nome da Empresa
- **Personalização**: Identifica sua empresa no chat
- **Exemplo**: "Empresa XYZ", "Loja Virtual", "Consultoria ABC"
- **Impacto**: Aparece junto ao nome do bot
#### Avatar da IA
- **Formato**: JPG ou PNG
- **Tamanho máximo**: 5MB
- **Dimensões recomendadas**: 1024x1024 pixels
- **Uso**: Representa visualmente seu chatbot
### Tipo e Posicionamento
#### Tipo de Chat
- **Bolha** (recomendado): Ícone circular que abre o chat
- **Caixa**: Widget sempre visível na página
#### Tamanho da Bolha
- **Pequeno**: Discreta, menos chamativa
- **Médio** (padrão): Equilíbrio entre visibilidade e discrição
- **Grande**: Mais visível, chama mais atenção
#### Posição do Chat
- **Superior esquerdo**: Canto superior esquerdo da tela
- **Superior direito**: Canto superior direito da tela
- **Inferior esquerdo**: Canto inferior esquerdo da tela
- **Inferior direito** (padrão): Posição mais comum e intuitiva
### Modos de Exibição
Configure quais elementos visuais serão exibidos:
- ☑️ **Mostrar avatar do usuário**: Exibe ícone do usuário nas mensagens
- ☑️ **Mostrar avatar da IA**: Exibe avatar do bot nas respostas
- ☑️ **Mostrar animação da IA**: Efeito visual durante processamento
- ☑️ **Mostrar bolha com animação da IA**: Animação na bolha principal
### Configurações Avançadas (Modo Avançado)
#### Margem
- **Controle**: Slider de ajuste
- **Função**: Define distância das bordas da tela
- **Valores**: 0px a 50px
#### Espaçamento
- **Controle**: Slider de ajuste
- **Função**: Espaçamento interno dos elementos
- **Valores**: 0px a 30px
#### Raio da Borda
- **Controle**: Slider de ajuste
- **Função**: Arredondamento das bordas
- **Valores**: 0px (quadrado) a 30px (muito arredondado)
---
## Configuração de Cores
### Cores Básicas
#### Cor Primária
- **Padrão**: #8E6EF4 (roxo)
- **Uso**: Botões principais, destaques, cabeçalho
- **Recomendação**: Use a cor principal da sua marca
#### Cor da Fonte
- **Padrão**: #FFFFFF (branco)
- **Uso**: Texto em botões e elementos destacados
- **Dica**: Garanta contraste adequado com a cor primária
#### Cor do Fundo do Modal
- **Padrão**: #1B1C23 (cinza escuro)
- **Uso**: Fundo da janela de chat
- **Importante**: Escolha cor que não canse a vista
### Cores Avançadas (Modo Avançado)
Quando o modo avançado está ativo, você tem acesso a:
#### Interface e Botões
- **Cor do botão de abertura**
- **Cor do erro**: Para mensagens de erro
- **Cor do placeholder**: Texto de exemplo nos campos
- **Cor da fonte do prompt**: Texto da área de digitação
- **Cor do botão do prompt**: Botão de enviar mensagem
#### Animações e Efeitos
- **Cor do fundo da animação da IA**
- **Cor do ícone da animação da IA**
- **Cor do backdrop do modal**: Fundo escuro atrás do chat
#### Elementos da Interface
- **Cor do texto do botão de fechar**
- **Cor do divisor**: Linhas separadoras
- **Cor do link**: Links clicáveis nas mensagens
- **Cor do ícone de carregamento**: Indicador de espera enquanto o chatbot responde
#### Mensagens
- **Cor do fundo da mensagem do usuário**
- **Cor do fundo da mensagem da IA**
- **Cor do fundo do prompt dentro do modal**
#### Avatares
- **Cor do fundo dos avatares**
- **Cor da borda dos avatares**
---
## Personalidade do Chatbot
### Perfil Comunicativo
Configure como seu chatbot se comunica com os usuários:
#### Papel
Escolha a função principal do seu chatbot:
- **Vendedor** (padrão): Foco em conversão e vendas
- **Representante**: Atendimento geral e suporte
- **Professor**: Educativo e explicativo
#### Personalidade
Defina o tom de comunicação:
- **Confiante**: Seguro e assertivo
- **Descontraído**: Casual e amigável
- **Informal**: Linguagem próxima e pessoal
- **Formal**: Linguagem corporativa e profissional
- **Dedicado**: Atencioso e comprometido
- **Nerd**: Técnico e detalhista
- **Apaixonado**: Entusiasmado e energético
- **Irreverente**: Divertido e despojado
### Instruções Restritivas
Configure limitações importantes para o comportamento do chatbot:
#### Exemplos de Restrições:
1. **"Não mencione preços de serviços ou faça orçamentos, sempre indique o contato com um especialista."**
2. **"Não faça julgamentos ou comparações com produtos concorrentes. Apenas enfatize as qualidades de nossos produtos."**
3. **"Não responda com códigos de qualquer linguagem de programação."**
#### Como Criar Boas Restrições:
- ✅ **Seja específico** sobre o que não deve ser feito
- ✅ **Inclua alternativas** quando possível
- ✅ **Use linguagem clara** e direta
- ✅ **Teste as restrições** com perguntas reais
---
## Informações e Mensagens
### Mensagens do Sistema
#### Mensagem de Boas-vindas
- **Padrão**: "Olá, como posso ajudar?"
- **Personalização**: Primeira impressão do usuário
#### Placeholder
- **Padrão**: "Fale-me o que procura e vou lhe ajudar"
- **Função**: Texto de exemplo no campo de digitação
#### Mensagens Avançadas (Modo Avançado)
- **Mensagem de fechar chat**: "Recolher conversa"
- **Mensagem de erro**: "Desculpe, não entendi o que você quis dizer."
### Perguntas Exemplo
Configure sugestões de perguntas para facilitar a interação:
#### Exemplos Padrão:
1. **"Olá, gostaria de conhecer seu portfólio"**
2. **"Qual seu contato para orçamento?"**
#### Funcionalidades:
- ➕ **Adicionar mais perguntas**: Até 5 sugestões
- ➖ **Remover perguntas**: Delete sugestões desnecessárias
- ✏️ **Editar perguntas**: Personalize conforme seu negócio
### Configurações de Resposta
#### Perfil de Respostas
- **Criativo**: Respostas mais elaboradas e variadas
- **Balanceado** (padrão): Equilíbrio entre criatividade e precisão
- **Preciso**: Respostas diretas e objetivas
#### Desabilitar Chat Temporariamente
❌ **Desabilitado**: Chat funcionando normalmente
☑️ **Habilitado**: Chat temporariamente fora do ar
**Períodos disponíveis quando habilitado:**
- **4 horas**: Manutenção rápida
- **24 horas**: Manutenção estendida
- **7 dias**: Pausa prolongada
---
## Controles de Ação
### Botões Principais
#### SALVAR
- **Função**: Aplica todas as alterações
- **Importante**: Sempre salve após fazer mudanças
#### DESFAZER ALTERAÇÕES
- **Função**: Reverte para última versão salva
- **Uso**: Quando quiser recomeçar a customização
---
## Preview em Tempo Real
### Funcionalidades do Preview
#### Visualização Instantânea
- ✅ **Mudanças imediatas**: Veja alterações em tempo real
- ✅ **Teste de cores**: Verifique contrastes e harmonia
- ✅ **Simulação real**: Comportamento idêntico ao site
- ✅ **Teste de mensagens**: Veja como ficam as configurações
:::tip Dica de UX
Um chatbot bem personalizado pode aumentar significativamente o engajamento dos usuários. Invista tempo na personalização visual e comunicativa!
:::
:::warning Importante
Sempre teste suas configurações no preview antes de salvar. Pequenos ajustes podem fazer grande diferença na experiência do usuário.
:::
---
## Instalação do Chatbot
:::warning Importante
Para acessar as opções de instalação do chatbot, você precisa ter um conteúdo treinado em sua base de conhecimento. Adicione arquivos, sites ou FAQs e aguarde o processamento.
:::
A instalação do chatbot WiseMind é um processo simples que permite integrar o assistente virtual ao seu site de forma rápida e eficiente. Esta seção explica todos os métodos disponíveis e como implementá-los.
## Gerar link de demonstração
Para testar o chatbot antes de instalar, você pode gerar um link de demonstração clicando no botão "Gerar Link de Demonstração". Será criado um link temporário que você pode compartilhar e testar o funcionamento do chatbot em uma página de demonstração.
## Método de Instalação
#### Características
- **Integração simples**: Um único script para adicionar ao seu site
- **Compatibilidade garantida**: Funciona em qualquer site HTML
### Instalação no modo Bubble
Para instalar o chatbot usando o Bubble, copie o código e cole-o no final do body do seu site.
```javascript
```
### Instalação no modo Caixa
Para instalar o chatbot no modo Caixa, é necessário adicionar uma div com o ID `ws__chat-box` no final do body do seu site, além do script.
```html
```
A instalação correta do chatbot WiseMind garante uma experiência perfeita para seus usuários e máximo aproveitamento da ferramenta.
---
## Puxa-Papo
:::info Funcionalidade Premium
Esta funcionalidade é exclusiva para os planos **Padrão**, **Pro** e **Enterprise**, não estando disponível para o plano Gratuito.
:::
O WiseMind inclui um módulo de Puxa-Papo que permite ao chatbot iniciar conversas automaticamente com os usuários. Isso pode ajudar a engajar visitantes do site, oferecer assistência proativa e melhorar a experiência geral do usuário, você pode configurar assuntos comuns para iniciar conversas e frases envolventes para atrair a atenção dos visitantes.
:::info Contexto Atual
O Puxa-Papo é sempre relativo ao contexto selecionado. Verifique no topo da página: **"O Puxa-Papo está sendo editado no contexto: [CONTEXTO_ATUAL]"**
:::
## Assunto do Puxa-Papo
Defina assuntos comuns para iniciar conversas com os visitantes do site.
### Configurações dos Assuntos
Você pode adicionar, editar ou remover assuntos conforme necessário.
Exemplo
```
- "Benefícios do nosso produto"
- "Temos descontos especiais para novos clientes"
- "Posso ajudar você a encontrar o que procura?"
```
O botão **"PREVIEW"** permite visualizar como o Puxa-Papo aparecerá no site e testar o funcionamento do assunto antes de publicá-lo. Você pode adicionar múltiplos assuntos para diversificar as opções de início de conversa.
## Configurações de Proatividade
A seção de Configurações de Proatividade permite ajustar quando e como o Puxa-Papo será exibido para os visitantes do site. Você pode definir o tempo de atraso antes do Puxa-Papo aparecer, levando em consideração o período de inatividade do usuário.
Os períodos disponíveis são:
- **30 segundos**
- **2 minutos**
- **Outro** (opção personalizada)
- Nunca inicializar o Puxa-Papo
O Puxa-Papo é uma ferramenta poderosa para aumentar o engajamento dos visitantes e oferecer suporte proativo. Ajuste as configurações conforme necessário para otimizar a experiência do usuário no seu site.
---
## Teste do Chatbot
:::warning Importante
Para acessar a página de teste do chatbot, você precisa ter um conteúdo treinado em sua base de conhecimento. Adicione arquivos, sites ou FAQs e aguarde o processamento.
:::
O sistema de teste do WiseMind permite que você veja como o chatbot funcionará antes de instalá-lo em seu site. Esta funcionalidade é essencial para ajustar a configuração e garantir que tudo está funcionando corretamente.
## Acessando o Teste
### Localização
- **Aba "Teste"** na seção de Chatbot
### Interface de Teste
A interface de teste apresenta uma réplica exata de como o chatbot aparecerá em seu site, incluindo:
- Todas as personalizações visuais aplicadas
- Configurações de comportamento
- Base de conhecimento ativa
- Contextos definidos
## Funcionalidades do Teste
### Simulação Completa
- **Aparência Real**: Veja exatamente como o chatbot ficará no seu site
- **Funcionalidade Completa**: Teste todas as funcionalidades, incluindo respostas da IA
- **Configurações Aplicadas**: Todas as personalizações são refletidas no teste
### Teste de Conversas
Durante o teste, você pode:
- Fazer perguntas ao chatbot
- Testar diferentes tipos de consultas
- Verificar a qualidade das respostas
### Validação de Configurações
O teste permite verificar:
- **Personalidade**: Se o tom das respostas está adequado
- **Base de Conhecimento**: Se as informações corretas estão sendo utilizadas
- **Contextos**: Se os contextos estão funcionando apropriadamente
- **Aparência**: Se cores, textos e posicionamento estão corretos
## Cenários de Teste Recomendados
### Teste Básico
1. **Cumprimento Inicial**
- Veja se a mensagem de boas-vindas aparece
- Teste a mensagem inicial configurada
2. **Perguntas Simples**
- Faça perguntas básicas sobre sua empresa
- Teste informações que estão na base de conhecimento
---
## Contextos
Os contextos são uma funcionalidade fundamental do WiseMind que permite organizar e segmentar seu conteúdo de forma inteligente, criando diferentes "universos" de conhecimento para seus chatbots.
## O que são Contextos?
Contextos são **assuntos aos quais os conteúdos são relacionados**. Eles funcionam como containers que agrupam informações específicas, permitindo que você tenha diferentes chatbots especializados em temas distintos.
### Exemplo Prático
**Cenário 1: Site Corporativo**
- Se você quer um chatbot para seu site, todo o conteúdo adicionado deve estar relacionado ao contexto "Site"
- O chatbot responderá apenas sobre informações do site
**Cenário 2: Processos Internos**
- Para um chatbot de processos internos da empresa, crie um contexto "Processos Internos"
- O chatbot da intranet responderá apenas sobre processos internos
## Como Funcionam os Contextos
### Hierarquia de Contextos
#### Contextos Conectados
- Contextos "filhos" podem **enxergar** o conteúdo do contexto "pai"
- O contrário **não acontece** - contextos "pai" não enxergam conteúdo dos "filhos"
#### Exemplo de Conexão:
```
Contexto "Site" (Principal)
└── Contexto "Processos Internos" (Conectado)
```
**Resultado:**
- ✅ Chatbot de "Processos Internos" responde sobre processos E sobre o site
- ❌ Chatbot do "Site" responde APENAS sobre o site
### Contexto Principal
Por padrão, o WiseMind inicia com um **Contexto Principal** que é criado automaticamente.
:::info Uso Simples
Se você precisa de apenas um chatbot para um único assunto, não é necessário criar novos contextos. Adicione o conteúdo normalmente no Contexto Principal.
:::
## Gerenciando Contextos
### Visualização de Contextos
A tela de contextos exibe caixas organizadas com o nome de cada contexto criado.
**Exemplos de contextos:**
- Principal
- Sites de Notícias
- Testes
- Atendimento ao Cliente
- Produtos e Serviços
### Criando um Novo Contexto
1. **Acesse a tela de Contextos**
2. **Clique em "Criar Novo Contexto"**
3. **Defina o nome** do contexto
4. **Configure a hierarquia** (se necessário)
5. **Salve as alterações**
### Editando Contextos
1. **Clique no contexto** que deseja editar
2. **Modifique as informações** necessárias
3. **Ajuste conexões** com outros contextos
4. **Salve as alterações**
### Removendo Contextos
:::warning Segurança de Dados
Não se preocupe! Seu conteúdo não será perdido caso precise remover ou renomear um contexto. O WiseMind preserva suas informações.
:::
1. **Selecione o contexto** a ser removido
2. **Confirme a ação** de remoção
3. **Escolha o destino** do conteúdo (se aplicável)
## Casos de Uso Comuns
### 1. E-commerce Multi-categoria
```
Contexto Principal: Loja Online
├── Roupas Femininas
├── Roupas Masculinas
├── Calçados
└── Acessórios
```
### 2. Empresa de Serviços
```
Contexto Principal: Empresa
├── Atendimento ao Cliente
├── Processos Internos
├── Produtos
└── Suporte Técnico
```
### 3. Portal de Notícias
```
Contexto Principal: Portal
├── Esportes
├── Política
├── Economia
└── Entretenimento
```
## Impacto nos Chatbots
### Seleção de Contexto
Você pode alternar entre contextos usando o dropdown de contexto no header.
### Configurações por Contexto
Cada contexto mantém configurações independentes para:
- **Base de conhecimento**
- **Aparência do chatbot**
- **Links de direcionamento**
- **Personalidade e instruções**
:::info Lembre-se
A mudança de contexto no header da aplicação afeta todas as configurações e visualizações. Sempre verifique em qual contexto você está trabalhando.
:::
---
## Conversas
O sistema de gerenciamento de conversas do WiseMind oferece uma visão completa de todas as interações entre usuários e o chatbot, permitindo análise detalhada, suporte aprimorado e otimização contínua do atendimento.
## Visão Geral das Conversas
### Interface Principal
A tela de conversas apresenta:
- **Lista de conversas**: Todas as interações registradas
- **Filtros avançados**: Para encontrar conversas específicas
- **Ferramentas de busca**: Localizar conversas rapidamente
### Informações Disponíveis
Para cada conversa, você tem acesso a:
- **Número de mensagens**: Quantidade de interações
- **Data e hora**: Quando a conversa ocorreu
- **Tipo** da conversa: Informação, Elogio, Reclamação, Outro
- **Sentimento**: Análise automática do tom da conversa
## Filtros e Busca
### Filtros Disponíveis
#### Por Período
- **Hoje**: Dados do dia atual
- **7 Dias**: Últimos 7 dias
- **30 Dias**: Último mês
- **60 Dias**: Últimos 2 meses
- **90 Dias**: Últimos 3 meses
#### Por Contexto
- **TODOS** (padrão): Exibe métricas de todos os contextos
- **Contextos específicos**: Opções dinâmicas baseadas nos contextos criados
#### Por Objetivo
- **Todos** (padrão): Exibe todas as conversas
- **Elogios**: Conversas com feedback positivo
- **Reclamação**: Conversas com feedback negativo
- **Informação**: Conversas buscando informações
- **Outro**: Conversas que não se encaixam nas categorias acima
#### Por Sentimento
- **Todos** (padrão): Exibe todas as conversas
- **Positivo**: Conversas com sentimento positivo
- **Neutro**: Conversas com sentimento neutro
- **Negativo**: Conversas com sentimento negativo
#### Se Desejou Falar com Humano
- **Sim**: Conversas onde o usuário solicitou atendimento humano
- **Não**: Conversas resolvidas pelo chatbot
## Detalhes da Conversa
Para cada conversa, você pode clicar para ver detalhes e será redirecionado para a tela de detalhes da conversa, onde poderá revisar conversas anteriores e analisar o histórico de interações.
O sistema de conversas do WiseMind oferece visibilidade completa sobre as interações dos usuários, permitindo melhoria contínua do atendimento e otimização da experiência do cliente.
---
## Dashboard
O Dashboard é a página inicial do WiseMind, onde você pode acompanhar todas as métricas e informações importantes sobre o desempenho dos seus chatbots em tempo real.
## Visão Geral
Aqui você poderá ver o resumo dos seguintes itens principais:
- **Contextos Ativos**: Quantidade de contextos criados e ativos
- **Links Ativos**: Número de links de direcionamento configurados
- **Consumo de Crédito**: Uso atual dos créditos baseado no seu plano
- **Conteúdos Ativos**: Quantidade de conteúdos na base de conhecimento
## Cards de Resumo
### Card de Contextos Ativos
Exibe a quantidade de contextos que você tem ativos/criados. Os contextos são gerenciados na seção [Contextos](/docs/contexts).
### Card de Links Ativos
Mostra a quantidade de links de direcionamento que você adicionou, configurados na [Base de Conhecimento/Links](/docs/knowledge-base/links).
### Card de Consumo de Crédito
Exibe a quantidade de crédito gasta até o momento, baseado no seu plano de assinatura (Gratuito, Padrão ou Pro).
### Card de Conteúdos Ativos
Apresenta a quantidade de conteúdos cadastrados na [Base de Conhecimento/Conteúdo](/docs/knowledge-base/contents) que estão ativos.
## Filtros e Controles
### Filtragem de Período
Você pode filtrar as informações dos gráficos por diferentes períodos:
- **Hoje**: Dados do dia atual
- **7 Dias**: Últimos 7 dias
- **30 Dias**: Último mês
- **60 Dias**: Últimos 2 meses
- **90 Dias**: Últimos 3 meses
### Filtragem de Contexto
Filtre as métricas por contexto específico:
- **TODOS** (padrão): Exibe métricas de todos os contextos
- **Contextos específicos**: Opções dinâmicas baseadas nos contextos criados
:::tip Dica
A seleção dos filtros de período e contexto impacta diretamente nos gráficos de interações, permitindo uma análise mais detalhada dos dados.
:::
## Gráficos de Interações
### Gráfico de Interações de Hoje
Este gráfico plano exibe as interações do dia atual, mostrando o fluxo de conversas ao longo do dia.
**Características:**
- Atualização em tempo real
- Visualização por hora
- Indicadores de picos de atividade
### Gráfico de Interações por Período
Gráfico que mostra as interações baseadas no período selecionado nos filtros, permitindo análise de tendências e padrões.
**Características:**
- Adaptável aos filtros de período
- Visualização de tendências
- Comparação entre diferentes contextos
:::info Informação
O Dashboard é atualizado em tempo real, fornecendo sempre as informações mais recentes sobre o desempenho dos seus chatbots.
:::
---
## Insights
:::info Funcionalidade Premium
Esta funcionalidade é exclusiva para o plano **Enterprise**, não estando disponível para o plano Gratuito, Padrão ou Pro.
:::
Insights são análises detalhadas coletadas a partir das interações do chatbot, fornecendo informações valiosas sobre o desempenho e a eficácia do atendimento automatizado, te ajudando a identificar áreas de melhoria e oportunidades de otimização.
O chatbot analisa padrões de conversa, tipos de perguntas frequentes e comportamento dos usuários para gerar Insights estratégicos e recomendações de melhorias nas informações fornecidas.
### Informações Disponíveis
Para cada Insight, você terá acesso a:
- **Título**: Resumo do Insight
- **Assunto**: Categoria do Insight (Ex.: UX, Performance, Conteúdo)
- **Contexto**: Contexto relacionado ao Insight
- **Quantidade de conversas**: Número de interações que geraram o Insight
- **Período de análise**: Intervalo de tempo considerado
## Filtros
### Filtros Disponíveis
#### Por Período
- **Hoje**: Dados do dia atual
- **7 Dias**: Últimos 7 dias
- **30 Dias**: Último mês
- **60 Dias**: Últimos 2 meses
- **90 Dias**: Últimos 3 meses
#### Por Contexto
- **TODOS** (padrão): Exibe métricas de todos os contextos
- **Contextos específicos**: Opções dinâmicas baseadas nos contextos criados
#### Favoritos
Exibe Insights marcados como favoritos para fácil acesso e referência futura.
#### Arquivados
Exibe Insights que foram arquivados, permitindo revisão e reativação conforme necessário.
# Detalhes do Insight
Para cada Insight, você pode clicar no botão "Ver Detalhes" ou clicar diretamente na linha do Insight para ver mais informações, incluindo:
- **Descrição detalhada** do Insight
- **Expressões extraídas** das interações que geraram o Insight
### Recomendações do WiseMind
O WiseMind pode fornecer recomendações específicas para melhorar o desempenho do chatbot com base no Insight identificado. Analise essas recomendações e implemente as mudanças sugeridas para otimizar a experiência do usuário, as recomendações incluem:
- **Funcionalidade** (Ex.: Adicionar FAQ para resolver dúvidas comuns, Melhorar Resposta de precificação)
- **Como realizar** (Ex.: Incluir mais detalhes na resposta, Adicionar variações da pergunta)
### Classificação do Insight
#### Anotação Interna
Adicione notas internas para registrar ações tomadas ou observações relevantes sobre o Insight, facilitando o acompanhamento e a colaboração com sua equipe.
#### Nota de Importância
Classifique o Insight com uma nota de 1 a 5 estrelas, ajudando a priorizar ações com base na relevância e impacto do Insight identificado.
#### Possibilidade de Implementação
Classifique a viabilidade de implementar as recomendações associadas ao Insight, considerando fatores como recursos disponíveis, complexidade técnica e alinhamento com os objetivos do negócio.
#### Favoritar e Arquivar
- **Favoritar**: Marque Insights importantes para fácil acesso futuro
- **Arquivar**: Remova Insights que já foram tratados ou não são mais relevantes, mantendo a lista organizada
---
## Integrações
:::info Funcionalidade Premium
Esta funcionalidade é exclusiva para o plano **Enterprise**, não estando disponível para o plano Gratuito, Padrão ou Pro.
:::
:::info Informação
No momento, o WiseMind oferece integrações com as seguintes plataformas:
- **Notifyme**: Atendimento inteligente via WhatsApp Business
:::
O WiseMind oferece integrações que permitem conectar seu chatbot a diversas plataformas, ampliando suas funcionalidades e facilitando a gestão do conhecimento.
## Integração com Notifyme
A integração com o Notifyme permite que você utilize o chatbot do WiseMind para atendimento via WhatsApp Business, proporcionando uma experiência de suporte automatizado e eficiente.
Maiores detalhes sobre a integração com o Notifyme podem ser encontrados na [documentação oficial do Notifyme](https://docs.notifyme.com.br/).
---
## Monitoramento de Interação
:::info Funcionalidade Premium
Esta funcionalidade é exclusiva para os planos **Padrão**, **Pro** e **Enterprise**, não estando disponível para o plano Gratuito.
:::
O Monitoramento de Interações permite avaliar os atendimentos feitos aos seus clientes ao longo do tempo, fornecendo insights valiosos sobre a qualidade e efetividade do seu chatbot.
## Controles de Filtro
### Filtragem de Período
Filtre os dados por diferentes períodos para análise temporal:
- **30 Dias**: Análise do último mês
- **60 Dias**: Análise dos últimos 2 meses
- **90 Dias**: Análise dos últimos 3 meses
### Filtragem de Contexto
Analise métricas específicas por contexto:
- **Todos** (padrão): Exibe métricas de todos os contextos
- **Contextos específicos**: Opções dinâmicas baseadas nos contextos criados
## Gráficos e Métricas
### Gráfico de Objetivos
Gráfico de barras com pontos de ligamento que mostra a distribuição dos tipos de interações.
**Ao passar o mouse, o tooltip exibe:**
- **Interações**: Quantidade total
- **Elogios**: Quantidade de feedbacks positivos
- **Informação**: Solicitações de informações
- **Reclamações**: Feedbacks negativos
- **Outro**: Outras categorias de interação
### Gráfico de Sentimento
Gráfico de barras que exibe o sentimento avaliado pelo WiseMind nas conversas.
**O tooltip do gráfico mostra:**
- **Quantidade de Interações**: Total de conversas analisadas
- **Positivo**: Percentual e quantidade de interações positivas
- **Neutro**: Percentual e quantidade de interações neutras
- **Negativo**: Percentual e quantidade de interações negativas
### Desejou Falar com Humano?
Gráfico de pizza que mostra a porcentagem das conversas onde o usuário desejou falar com um atendente humano.
**Labels do gráfico:**
- **Sim**: Percentual e quantidade de interações onde foi solicitado atendimento humano
- **Não**: Percentual e quantidade de interações resolvidas pelo chatbot
### Finalizou a Conversa Satisfeito?
Gráfico de pizza que mostra a porcentagem das conversas que foram finalizadas com satisfação.
**Labels do gráfico:**
- **Sim**: Percentual e quantidade de conversas finalizadas com satisfação
- **Não**: Percentual e quantidade de conversas não satisfatórias
## Card de Insights
O card de **insights** oferece uma visão rápida sobre os últimos insights gerados pelo WiseMind. **Insights** são extraídos automaticamente das conversas para ajudar na melhoria contínua do atendimento, explicados melhor na seção de [Insights](/docs/insights).
**Informações exibidas:**
- **Botão "FAVORITAR"**: Adiciona o insight aos favoritos para fácil acesso
- **Título do insight** gerado
- **Assunto** relacionado ao insight
- **Contexto** onde o insight foi identificado
- **Quantidade de conversas analizadas** para gerar o insight
- **Período de análise** utilizado
- **Botão "ARQUIVAR"**: Move o insight para a seção de arquivados
- **Botão "VER DETALHES"**: Acessa a página detalhada do insight
## Card de Análise de SEO
O card de análise de SEO fornece informações sobre a otimização do seu site para mecanismos de busca.
**Informações exibidas:**
- **URL do site** utilizada para análise
- **Contexto** onde a análise está configurada
- **Botão "VER TODOS"**: Redireciona para [Base de Conhecimento/Conteúdo](/docs/knowledge-base/contents)
- **Botão "VER ANÁLISE SEO"**: Acessa detalhes completos da análise de SEO
:::tip Dica
Use os filtros de período e contexto para identificar padrões específicos e otimizar o desempenho do seu chatbot de forma direcionada.
:::
:::warning Atenção
As métricas de sentimento são analisadas automaticamente pelo WiseMind usando inteligência artificial. Para resultados mais precisos, mantenha sua base de conhecimento sempre atualizada.
:::
---
## WiseMind
Chatbots avançados de IA personalizados e treinados com base em seus dados para fornecer respostas precisas e relevantes.
## Quem Somos
**WiseMind** é uma plataforma projetada para revolucionar a forma como as empresas interagem com seus clientes, utilizando a Inteligência Artificial para criar chatbots personalizados e altamente eficientes. Com o WiseMind, os usuários podem treinar seus chatbots com base em seus próprios dados, garantindo que as respostas sejam precisas, relevantes e alinhadas com a identidade da marca. Além de permitir que seu atendimento ao cliente seja **24/7**, reduzindo custos operacionais e aumentando a satisfação do cliente.
## Nossa Missão
Ajudar empresas a melhorar o atendimento ao cliente e otimizar processos internos por meio de chatbots inteligentes, proporcionando uma experiência de usuário excepcional e eficiente.
## Grupo Wise
O WiseMind faz parte do Grupo Wise, uma fábrica de software de Curitiba com mais de 25 anos de experiência no mercado de tecnologia. Com mais de 150 colaboradores especializados, o Grupo Wise oferece soluções completas e inovadoras, não apenas como uma fábrica de software, mas como uma verdadeira fábrica de soluções.
---
## Conteúdo
A Base de Conhecimento é o coração do seu chatbot no WiseMind. Aqui você carrega e adiciona conteúdos para treinar sua IA com seus próprios dados, garantindo respostas precisas e relevantes aos seus usuários.
:::info Contexto Atual
Os conteúdos são sempre relativos ao contexto selecionado. Verifique no topo da página: **"Os conteúdos são relativos ao contexto: [CONTEXTO_ATUAL]"**
:::
## Formas de Adicionar Conteúdo
O WiseMind oferece três maneiras principais de adicionar conhecimento ao seu chatbot:
### 1. Capturar Site
### 2. Subir Arquivo
### 3. Perguntas e Respostas
## 1. Capturar o Seu Site
Permite que o WiseMind seja treinado diretamente com o conteúdo do seu site.
### Como Usar:
1. **Acesse a aba "Capturar o seu Site"**
2. **Insira a URL** do site no campo de entrada
3. **Clique em "Capturar"** para iniciar o processo
4. **Aguarde o processamento** - o WiseMind analisará todo o conteúdo
### Vantagens:
- ✅ **Atualização automática** quando o site muda
- ✅ **Captura completa** de páginas e seções
- ✅ **Processamento inteligente** de textos e estruturas
- ✅ **Manutenção simplificada** do conteúdo
### Exemplo de URL:
```
https://www.meusite.com.br
https://blog.empresa.com
https://loja.exemplo.com/produtos
```
### Opções de Captura
- **Sincronizar frequentemente**: Ao ativar esta opção, o WiseMind verificará semanalmente o site em busca de novas informações ou atualizações de conteúdo.
- **Buscar novas páginas**: Com esta opção habilitada, o WiseMind identificará e capturará automaticamente novas páginas adicionadas ao site, garantindo que o chatbot permaneça sempre atualizado. A busca também é realizada semanalmente.
## 2. Subir um Arquivo
Faça upload de documentos e arquivos existentes para treinar o chatbot.
### Formatos Suportados:
- **PDF** - Documentos, manuais, catálogos
- **TXT** - Arquivos de texto simples
- **DOC** - Documentos do Microsoft Word
- **DOCX** - Documentos do Microsoft Word (versões mais recentes)
- **MD** - Arquivos Markdown
### Limitações:
- **Tamanho máximo**: 10MB por arquivo
- **Processamento**: Automático após upload
- **Encoding**: UTF-8 recomendado para textos
### Como Usar:
1. **Acesse a aba "Subir um Arquivo"**
2. **Clique na área de upload** ou arraste o arquivo
3. **Selecione o arquivo** do seu computador
4. **Aguarde o upload** e processamento automático
## 3. Perguntas e Respostas (FAQ)
Crie uma base de conhecimento estruturada com perguntas frequentes e suas respectivas respostas.
### Como Funciona:
1. **Adicione uma pergunta** comum dos usuários
2. **Escreva a resposta** correspondente
3. **O WiseMind analisa** e pode melhorar a resposta
4. **Adiciona detalhes sutis** para tornar mais natural
### Exemplo:
```
Pergunta: "Qual o horário de funcionamento?"
Resposta: "Funcionamos de segunda a sexta, das 8h às 18h,
e aos sábados das 8h às 12h."
```
### Melhorias Automáticas do WiseMind:
- ✨ **Linguagem mais natural**
- ✨ **Contexto adicional**
- ✨ **Variações da pergunta**
- ✨ **Respostas mais completas**
## Gerenciamento da Base de Conhecimento
### Ferramentas de Controle
#### Caixa de Pesquisa
- **Filtre conteúdos** por URLs, nomes de arquivos ou palavras-chave
- **Busca inteligente** em todos os campos
- **Resultados em tempo real**
#### Exibir Contextos Superiores
- ☑️ **Marque esta opção** para ver conteúdos de contextos hierarquicamente superiores
- 📊 **Visão completa** da herança de conhecimento
- 🔗 **Entenda as conexões** entre contextos
### Tabela de Conteúdos
A tabela exibe todos os conteúdos com informações organizadas:
#### Colunas da Tabela:
**Arquivos/URLs**
- Nome do arquivo ou URL capturada
- Clique para visualizar detalhes
**Contexto**
- Contexto ao qual o conteúdo pertence
- Indicador visual de herança
**Formato**
- Tipo de arquivo (PDF, TXT, URL, FAQ)
- Ícone representativo do formato
**Status**
- ✅ **Treinado**: Conteúdo processado e ativo
- ⏳ **Processando**: Em análise pelo WiseMind
- ⏳ **Aguardando**: Aguardando processamento
**Atualizado em**
- Data e hora da última modificação
- Ordenação cronológica disponível
**Ações**
- **Editar**: Modifica informações
- **Excluir**: Remove o conteúdo
- **Desativar**: Para de usar sem excluir
### Funcionalidades da Tabela
#### Ordenação Interativa
- **Clique nas colunas** para ordenar
- **Indicadores visuais** de ordenação ativa
- **Ordenação múltipla** por diferentes critérios
#### Paginação
- **Navegação por páginas** para grandes volumes
- **Controle de itens** por página
- **Indicadores de posição** atual
#### Filtros Dinâmicos
- **Filtros automáticos** baseados na aba selecionada
- **Combinação de filtros** para busca específica
:::tip Dica de Performance
Para melhor performance, combine diferentes tipos de conteúdo: use FAQs para perguntas comuns, sites para informações atualizadas e arquivos para documentação detalhada.
:::
:::warning Importante
Sempre verifique se você está no contexto correto antes de adicionar conteúdo. O conteúdo adicionado será associado ao contexto ativo no momento.
:::
---
## Links
A funcionalidade de Links de Direcionamento permite definir palavras-chave que serão automaticamente transformadas em links personalizados nas respostas do seu chatbot, melhorando a experiência do usuário e direcionando-o para ações específicas.
:::info Contexto Atual
Os links de direcionamento são sempre relativos ao contexto selecionado. Verifique no topo da página: **"Os links de direcionamento são relativos ao contexto: [CONTEXTO_ATUAL]"**
:::
## Como Funciona
O sistema de links funciona por **substituição inteligente**:
- Quando uma **palavra-chave** aparece na resposta do chatbot
- Ela é automaticamente **transformada em um link** clicável
- O link direciona para a **URL configurada**
- A substituição acontece **apenas na primeira ocorrência** da palavra
### Exemplo Prático:
```
Palavra-chave: "orçamento"
URL: https://www.meusite.com/orcamento
Resultado: Todas as vezes que o chatbot mencionar "orçamento",
a palavra se tornará um link clicável.
```
## Configurando Links de Direcionamento
### Campos de Configuração:
#### 1. Palavra-chave
- **Digite a palavra** ou expressão que será substituída
- **Seja específico** para evitar substituições indesejadas
- **Use termos relevantes** que aparecem frequentemente nas respostas
#### 2. Diferenciar maiúsculas e minúsculas
☑️ **Marcado**: "Orçamento" ≠ "orçamento" ≠ "ORÇAMENTO"
❌ **Desmarcado**: "Orçamento" = "orçamento" = "ORÇAMENTO"
#### 3. URL de Destino
- **URL completa** incluindo https://
- **Pode ser externa** (outros sites) ou interna (seu site)
- **Teste sempre** se o link funciona corretamente
**Exemplo de URL:**
```
https://link.site.com
https://www.meusite.com/contato
https://loja.exemplo.com/produtos/item-123
```
#### 4. Campo Avançado (Opcional)
☑️ **Ative esta opção** para substituir a palavra por um texto diferente no link
**Exemplo:**
- **Palavra original**: "contato"
- **Substituir por**: "Fale conosco"
- **Resultado**: Link aparece como "Fale conosco" mas a palavra detectada é "contato"
## Processo de Criação
### Passo a Passo:
1. **Preencha a palavra-chave** que será substituída
2. **Configure as opções** de maiúsculas/minúsculas conforme necessário
3. **Insira a URL** de destino completa
4. **Configure campo avançado** se quiser texto diferente no link
5. **Clique em "SUBSTITUIR E TREINAR"** para ativar
### Treinamento Automático
Após configurar, o WiseMind:
- ✅ **Processa a nova regra** de substituição
- ✅ **Atualiza a base** de conhecimento
- ✅ **Ativa o link** para uso imediato
## Gerenciamento de Links
### Tabela de Links Configurados
A tabela exibe todos os links configurados com informações organizadas:
#### Colunas da Tabela:
**Palavra**
- Palavra-chave que é detectada nas respostas
- Base para a substituição automática
**URL**
- Endereço de destino do link
- Pode ser clicada para teste direto
**Substituir por**
- Texto alternativo exibido no link (se configurado)
- Vazio quando usa a palavra original
**Diferenciar maiúsculas**
- ✅ **Sim**: Case-sensitive ativado
- ❌ **Não**: Case-insensitive ativado
## Casos de Uso Comuns
#### 1. E-commerce
```
Palavra: "carrinho"
URL: https://loja.com/carrinho
Uso: Direcionar para carrinho de compras
```
#### 2. Suporte
```
Palavra: "suporte"
URL: https://site.com/suporte
Substituir por: "Central de Ajuda"
```
#### 3. Contato
```
Palavra: "whatsapp"
URL: https://wa.me/5511999999999
Substituir por: "Conversar no WhatsApp"
```
#### 4. Produtos Específicos
```
Palavra: "produto-premium"
URL: https://loja.com/premium
Substituir por: "Conheça nosso produto Premium"
```
:::tip Dica de Conversão
Use links estratégicos para direcionar usuários para ações importantes como "comprar", "contratar", "agendar" ou "contatar". Isso pode aumentar significativamente suas conversões.
:::
---
## Limites
:::info Funcionalidade Premium
Esta funcionalidade é exclusiva para os planos **Padrão**, **Pro** e **Enterprise**, não estando disponível para o plano Gratuito.
:::
Os limites de crédito podem ser distribuídos entre diferentes contextos, permitindo controle granular sobre o uso da plataforma. Cada contexto pode ter seu próprio limite de crédito, que é deduzido do limite total da conta.
Você pode monitorar o uso de créditos em cada contexto individualmente, bem como o uso total da conta e créditos distribuídos, garantindo que você nunca exceda seu orçamento.
## Distribuir créditos igualmente
Você pode optar por distribuir os créditos igualmente entre todos os contextos. Por exemplo, se você tem 3 contextos e um limite total de 600 créditos, cada contexto receberá 200 créditos, e o restante será distribuído conforme o uso.
## Configurações
### Notificação
Se habilitada, você receberá um e-mail quando o uso de créditos atingir os níveis de alerta de 60% e crítico de 90%.
### Limite de uso
Você pode configurar uma mensagem personalizada que será exibida aos usuários quando o limite de créditos for atingido. Isso permite informar os usuários sobre a situação e possíveis ações a serem tomadas.
O sistema de limites do WiseMind oferece controle total sobre o uso da plataforma, garantindo performance otimizada e custos previsíveis, com flexibilidade para crescer conforme sua necessidade.
---
## Planos e Assinaturas
O WiseMind oferece diferentes planos de assinatura que permitem adaptar o uso da plataforma de acordo com suas necessidades. Nesta seção você pode visualizar os benefícios de cada plano, alterar seu plano atual, gerenciar informações de pagamento e acompanhar cobranças.
## Planos Disponíveis
O WiseMind disponibiliza quatro opções de planos, cada um com recursos e limites diferentes:
- **Gratuito**
- **Padrão**
- **Pro**
- **Enterprise**
Cada plano oferece benefícios que vão desde personalização do chatbot até recursos avançados como insights estratégicos, análise de SEO e monitoramento de interações.
## Comparação de Planos
Na seção de **Planos** é possível visualizar uma tabela comparativa com os recursos incluídos em cada nível de assinatura, além dos limites de:
- **Subcontextos**
- **Bases de conhecimento**
- **Links de direcionamento personalizados**
- **Créditos mensais**
## Informações de Pagamento
Ao alterar ou cadastrar um método de pagamento, o usuário deve informar:
- Número do cartão
- Data de validade
- Código de segurança
- País
## Resumo do Pedido
No lado direito da tela, é exibido um **resumo do pedido**, incluindo:
- Nome do plano selecionado
- Valor proporcional (caso a troca seja feita no meio do ciclo atual)
- Valor integral a ser cobrado na próxima fatura
O botão **"Finalizar pedido"** confirma a alteração do plano ou atualização do método de pagamento.
---
## Preferências da Conta
A seção de **Preferências** permite que cada usuário personalize sua experiência no WiseMind de acordo com suas necessidades.
Aqui é possível configurar o tema visual do sistema, idioma, fuso horário e o tipo de perfil de conta.
## Como Acessar
Para acessar as preferências da conta, clique no seu avatar no canto superior direito da tela e selecione **Preferências** no menu suspenso.
## Tema de Exibição
O usuário pode escolher entre dois temas de exibição:
- **Claro** (padrão)
- **Escuro**
Essa configuração afeta toda a interface do sistema.
## Comunicação
Na seção de comunicação, o usuário define:
- **Idioma**: escolha o idioma preferido para a interface do sistema.
Exemplos: `PT-BR`, `EN-US`, `ES-ES`.
- **Fuso horário**: selecione o fuso horário adequado para a sua região.
Essa configuração garante que todas as informações relacionadas a horários sejam exibidas corretamente.
Após ajustar essas opções, clique em **Salvar** para confirmar.
## Perfil da Conta
O WiseMind oferece dois tipos de perfil de conta:
- **Pessoal**: indicado para uso individual.
- **Corporativo**: indicado para empresas ou equipes que utilizam a plataforma de forma colaborativa.
Selecione o perfil desejado e clique em **Salvar** para aplicar a configuração.
## Exclusão de Conta
Na parte inferior da seção de **Perfil da Conta**, o usuário encontra a opção **Excluir minha conta**.
Essa ação é **irreversível** e resultará no agendamento de exclusão de todos os dados associados à conta.
:::caution Atenção
Antes de excluir sua conta, certifique-se de que não há informações importantes que precisarão ser recuperadas no futuro.
:::
---
## Registro e Login
Na tela de **Registro**, o usuário informa apenas o **endereço de e-mail** para iniciar a criação da conta.
### Política e Termos
Antes de avançar, o usuário deve estar ciente de que:
> A WiseMind coleta e usa dados pessoais em conformidade com a nossa **[Política de Privacidade](https://admin.wisemind.chat/privacy)**.
> Ao criar uma conta, você concorda com nossos **[Termos e Condições](https://admin.wisemind.chat/terms)**.
Após preencher o e-mail, basta clicar em **Criar Conta**.
Caso já possua cadastro, pode retornar ao login através do link **"Já possui uma conta? Entre aqui."**
## Verificação de E-mail
Após o registro inicial, é enviada uma mensagem para o e-mail informado contendo um **código de verificação**.
Na tela de **Verificação de E-mail**, o usuário deve:
1. Inserir o código recebido.
2. Confirmar para prosseguir com a criação da conta.
Se o código não tiver sido recebido, há a opção **Reenviar** para solicitar um novo código.
## Conclusão do Registro
Com o e-mail já verificado, o usuário deve **completar o cadastro** informando os seguintes dados:
- **Endereço de e-mail** (pré-preenchido e validado)
- **Nome completo**
- **Telefone** (opcional)
- **Endereço do website** (ex.: `https://website.com/`)
- **Senha**
### Requisitos da Senha
A senha deve atender aos seguintes critérios:
- Mínimo de **8 caracteres**
- Conter **pelo menos um número**
- Ter **maiúsculas e minúsculas**
- Incluir **ao menos um caractere especial**
Após preencher todas as informações, o usuário deve clicar em **Criar Conta** para finalizar o processo.
## Login
Na tela de **Login**, o usuário pode acessar sua conta existente informando:
- **Email**
- **Senha**
Além disso, estão disponíveis as seguintes opções:
- **Esqueci minha senha** → Redireciona para o fluxo de recuperação de senha.
- **Não possui uma conta? Registre-se.** → Encaminha para a tela de criação de conta.
O botão **Entrar** autentica o usuário e libera acesso ao sistema.
---
## Usuários
O sistema de gerenciamento de usuários do WiseMind permite controlar acessos, definir permissões e organizar equipes para colaboração efetiva na gestão dos chatbots. Esta funcionalidade é essencial para empresas que precisam de múltiplos colaboradores trabalhando na plataforma.
## Convidar Usuários
1. Acesse a seção **Usuários** no menu lateral.
2. Clique em **Convidar Usuário**.
3. Insira o e-mail do usuário que deseja convidar.
4. Defina o **tipo de acesso** (Proprietário, Administrador, Editor, Visualizador).
5. Escolha os **contextos** aos quais o usuário terá acesso.
6. Clique em **Convidar**.
Será enviado um e-mail ao usuário com instruções para criar sua conta e acessar a plataforma.
## Visão Geral de Usuários
### Tipos de Usuário
O WiseMind oferece diferentes níveis de acesso:
- **Proprietário**: Controle total sobre a conta e todas as funcionalidades.
- **Administrador**: Gerencia usuários, configurações e projetos.
- **Editor**: Pode criar e editar conteúdos, mas não gerencia usuários.
- **Visualizador**: Acesso somente leitura para monitoramento.
O sistema de usuários do WiseMind oferece controle completo sobre acessos e permissões, garantindo que cada membro da equipe tenha exatamente os recursos necessários para seu trabalho, mantendo a segurança e facilitando a colaboração.