MidTalk

FAQ MidTalk

Central de Ajuda e Perguntas Frequentes

Para resetar sua senha: 1. Acesse a página de login 2. Clique em 'Esqueci minha senha' 3. Digite seu email 4. Verifique sua caixa de entrada 5. Siga as instruções do email recebido

Para criar um novo usuário: 1. Acesse o menu 'Usuários' 2. Clique em 'Novo Usuário' 3. Preencha nome, email e perfil 4. Clique em 'Salvar' 5. O usuário receberá um email com a senha temporária

1. Verifique se o email está correto (sem espaços)
2. Confirme se a senha está correta (cuidado com Caps Lock)
3. Limpe o cache do navegador (Ctrl+Shift+Del)
4. Tente outro navegador
5. Contate o administrador para verificar se sua conta está ativa

1. Contate o administrador do sistema
2. Solicite reset de senha
3. Use a senha temporária fornecida
4. Altere para uma senha pessoal no primeiro acesso

1. Verifique se você tem perfil de Administrador
2. Acesse 'Usuários' no menu
3. Clique 'Novo Usuário'
4. Preencha nome, email, senha e perfil
5. Clique 'Salvar'

1. Acesse 'Usuários' no menu
2. Encontre o usuário na lista
3. Clique em 'Editar'
4. Gere nova senha temporária
5. Informe a nova senha ao usuário

1. Verifique se o usuário está com status 'Ativo'
2. Confirme se a senha foi informada corretamente
3. Teste fazer login com as credenciais
4. Verifique se o email está correto
5. Reative o usuário se necessário

1. Digite 'quero falar com técnico' no chat
2. Use o botão 'Transferir para técnico' se disponível
3. Explique que a IA não resolveu seu problema
4. Aguarde a transferência ser processada
5. Forneça detalhes completos do problema

1. Use a busca com palavras-chave diferentes
2. Procure em categorias relacionadas
3. Verifique se não há erro de digitação
4. Tente termos mais genéricos
5. Use o chat para fazer a pergunta diretamente

1. Reporte o problema através do chat
2. Informe qual FAQ está incorreta
3. Forneça a informação correta se souber
4. Aguarde atualização da equipe
5. Use o chat para obter informação atual

IA (Automático): 24 horas por dia, 7 dias por semana - Resposta imediata

Técnicos (Humanos): Segunda a Sexta, 8h às 18h - Resposta até 30 minutos

Emergências: 24/7 para problemas críticos - Marque como urgente no chat

1. Use o chat para contato imediato
2. Marque como 'urgente' se disponível
3. Forneça telefone para contato
4. Explique o impacto do problema
5. Aguarde confirmação de recebimento

1. Verifique se email já existe no sistema
2. Confirme se todos campos obrigatórios estão preenchidos
3. Valide formato do email
4. Teste inserção direta no banco
5. Verifique constraints da tabela

1. Verifique implementação de autorização
2. Valide filtros por usuário nas consultas
3. Confirme roles e permissions
4. Teste cenários de acesso cruzado
5. Implemente logs de auditoria

1. Implemente hash de senhas (BCrypt)
2. Nunca armazene senhas em texto plano
3. Use salt para aumentar segurança
4. Valide força das senhas
5. Force troca de senhas padrão

Para gerar relatórios: 1. Vá para o menu 'Relatórios' 2. Selecione o período desejado 3. Escolha os filtros (status, técnico, categoria) 4. Clique em 'Gerar Relatório' 5. O relatório será exibido e pode ser exportado em PDF ou Excel

O dashboard mostra: - Chamados Abertos: tickets ainda não resolvidos - Tempo Médio: tempo médio de resolução - Taxa de Resolução IA: percentual resolvido pela IA - Usuários Ativos: usuários que abriram chamados no período - Gráficos mostram tendências por dia/semana/mês

Para configurar notificações: 1. Acesse 'Configurações' > 'Notificações' 2. Ative/desative tipos de notificação 3. Configure frequência (imediata, diária, semanal) 4. Defina destinatários por perfil 5. Teste o envio 6. Salve as configurações

Para configurar a IA: 1. Vá em 'Configurações' > 'Inteligência Artificial' 2. Ajuste limite de tentativas antes de escalar 3. Configure nível de confiança mínimo 4. Atualize base de conhecimento 5. Teste as configurações 6. Salve as alterações

1. Verifique se a FAQ está marcada como 'Ativa'
2. Confirme se foi salva corretamente
3. Aguarde alguns minutos para sincronização
4. Atualize o site público (F5)
5. Verifique se não há erros de digitação

1. Ao criar/editar FAQ, preencha o campo 'Categoria'
2. Use nomes consistentes (ex: 'Hardware', 'Software')
3. Evite categorias muito específicas
4. Agrupe temas relacionados
5. Revise periodicamente a organização

Navegadores recomendados:
- Google Chrome (versão 90+)
- Mozilla Firefox (versão 88+)
- Microsoft Edge (versão 90+)
- Safari (versão 14+)

Certifique-se de ter JavaScript e cookies habilitados.

1. Acesse logs do container: docker logs pim-api
2. Verifique arquivo de log no servidor
3. Use ferramentas de monitoramento (ELK, Splunk)
4. Configure níveis de log apropriados
5. Implemente structured logging

1. Use endpoint /health para status
2. Monitore tempo de resposta das APIs
3. Acompanhe uso de recursos do servidor
4. Configure alertas para problemas
5. Implemente métricas customizadas

1. Configure backup automático do SQL Server
2. Teste restauração regularmente
3. Armazene backups em local seguro
4. Documente procedimentos de recovery
5. Monitore espaço disponível

1. Edite arquivo knowledge/base_conhecimento.md
2. Use formato pergunta-resposta claro
3. Adicione exemplos e variações
4. Execute reload: /api/ai/knowledge/reload
5. Teste com perguntas similares

1. Organize conhecimento por seções claras
2. Use cabeçalhos e separadores
3. Evite informações contraditórias
4. Teste com perguntas específicas
5. Refine prompts de contexto

Ajuste TEMPERATURE (0.1-1.0):
- 0.1-0.3: Respostas mais precisas
- 0.7-1.0: Respostas mais criativas

Configure MAX_TOKENS (limite de resposta)
Personalize prompts no código
Treine com exemplos específicos

1. Implemente cache para perguntas repetidas
2. Reduza MAX_TOKENS para respostas menores
3. Otimize prompts para ser mais eficiente
4. Configure rate limiting
5. Monitore uso através do Google Cloud Console

1. Use endpoint /health regularmente
2. Monitore tempo de resposta
3. Configure alertas para falhas
4. Acompanhe logs de erro
5. Implemente métricas customizadas

1. Versione arquivo base_conhecimento.md no Git
2. Faça backup regular do diretório knowledge/
3. Documente mudanças importantes
4. Mantenha histórico de versões
5. Teste restauração periodicamente

1. Ajuste SESSION_TIMEOUT conforme necessário
2. Implemente renovação automática de sessão
3. Configure cleanup periódico
4. Monitore uso de memória
5. Notifique usuário antes da expiração

1. Ajuste limites de rate limiting
2. Implemente cache para reduzir requisições
3. Otimize polling de mensagens
4. Configure whitelist para IPs confiáveis
5. Monitore padrões de uso

1. Verifique espaço disponível no destino
2. Confirme permissões de escrita
3. Valide se banco não está em uso exclusivo
4. Teste backup manual primeiro
5. Configure job de backup automático

1. Verifique se backup não está corrompido
2. Confirme versão compatível do SQL Server
3. Pare aplicações que usam o banco
4. Use REPLACE se necessário
5. Valide caminhos dos arquivos de dados

1. Configure SQL Server Agent (se disponível)
2. Use scripts PowerShell/batch agendados
3. Configure backup para storage externo
4. Teste restauração regularmente
5. Monitore sucesso dos backups

O MidTalk é um sistema integrado de suporte técnico que combina Inteligência Artificial com atendimento humano para otimizar o suporte empresarial.

O sistema de IA do MidTalk utiliza o Google Gemini para responder automaticamente às perguntas dos usuários. A IA analisa a pergunta, consulta a base de conhecimento e fornece uma resposta contextualizada. Se não conseguir resolver, transfere automaticamente para um técnico humano.

Se o sistema estiver lento: 1. Verifique sua conexão com internet 2. Limpe cache do navegador (Ctrl+Shift+Del) 3. Tente em modo anônimo 4. Verifique se há muitas abas abertas 5. Reinicie o navegador 6. Se persistir, entre em contato com o suporte técnico

Para resolver sessão expirada: 1. Faça logout completo do sistema 2. Limpe cookies do navegador 3. Feche todas as abas do sistema 4. Faça login novamente 5. Se o problema persistir, pode ser configuração de timeout - contate o administrador

Para resolver problemas no chat: 1. Atualize a página (F5) 2. Verifique se JavaScript está habilitado 3. Desative bloqueadores de pop-up 4. Teste em outro navegador 5. Verifique conexão com internet 6. Se não resolver, reporte o problema ao suporte

A escalação automática funciona assim: 1. IA tenta responder a pergunta 2. Se confiança for baixa (<40%) ou usuário pedir técnico, escala imediatamente 3. Se IA não resolver após várias tentativas, escala automaticamente 4. Técnico recebe notificação 5. Conversa continua com humano 6. Histórico é mantido

1. Verifique sua conexão com a internet
2. Feche outras abas do navegador
3. Atualize a página (F5)
4. Limpe o cache do navegador
5. Reinicie o navegador

1. Verifique se você está logado como técnico
2. Confirme se há chamados atribuídos a você
3. Atualize a página (F5)
4. Verifique filtros aplicados na lista
5. Contate o administrador para verificar atribuições

1. Verifique se o chamado está com status 'Ativo'
2. Confirme se o chamado está atribuído a você
3. Tente atualizar a página
4. Verifique se há conexão com internet
5. Tente usar outro navegador

1. Atualize a página (F5)
2. Aguarde alguns segundos para sincronização
3. Verifique sua conexão
4. Limpe o cache do navegador
5. Contate suporte se persistir

1. Abra o chamado específico
2. Procure o botão 'Marcar como Resolvido'
3. Confirme a ação
4. O chamado sairá da sua lista ativa
5. Cliente receberá notificação de resolução

Causa: Sessão expirou ou credenciais inválidas
Solução: Faça login novamente no sistema

Causa: Problema no servidor
Solução: Aguarde alguns minutos e tente novamente. Se persistir, contate o suporte técnico

1. Aguarde o carregamento completo
2. Verifique se há muitos chamados em aberto
3. Atualize a página se travar
4. Use navegador atualizado
5. Contate suporte se persistir

1. Atualize a página (F5)
2. Verifique se JavaScript está habilitado no navegador
3. Desative bloqueadores de pop-up
4. Tente outro navegador (Chrome, Firefox, Edge)
5. Limpe o cache do navegador

1. Aguarde alguns segundos (IA pode estar processando)
2. Verifique sua conexão com internet
3. Tente reformular a pergunta de forma mais clara
4. Atualize a página e tente novamente
5. Use palavras-chave relacionadas ao seu problema

1. Seja mais específico na pergunta
2. Use termos técnicos conhecidos
3. Divida problemas complexos em partes menores
4. Consulte as FAQs disponíveis na página
5. Solicite transferência para técnico humano

1. Verifique se digitou corretamente
2. Use palavras mais simples
3. Tente sinônimos
4. Remova acentos e caracteres especiais
5. Navegue pelas categorias manualmente

1. Verifique sua conexão com internet
2. Atualize a página (F5)
3. Limpe cache e cookies do navegador
4. Tente modo anônimo/privado
5. Use outro dispositivo ou rede

1. Aguarde o carregamento completo da página
2. Verifique se JavaScript está habilitado
3. Desative extensões do navegador temporariamente
4. Tente clicar com botão direito e 'abrir em nova aba'
5. Use outro navegador

1. Verifique velocidade da sua internet
2. Feche outras abas e programas
3. Aguarde em horários de menor movimento
4. Use conexão cabeada se possível
5. Tente acessar mais tarde

1. Verifique se preencheu todos os campos obrigatórios
2. Confirme se o email está no formato correto
3. Reduza o tamanho da mensagem se muito longa
4. Remova caracteres especiais
5. Tente copiar e colar o texto novamente

1. Clique diretamente no campo de texto
2. Verifique se a página carregou completamente
3. Desative bloqueadores de script
4. Tente usar Tab para navegar entre campos
5. Atualize a página e tente novamente

1. Verifique se o SQL Server está rodando
2. Confirme as credenciais de conexão
3. Teste conectividade de rede com o banco
4. Verifique se a string de conexão está correta
5. Reinicie o serviço da API

1. Verifique se o serviço da API está ativo
2. Confirme se a porta 5000 está liberada
3. Teste acesso direto à API (http://servidor:5000/health)
4. Verifique logs do container/serviço
5. Reinicie o serviço se necessário

1. Verifique se a chave JWT está configurada
2. Confirme se o token não expirou
3. Valide configurações de issuer/audience
4. Limpe cookies e faça login novamente
5. Verifique sincronização de horário do servidor

1. Verifique se há dados no banco
2. Confirme filtros aplicados na consulta
3. Teste query diretamente no banco
4. Verifique logs da API para erros
5. Valide permissões do usuário

1. Verifique se FAQ foi salva corretamente
2. Confirme status 'Ativa' da FAQ
3. Teste endpoint de FAQs diretamente
4. Limpe cache da aplicação
5. Reinicie serviços se necessário

1. Verifique uso de CPU e memória do servidor
2. Analise queries lentas no banco de dados
3. Otimize índices das tabelas principais
4. Aumente recursos do servidor se necessário
5. Implemente cache para consultas frequentes

1. Monitore conexões ativas no SQL Server
2. Otimize queries mais pesadas
3. Implemente connection pooling
4. Aumente timeout de conexão
5. Considere escalonamento horizontal

1. Monitore uso de memória da aplicação
2. Identifique vazamentos de memória
3. Otimize consultas que retornam muitos dados
4. Implemente paginação em listas grandes
5. Aumente memória disponível

1. Configure CORS para domínios permitidos
2. Evite usar wildcard (*) em produção
3. Inclua headers necessários
4. Teste com diferentes origens
5. Valide métodos HTTP permitidos

1. Verifique se o serviço bot-ia está rodando
2. Confirme se a API Key do Gemini está válida
3. Teste endpoint diretamente: /api/ai/ask
4. Verifique logs do container para erros
5. Reinicie o serviço se necessário

1. Verifique se a base de conhecimento está atualizada
2. Recarregue conhecimento: /api/ai/knowledge/reload
3. Valide conteúdo do arquivo base_conhecimento.md
4. Ajuste parâmetros de temperatura (0.7 padrão)
5. Treine com mais exemplos específicos

1. Verifique conectividade com API do Google Gemini
2. Monitore uso de CPU/memória do serviço
3. Reduza MAX_TOKENS se necessário (padrão: 1000)
4. Otimize base de conhecimento (remover conteúdo desnecessário)
5. Considere cache para perguntas frequentes

1. Verifique se GEMINI_API_KEY está configurada
2. Confirme se a chave não expirou
3. Teste a chave diretamente na API do Google
4. Gere nova chave se necessário
5. Reinicie serviço após alterar chave

1. Execute atualização: /api/ai/update-knowledge
2. Verifique se FAQs estão sendo sincronizadas
3. Confirme conectividade com API backend
4. Valide formato do arquivo de conhecimento
5. Recarregue manualmente se necessário

1. Verifique se arquivo base_conhecimento.md existe
2. Confirme permissões de leitura do arquivo
3. Valide formato Markdown do conteúdo
4. Teste carregamento manual via endpoint
5. Recrie arquivo se corrompido

1. Verifique se bot-ia está na mesma rede Docker
2. Confirme porta 8001 está acessível
3. Teste conectividade: curl http://bot-ia:8001/health
4. Valide configuração BOT_IA_URL no proxy
5. Reinicie ambos os serviços

1. Configure URL do backend corretamente
2. Verifique conectividade de rede
3. Confirme endpoint /api/faq está funcionando
4. Valide formato de resposta da API
5. Implemente retry em caso de falha

1. Monitore uso de recursos (CPU/RAM)
2. Otimize carregamento da base de conhecimento
3. Implemente connection pooling
4. Configure timeout adequado
5. Escale horizontalmente se necessário

1. Verifique se há técnicos disponíveis no sistema
2. Confirme conectividade com API backend
3. Teste endpoint de criação de chamados
4. Valide se usuário forneceu dados completos (nome, email)
5. Reinicie proxy service se necessário

1. Verifique se chamado foi criado no backend
2. Confirme se há técnicos ativos no sistema
3. Valide sistema de atribuição automática
4. Teste notificações para técnicos
5. Verifique logs do serviço de atribuição

1. Verifique controle de sessão no proxy
2. Confirme se session_id está sendo mantido
3. Valide lógica de estado do chat
4. Implemente debounce para escalações
5. Limpe sessões órfãs periodicamente

1. Confirme se mensagem inicial está sendo salva
2. Valide formato dos dados enviados ao backend
3. Teste criação manual de chamado
4. Verifique se todos campos obrigatórios estão preenchidos
5. Implemente log detalhado da escalação

1. Verifique se session_id está sendo retornado
2. Confirme armazenamento de sessão no proxy
3. Valide timeout de sessão (padrão: 3600s)
4. Teste persistência entre requisições
5. Implemente cleanup de sessões expiradas

1. Verifique endpoint /api/proxy/chat-state/{session_id}
2. Confirme atualização de estado após escalação
3. Valide sincronização entre proxy e backend
4. Teste transições de estado manualmente
5. Implemente validação de estado

1. Verifique polling de mensagens no frontend
2. Confirme endpoint /api/proxy/messages/{session_id}
3. Valide last_message_id está sendo atualizado
4. Teste busca de mensagens manualmente
5. Implemente WebSocket para tempo real

1. Verifique se bot-ia está rodando
2. Confirme URL configurada: BOT_IA_URL
3. Teste conectividade: curl http://bot-ia:8001/health
4. Valide rede Docker entre containers
5. Implemente retry com backoff

1. Verifique se API backend está ativa
2. Confirme URL configurada: BACKEND_API_URL
3. Teste endpoints diretamente
4. Valide autenticação se necessária
5. Monitore logs de ambos os serviços

1. Verifique configuração CORS no proxy
2. Confirme origins permitidas
3. Valide headers necessários
4. Teste com diferentes navegadores
5. Configure proxy reverso se necessário

1. Monitore uso de CPU/memória
2. Otimize consultas ao backend
3. Implemente cache para dados frequentes
4. Configure connection pooling
5. Escale horizontalmente se necessário

1. Monitore número de sessões: /api/proxy/sessions
2. Reduza timeout de sessão se apropriado
3. Implemente limpeza automática
4. Configure limite máximo de sessões
5. Use armazenamento externo (Redis) se necessário

1. Otimize processo de criação de chamados
2. Implemente queue para escalações
3. Configure processamento assíncrono
4. Monitore tempo de resposta do backend
5. Implemente cache de técnicos disponíveis

1. Verifique se o serviço SQL Server está rodando
2. Confirme se a porta 1433 está liberada
3. Teste conectividade: telnet servidor 1433
4. Valide credenciais (sa/senha configurada)
5. Verifique configuração de rede do container

1. Confirme senha do usuário 'sa'
2. Verifique se ACCEPT_EULA=Y está configurado
3. Valide string de conexão das aplicações
4. Teste login direto no SQL Server Management Studio
5. Recrie container se necessário

1. Execute migrations da aplicação
2. Crie banco manualmente se necessário
3. Verifique se Entity Framework está configurado
4. Confirme string de conexão aponta para servidor correto
5. Restaure backup se disponível

1. Aumente timeout na string de conexão
2. Verifique latência de rede
3. Otimize queries lentas
4. Monitore uso de recursos do servidor
5. Configure connection pooling adequadamente

1. Identifique queries problemáticas com SQL Profiler
2. Analise planos de execução
3. Crie índices para colunas frequentemente consultadas
4. Otimize JOINs e WHERE clauses
5. Considere particionamento para tabelas grandes

1. Identifique processos bloqueantes
2. Otimize transações para serem mais rápidas
3. Use isolation levels apropriados
4. Evite transações longas
5. Implemente retry logic nas aplicações

1. Monitore queries mais custosas
2. Otimize índices (remover não utilizados)
3. Configure memória máxima do SQL Server
4. Atualize estatísticas das tabelas
5. Considere upgrade de hardware

1. Monitore crescimento dos arquivos de dados
2. Configure auto-growth adequadamente
3. Limpe logs de transação antigos
4. Implemente rotação de backups
5. Adicione mais espaço ao volume

1. Execute DBCC CHECKDB para verificar integridade
2. Identifique e corrija inconsistências
3. Restaure backup limpo se necessário
4. Implemente validações na aplicação
5. Configure backup automático regular

1. Verifique logs de transação
2. Identifique quando ocorreu a perda
3. Restaure backup point-in-time se possível
4. Analise aplicação para bugs de DELETE
5. Implemente auditoria para mudanças críticas

1. Identifique origem da duplicação
2. Crie constraints UNIQUE apropriadas
3. Limpe dados duplicados existentes
4. Valide lógica de inserção na aplicação
5. Implemente validações antes de INSERT

1. Configure collation correta (SQL_Latin1_General_CP1_CI_AS)
2. Valide encoding nas aplicações (.NET usa UTF-8)
3. Teste inserção de caracteres especiais
4. Configure connection string com charset correto
5. Migre dados se necessário