> ## Documentation Index
> Fetch the complete documentation index at: https://freshbase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# FAQ — Perguntas frequentes
> Respostas rápidas para as dúvidas mais comuns sobre o Freshbase.
Respostas rápidas para as dúvidas mais comuns sobre o Freshbase. Se não encontrar o que procura, consulte os [guias práticos](/how-to/create-first-base) ou entre em contato com o suporte.
## Primeiros passos
### O que é o Freshbase e para que serve?
O Freshbase é uma plataforma inteligente para a **fase de descoberta e planejamento** de projetos de software. Ele ajuda você a pensar antes de implementar: definir requisitos, quebrar tarefas grandes em partes menores, documentar decisões e extrair conhecimento de reuniões.
O princípio central é: **especificações são o novo código**. Em vez de pular direto para a programação, o Freshbase ajuda a estruturar e organizar as ideias primeiro.
### O Freshbase gera código?
**Não.** O Freshbase não é um agente de código, copilot ou ferramenta de programação. Ele é especializado em ajudar você a **planejar e documentar**. O assistente de IA ajuda a refinar requisitos, criar especificações, organizar ideias e processar reuniões — tudo em linguagem natural, sem código.
### Como criar minha conta e organização?
Ao acessar o Freshbase pela primeira vez, o sistema guia você por um processo de onboarding:
Uma introdução rápida à plataforma
Defina o nome da sua empresa ou equipe e um slug (identificador para a URL)
Dê um nome ao seu primeiro projeto
O assistente faz perguntas para entender o contexto da sua Base
Conecte seu calendário (opcional, pode fazer depois)
Adicione e-mails de colegas (opcional)
Veja as integrações disponíveis (Linear, transcrição, calendário)
Você pode pular etapas opcionais e configurá-las depois em **Configurações**.
### O que é uma "Base"? Como criar a primeira?
Uma Base é o espaço que reúne tudo sobre um projeto ou iniciativa: documentos, conversas com o assistente, transcrições de reuniões e configurações. Pense nela como uma "pasta inteligente" para um projeto.
No onboarding, você cria sua primeira Base automaticamente. Para criar novas Bases depois, vá em **Configurações > Bases > Nova base**.
Veja o guia completo
### Qual a diferença entre workspace pessoal e de equipe?
* **Workspace pessoal:** Criado automaticamente para você. Só você tem acesso. Ideal para notas pessoais e rascunhos.
* **Workspace de equipe:** Compartilhado com colegas. Criado quando você cria uma organização. Aqui ficam as Bases do time, com colaboração, registro de participantes e glossário compartilhado.
## Conversas com o assistente (Chat)
### Como iniciar uma conversa com o assistente?
Clique em **Chat** no menu lateral esquerdo. Você verá a tela de conversas. Clique em **Nova conversa** ou comece digitando na caixa de mensagem. O assistente responde em tempo real.
Na primeira vez, a tela mostra sugestões para você começar:
* **Explorar a base** — pede um resumo dos documentos e temas
* **Organizar ideias** — ajuda a estruturar requisitos
* **Criar documento** — gera um novo documento de especificação
* **Revisar tarefas** — identifica decisões e tarefas pendentes
### Que tipo de perguntas posso fazer?
Você pode pedir ajuda com qualquer tarefa de planejamento e documentação:
* "Quebre esse épico em histórias de usuário"
* "Quais são os requisitos que ainda estão ambíguos?"
* "Crie uma especificação para a funcionalidade de login"
* "O que foi decidido nas últimas reuniões sobre o projeto X?"
* "Me ajude a organizar as ideias do brainstorming"
O assistente tem acesso aos documentos da Base e pode ler, criar e editar documentos.
### Como o assistente cria documentos? Preciso aprovar?
Quando o assistente sugere criar ou editar um documento, ele mostra a proposta para você antes de aplicar. Você pode:
* **Aprovar** — as alterações são salvas
* **Pedir ajustes** — peça modificações na mesma conversa
* **Cancelar** — nada é alterado
Você sempre mantém o controle sobre o que é salvo na Base.
### Posso escolher entre modelos de IA diferentes?
Sim. No Chat, você pode selecionar entre dois modos:
* **Rápido** — respostas mais ágeis, ideal para tarefas simples
* **Pro** — respostas mais elaboradas, ideal para tarefas complexas
### Posso usar o assistente para analisar transcrições de reunião?
Sim. Após importar uma transcrição na seção **Reuniões**, o assistente pode:
* Resumir os pontos principais da reunião
* Identificar decisões e ações pendentes
* Extrair requisitos mencionados
* Criar documentos a partir do conteúdo discutido
As extrações automáticas aparecem no **Inbox** para sua revisão.
## Inbox (caixa de entrada)
### O que aparece no Inbox?
O Inbox recebe itens que precisam da sua atenção — normalmente sugestões e extrações feitas pela IA. Por exemplo:
* Decisões identificadas em reuniões
* Tarefas e follow-ups extraídos de transcrições
* Sugestões de novos termos para o glossário
* Recomendações de organização de documentos
Cada item chega com contexto sobre de onde veio (qual reunião, qual conversa).
### O que significam as abas do Inbox?
* **Abertos** — itens que aguardam sua ação
* **Depois** — itens que você adiou para revisar mais tarde
* **Concluídos** — itens já processados (aprovados, rejeitados ou arquivados)
### Como aprovar ou rejeitar uma sugestão?
Para cada item no Inbox, você tem estas ações:
* **Aprovar** — aceita a sugestão, que vira parte da Base (um documento, uma tarefa, um termo do glossário)
* **Rejeitar** — descarta a sugestão (fica registrada para auditoria)
* **Adiar** — move para a aba "Depois" para revisar quando quiser
* **Arquivar** — remove da lista ativa sem aprovar nem rejeitar
### O que acontece quando aprovo um item?
O item aprovado se torna conhecimento permanente na sua Base. Dependendo do tipo, ele pode virar um documento, uma entrada no glossário, uma tarefa no Linear (se integrado), ou outro artefato. A origem do item (de qual reunião ou conversa ele veio) fica sempre registrada.
Veja o guia completo
## Reuniões e transcrições
### Como importar uma transcrição de reunião?
Na seção **Reuniões**, você pode importar transcrições de diferentes fontes:
* Upload direto de arquivos de transcrição
* Importação do Granola, Fireflies, Tactiq ou Notes
* Gravação direta pelo Google Meet (extensão Chrome)
Após a importação, a IA processa automaticamente a transcrição, identifica participantes e extrai elementos que aparecem no Inbox.
Veja o guia completo
### O Freshbase grava reuniões automaticamente?
O Freshbase oferece uma **extensão para o Google Chrome** que grava reuniões do Google Meet. A extensão:
* Captura o áudio da reunião
* Identifica visualmente quem está falando
* Envia para processamento automático
* Gera uma transcrição com nomes de participantes
Para usar, instale a extensão e ative a gravação durante a reunião.
### Como funciona a identificação de participantes?
O Freshbase usa o **Team Roster** (registro do time) para identificar quem é quem nas transcrições. Ele reconhece variações de nome — por exemplo, "João", "JP" e "João Paulo" podem ser a mesma pessoa.
Para melhorar a identificação:
1. Cadastre os membros do time em **Configurações > Time**
2. Adicione apelidos e variações de nome
3. O sistema aprende com o tempo a partir de novas transcrições
### O que é o glossário e como ele melhora as transcrições?
O glossário é uma lista de termos do seu domínio de negócio. Quando o Freshbase processa uma transcrição, ele usa o glossário para:
* Reconhecer termos técnicos ou específicos do seu projeto
* Corrigir palavras que o sistema de transcrição entendeu errado
* Manter consistência na terminologia
**Exemplo:** Se "provisioning" é um termo do seu domínio, o glossário ajuda a IA a reconhecê-lo mesmo quando a transcrição registra "provisionamento" ou "ativação".
## Knowledge Base (documentos)
### Como criar e editar documentos?
Na seção **Conhecimento > Documentos**, você pode:
* Clicar em **Criar documento** para criar um novo
* Fazer **upload** de documentos existentes
* Editar documentos diretamente no editor da plataforma
O assistente no Chat também pode criar documentos para você — basta pedir.
Veja o guia completo
### O que é o Canvas?
O Canvas é um editor visual colaborativo dentro do Freshbase. Ele permite:
* Criar e refinar documentos com ajuda da IA
* Trabalhar de forma mais visual e interativa
* Editar partes específicas de um documento com a ajuda do assistente
É acessível em **Conhecimento > Canvas**.
### Como organizar meus documentos?
Os documentos ficam organizados em uma estrutura de arquivos dentro de cada Base. Você pode:
* Criar pastas para agrupar documentos por tema
* Navegar pela árvore de arquivos na lateral
* Usar o assistente para sugerir organização
### Posso exportar documentos?
Todos os documentos no Freshbase são em formato **Markdown** (texto puro). Isso significa que eles são portáteis e podem ser:
* Copiados e colados em qualquer ferramenta
* Abertos em editores de texto
* Versionados como código
## Configurações e integrações
### Como conectar com o Linear (gestão de tarefas)?
Vá em **Configurações > Integrações > Linear**
Clique em **Conectar Linear**
Insira sua API Key do Linear (disponível nas configurações do Linear)
Clique em **Testar** para verificar a conexão
Clique em **Salvar**
Com a integração ativa, você pode criar issues no Linear diretamente a partir de conversas e reuniões no Freshbase.
Veja o guia completo
### Como configurar o Google Calendar?
1. Vá em **Configurações > Integrações > Google Calendar**
2. Clique em **Conectar Google Calendar**
3. Autorize o acesso na janela do Google que vai abrir
4. Pronto — suas reuniões serão sincronizadas
O calendário ajuda o Freshbase a sugerir contatos para convidar ao workspace e pode facilitar a criação automática de transcrições.
### Como convidar membros para minha equipe?
1. Vá em **Configurações > Time > Membros do time**
2. Clique em **Convidar membro**
3. Digite o e-mail da pessoa
4. Envie o convite
Você também pode convidar pessoas durante o onboarding ou via sugestões do Google Calendar.
Veja o guia completo
### Como mudar o tema (claro/escuro)?
1. Vá em **Configurações > Aparência > Tema**
2. Escolha entre:
* **Sistema** — segue a configuração do seu sistema operacional
* **Claro** — tema claro
* **Escuro** — tema escuro
Você também pode personalizar a **cor de destaque** (Neutro, Oliva, Oceano) e as **fontes** usadas na interface.
## Conta e segurança
### Como alterar minhas informações de perfil?
1. Vá em **Configurações > Perfil**
2. Atualize seu nome ou foto de perfil
3. Clique em **Salvar perfil**
O e-mail da conta não pode ser alterado por essa tela.
### O que são chaves MCP?
Chaves MCP são chaves de acesso que permitem conectar ferramentas externas (como o Claude Code) à sua Base no Freshbase. Cada chave:
* É vinculada a uma Base específica
* Pode ser revogada individualmente
* Tem registro de uso (quando foi criada e último uso)
Para criar uma chave MCP:
1. Vá em **Configurações > Segurança > Chave MCP**
2. Clique em **Nova chave MCP**
3. Selecione a Base vinculada
4. Copie a chave gerada (ela só aparece uma vez)
### Quem pode ver meus projetos?
* **Workspace pessoal:** Apenas você tem acesso.
* **Workspace de equipe:** Todos os membros do workspace podem ver as Bases compartilhadas. Cada membro pode ter diferentes níveis de acesso:
* **Owner** — controle total
* **Editor** — pode editar documentos e usar o assistente
* **Visualizador** — pode apenas ver o conteúdo
### Como configuro idioma, fuso horário e formato de data?
Vá em **Configurações > Geral**:
* **Idioma** — escolha entre Português (pt-BR) e English (en-US)
* **Fuso horário** — configure para exibição correta de datas
* **Formato de data** — escolha como datas são apresentadas
### O Freshbase tem opções de acessibilidade?
Sim. Em **Configurações > Aparência > Acessibilidade** você encontra:
* **Alto contraste** — melhora a legibilidade
* **Reduzir movimento** — desativa animações e transições