Manual do Analitik

O Analitik é uma ferramenta que permite conversar com seus dados como se você estivesse falando com um analista. Você envia planilhas (CSV ou Excel) ou conecta uma aba do Google Sheets, faz perguntas em português comum, e recebe respostas em texto, tabelas e gráficos — sem precisar saber fórmulas, SQL ou programação.

Ele foi feito para pequenas e médias empresas que têm dados espalhados e querem responder perguntas do dia a dia rapidamente: quanto vendemos no mês passado? quais são meus 10 melhores clientes? qual produto tem margem maior?

Imagine que a ferramenta tem três papéis internos, trabalhando juntos:

1. O organizador — quando você envia dados, ele lê tudo, identifica colunas, tipos (número, texto, data) e guarda de forma organizada.
2. O tradutor — pega sua pergunta em português e traduz para uma consulta que os dados organizados entendem.
3. O redator — recebe o resultado da consulta e monta uma resposta clara para você, com texto, tabela e, quando faz sentido, um gráfico.

Você só precisa se preocupar em enviar dados bons e perguntar bem.

1. Você recebe um convite por e-mail do administrador da sua conta com um usuário e uma senha temporária.
2. Abra o app e entre com esse e-mail e senha.
3. Na primeira entrada, o sistema pede para você trocar a senha. Escolha algo forte (pelo menos 8 caracteres, misturando letras e números).
4. Pronto. Você já cai na tela principal com os áreas de análise liberados para você e um tour de boas-vindas para guiar seus primeiros passos.

Se esquecer a senha, peça ao administrador da sua conta para redefinir — ele consegue gerar uma nova senha temporária pela tela de "Gerenciar equipe".

Ao entrar pela primeira vez, aparece um checklist com 4 passos guiando você até sua primeira análise:

1. Criar seu primeiro área de análise (só para super usuários).
2. Conectar seus dados — enviar planilha ou conectar Google Sheets.
3. Definir regras de contexto (opcional, mas melhora as respostas).
4. Fazer sua primeira pergunta no chat.

Cada passo é marcado automaticamente como concluído conforme você avança. Você pode pular o tour a qualquer momento pelo "X" no canto do card.

Dica: Fechou o tour e quer revê-lo? Clique no seu avatar (canto inferior esquerdo) e escolha "Ver tour de boas-vindas" — ele volta a aparecer na sessão atual.

Além deste manual, você tem um assistente de ajuda disponível em qualquer tela do Analitik. Ele responde dúvidas sobre como usar a plataforma em português, considerando seu perfil, plano e organização.

Três formas de abrir:

1. Ícone ❓ Ajuda no rodapé da barra lateral, sempre visível.
2. Ícone ❓ no cabeçalho do chat do workspace.
3. Digitando @ajuda (ou /ajuda) como primeira palavra no campo do chat — abre o painel e já leva sua dúvida pronta.

O assistente aparece num painel lateral que se sobrepõe à tela — nada do que você estava fazendo é perdido. É só fechar para voltar exatamente de onde parou.

O que ele faz:

• Explica funcionalidades, mostra onde clicar e sugere próximos passos.
• Sabe seu plano e avisa quando algo depende de upgrade.
• Diferencia super usuário de usuário comum e adapta as instruções.
• Mantém o histórico da sua conversa de ajuda para você retomar depois.

O que ele NÃO faz:

• Não analisa seus dados — para isso, use o chat do workspace.
• Não acessa dados de outros usuários ou de outras organizações.

Importante: perguntas feitas ao assistente de ajuda não consomem a cota de perguntas do seu plano. Existe apenas um limite anti-abuso de 30 perguntas por dia por organização.

Quatro palavras que aparecem o tempo todo:

• Organização — sua empresa dentro do sistema. Reúne todos os usuários e áreas de análise do seu negócio.
• Área de análise — uma área de trabalho para um assunto (ex.: Vendas, Financeiro). Tem 3 abas: Painel, Chat e Config.
• Planilha — um conjunto de dados enviado (arquivo CSV/Excel ou aba do Google Sheets). Pode ser atualizado com novas versões.
• Conversa — um bate-papo com a IA dentro de um workspace. Você pode ter várias conversas separadas por tema.

Formatos aceitos: CSV (.csv), Excel (.xlsx) e abas do Google Sheets.

Enviando um arquivo (CSV/Excel):

1. Entre na área de análise desejado.
2. Vá na aba Config e arraste o arquivo na área de upload — ou clique no botão "+ Novo planilha".
3. O sistema faz um Raio-X: mostra as colunas encontradas, tipos e uma prévia das primeiras linhas.
4. Confirme e a planilha já fica disponível para perguntas.

Conectando o Google Sheets:

1. Na aba Config, escolha "Importar do Google Sheets".
2. Autorize sua conta Google (só é preciso na primeira vez).
3. Cole o link da planilha e escolha a aba que quer trazer.
4. O Analitik importa os dados e faz o Raio-X normalmente.

Existe também a rota Dados da organização (no menu lateral) para gerenciar todas as planilhas da empresa em um só lugar, independente da área de análise.

O que faz uma "boa planilha":

• Uma linha de cabeçalho no topo, com nomes claros (ex.: "Cliente", "Data da Venda", "Valor").
• Uma informação por coluna (evite juntar "Nome e Telefone" numa célula só).
• Sem células mescladas, sem títulos flutuantes no meio da planilha.
• Datas em formato consistente (todas em "dd/mm/aaaa", por exemplo).
• Valores em número puro — evite símbolos de moeda misturados no meio.

Dica: Enviar a mesma planilha de novo não apaga a versão antiga. O sistema guarda o histórico e passa a usar a versão mais recente automaticamente.

O que acontece logo depois do envio: o sistema cria automaticamente uma conversa chamada 📋 Raio-X: <nome da planilha> e já responde sozinho com um resumo executivo — perfil dos dados, principais colunas, alertas de qualidade e sugestões de análise. Você não precisa perguntar nada; é só ler.

O Raio-X aparece só nessa conversa criada pela ingestão. Conversas novas abertas pelo botão Nova não repetem esse resumo — em vez disso trazem cards de perguntas sugeridas (veja "Fazendo perguntas").

Na aba Chat da área de análise, escreva como se estivesse falando com um colega. Alguns exemplos que funcionam bem:

• "Qual foi o faturamento total por mês em 2025?"
• "Quais são meus 10 maiores clientes por valor comprado?"
• "Compare as vendas de janeiro com as de fevereiro."
• "Quantos pedidos ainda estão em aberto?"
• "Mostre em gráfico a evolução das vendas por semana."

Lendo a resposta: normalmente você recebe um texto explicativo, uma tabela com os números e, quando faz sentido, um gráfico. Cada resposta pode ser regenerada se você achar que ficou incompleta.

Dica: Se a resposta não veio como esperado, refine: em vez de "vendas", diga "vendas por mês em 2025 considerando apenas pedidos pagos". Quanto mais específico, melhor.

Criar nova conversa: use uma nova conversa para cada tema (ex.: uma para "análise de vendas", outra para "controle de estoque"). Isso ajuda a IA a manter o contexto certo.

Sugestões prontas em novas conversas: ao abrir uma conversa pelo botão Nova, o chat mostra 6 cards de perguntas sugeridas baseadas nas colunas do dataset. Enquanto elas carregam, aparecem cartões cinza pulsando (skeletons) — mas o campo de digitação já funciona, você pode perguntar sem esperar. Clicar num card envia a pergunta como se você tivesse digitado. As sugestões ficam salvas e só são regeneradas quando você reenvia o dataset.

A aba Painel é a tela padrão de todo workspace. Ela mostra automaticamente uma visão consolidada dos seus dados:

• Cartões de KPI — números principais (totais, médias, contagens) calculados a partir dos planilhas do workspace.
• Gráficos — séries temporais, rankings e distribuições relevantes para os dados que você enviou.
• Alertas de qualidade — quando o sistema detecta valores estranhos ou colunas incompletas.

O painel se atualiza sozinho quando você envia uma nova versão de um dataset. Ele é ótimo para acompanhamento diário, enquanto o Chat serve para perguntas específicas.

Às vezes, no meio de uma conversa, a IA percebe que você deu uma informação importante que vale para todas as análises futuras — por exemplo, "cliente VIP é quem comprou mais de R$ 10 mil" ou "pedidos com status X devem ser ignorados".

Nesses momentos, aparece um card "📝 Contexto aprendido" abaixo da resposta, listando as regras que ela sugere salvar. Você pode:

• Marcar/desmarcar cada regra individualmente.
• Editar o texto antes de salvar.
• Clicar em "Salvar regras" — elas vão para as Regras do workspace em 1 clique.
• Ou "Ignorar" se não fizer sentido no momento.

Dica: Isso é o jeito mais rápido de ensinar o Analitik sobre o seu negócio: em vez de abrir a aba Config, você aprova as regras à medida que a conversa acontece.

Existem dois lugares para dar orientações à IA:

• Instruções da conversa — valem só naquela conversa. Ex.: "Considere sempre valores em reais" ou "Ignore os pedidos cancelados neste bate-papo".
• Regras da área de análise — valem para todas as conversas do workspace. Ex.: "Nosso ano fiscal vai de julho a junho" ou "Cliente VIP é quem comprou mais de R$ 10 mil no ano".

Há duas formas de gerenciar planilhas:

• Dentro de uma área de análise — na aba Config, você vê todas as planilhas vinculadas àquele área de análise, pode enviar novos (arrastando arquivo, clicando em "+ Novo planilha" ou conectando Google Sheets) e substituir versões antigas.
• Na tela "Dados da organização" — acessível pela barra lateral, lista todas as planilhas da empresa em um só lugar, útil para reaproveitar a mesma base em vários workspaces.

Em ambas as telas você encontra:

• Prévia das linhas de cada dataset.
• O histórico de versões quando você reenvia o mesmo arquivo.
• Botões para substituir ou remover.

Usuários comuns têm acesso somente leitura. Enviar, substituir ou remover planilhas exige perfil de super usuário.

Aqui você ajusta o "cérebro" da área de análise:

• Nome e descrição — como a área de análise aparece na barra lateral.
• Regras da área de análise — orientações que a IA sempre considera (o card "Contexto aprendido" grava aqui).
• Contexto da empresa — o que sua empresa faz, termos internos, jargões.
• Planilhas — envio, substituição e conexão com Google Sheets (veja "Gerenciar seus dados").
• Catálogo de colunas — descreve cada coluna importante ("Valor" é em reais, "Status" pode ser aberto/pago/cancelado). Você pode marcar colunas como sensíveis para elas não aparecerem em respostas resumidas.

No menu do seu avatar (canto inferior esquerdo da tela), escolha Gerenciar equipe. Aqui você pode:

• Convidar novos usuários pelo e-mail. O sistema gera uma senha temporária que você entrega ao colega.
• Redefinir senha de qualquer membro se ele esquecer.
• Definir acessos — marcar em quais áreas de análise cada usuário comum pode entrar.
• Remover usuários que saíram da empresa.

Você (super usuário) tem acesso a todas as áreas de análise automaticamente. O controle granular vale para os usuários comuns.

No menu do avatar (canto inferior esquerdo da tela), escolha Uso do plano para acompanhar:

• Planilhas — quantas planilhas/conexões estão em uso frente ao limite do plano.
• Perguntas do mês — quantas consultas a IA já respondeu neste ciclo.

As barras (e o mini-indicador da barra lateral) ficam amarelas a partir de 70% do limite e vermelhas a partir de 90%. Chegando perto do topo, considere fazer upgrade.

Na mesma tela você também vê a comparação de planos disponíveis e um botão para solicitar upgrade via WhatsApp — nosso time responde rápido para liberar o novo limite.

Use workspaces separados quando os assuntos não conversam entre si. Exemplos:

• Uma área de análise para Vendas e outro para Financeiro.
• Uma área de análise por filial quando os dados são independentes.
• Uma área de análise de testes para experimentar antes de subir para produção.

Clique em + Nova área de análise na barra lateral, dê um nome e comece a enviar dados. Áreas de análise são ilimitados em todos os planos.

• Nomes claros para planilhas ("Vendas 2025" é melhor que "planilha1").
• Revise os tipos depois do Raio-X — se uma data virou texto, corrija a planilha e reenvie.
• Aprove as regras sugeridas no card "Contexto aprendido" sempre que fizerem sentido — a IA fica mais precisa a cada regra salva.
• Marque colunas sensíveis (CPF, salário) na aba Config.
• Escreva regras claras em vez de repetir o mesmo contexto em toda pergunta.
• Uma conversa por tema — evita misturar contextos e melhora as respostas.

A IA pode errar? Sim, como qualquer analista. Sempre confira números importantes antes de decisões críticas. Se algo parecer estranho, refaça a pergunta com mais detalhes ou peça para "mostrar as linhas que geraram esse resultado".

Meus dados ficam seguros? Cada organização tem seus dados isolados. Só quem você convida vê o que está lá dentro. Colunas marcadas como sensíveis ficam protegidas contra exposição em respostas resumidas.

Posso apagar tudo? Sim. Você pode remover planilhas, conversas e até áreas de análise inteiros. Super usuários podem apagar a organização — mas essa ação é definitiva.

Como troco minha senha? Clique no seu avatar (canto inferior esquerdo da tela) e escolha "Trocar senha". Se esqueceu a atual, peça ao super usuário da sua conta para redefinir.

Como reabro o tour de boas-vindas? No menu do avatar (canto inferior esquerdo), clique em "Ver tour de boas-vindas". O checklist volta a aparecer na sessão atual.

Preciso reimportar o Google Sheets toda vez que a planilha muda? Sim — hoje a importação é sob demanda. Use o botão de reimportar para trazer a versão mais recente da aba conectada.

Posso usar no celular? Sim. A interface se adapta a telas menores. Para envio de planilhas grandes, o computador ainda oferece a melhor experiência.

Ficou com dúvida ou encontrou algo estranho? Fale com o super usuário da sua conta — ele consegue resolver a maioria das situações (acessos, senhas, limites). Para problemas técnicos ou upgrade de plano, o super usuário abre um chamado com nosso suporte pelo WhatsApp direto da tela "Uso do plano".

Você também pode abrir o assistente de ajuda (ícone ❓ na barra lateral ou digitando @ajuda no chat) para tirar dúvidas rápidas sobre a plataforma sem sair da tela onde você está.