Pular para o conteúdo principal

Google Drive

Disponível

Esta integração está ativa e pronta para uso no Frihet.

Conecte seu Google Drive ao Frihet. Liste, busque, faça upload e download de arquivos diretamente do seu ERP. Salve faturas e documentos em pastas organizadas sem sair do Frihet.

Para que serve?​

Com o Google Drive integrado:

  • Listar arquivos — Veja seus arquivos e pastas do Drive a partir do Frihet
  • Buscar documentos — Encontre arquivos por nome ou conteúdo
  • Fazer upload de arquivos — Salve faturas, orçamentos e documentos no Drive
  • Fazer download de arquivos — Acesse documentos salvos no Drive a partir do Frihet
  • Organização automática — Salve documentos em pastas por cliente ou ano

Requisitos​

  • Conta Google — Gmail, Google Workspace ou Google One
  • Frihet Pro ou superior
Sem credenciais para inserir

Esta integração usa OAuth com o Google. Você não precisa copiar nenhuma chave de API ou token. Simplesmente autoriza o Frihet a acessar seu Google Drive através de uma janela de login do Google.

Configuração técnica

Esta integração requer que a variável de ambiente VITE_GOOGLE_CLIENT_ID esteja configurada no servidor do Frihet. Se você é usuário do Frihet Cloud, já está configurado. Se você usa o Frihet self-hosted, consulte a documentação da API REST.

Conectar Google Drive com o Frihet​

Passo 1: Iniciar a conexão​

  1. Vá para Ajustes → Integrações
  2. Procure por Google Drive
  3. Clique em Conectar com o Google

Passo 2: Autorizar no Google​

  1. A janela de login do Google será aberta
  2. Selecione sua conta do Google
  3. Revise as permissões solicitadas:
    • Ver, criar e excluir arquivos no Google Drive
    • Ver informações da sua conta
  4. Clique em Permitir

Passo 3: Verificar conexão​

  1. De volta ao Frihet, você verá "Conectado" com sua conta do Google
  2. O Frihet exibirá seus arquivos recentes do Drive
  3. A integração está pronta para uso

Como funciona​

O Frihet usa a API do Google Drive com fluxo de autorização OAuth 2.0 (redirect):

  1. Você clica em "Conectar com o Google" e autoriza na janela do Google
  2. O Google gera tokens de acesso e de atualização
  3. O Frihet armazena ambos os tokens criptografados (AES-256-GCM)
  4. Com o token de acesso, o Frihet pode listar, buscar, fazer upload e download de arquivos
  5. O token é atualizado automaticamente quando expira
  6. Em nenhum momento você insere credenciais do Google no Frihet

Dados sincronizados​

DadoDireçãoFrequência
Listagem de arquivosGoogle Drive → FrihetSob demanda
Busca de arquivosGoogle Drive → FrihetSob demanda
Upload de arquivosFrihet → Google DriveSob demanda
Download de arquivosGoogle Drive → FrihetSob demanda

Funcionalidades​

Listar arquivos​

  1. No Frihet, acesse a seção do Google Drive
  2. Você verá seus arquivos e pastas recentes
  3. Navegue pelas pastas para encontrar documentos

Cada arquivo exibe:

  • Nome
  • Tipo (documento, planilha, PDF, imagem, etc.)
  • Data de modificação
  • Tamanho

Buscar arquivos​

  1. Use a barra de busca do Google Drive no Frihet
  2. Busque por nome de arquivo ou conteúdo
  3. Os resultados incluem arquivos de todo o seu Drive

Fazer upload de arquivos​

Faça upload de documentos do Frihet diretamente para o Google Drive:

  1. Selecione o arquivo para upload (fatura PDF, orçamento, documento)
  2. Escolha a pasta de destino no Drive
  3. O arquivo é enviado e fica disponível no seu Drive

Fazer download de arquivos​

  1. Navegue ou busque o arquivo no Drive pelo Frihet
  2. Clique em Download
  3. O arquivo é baixado para o seu dispositivo

Exportar documentos para o Drive​

Você pode exportar faturas e outros documentos diretamente para o Google Drive:

  1. Conecte sua conta do Google Drive
  2. Selecione a pasta de destino (ou use a pasta raiz)
  3. Use a função de exportação para salvar documentos no Drive

O Frihet pode listar suas pastas para que você escolha onde salvar os arquivos.

Casos de uso​

Backup automático de faturas​

Cada vez que você gera uma fatura em PDF, você a envia para uma pasta do Google Drive organizada por ano e mês. Sua contabilidade tem acesso à pasta compartilhada e pode consultar as faturas sem precisar solicitá-las.

Documentação de projetos centralizada​

Você guarda contratos, propostas e documentos de projeto no Google Drive. No Frihet, você acessa esses documentos ao trabalhar na faturação do projeto sem precisar trocar de aplicativo.

Compartilhar com a contabilidade​

Você cria uma pasta "Frihet - Faturas 2026" no Drive e a compartilha com sua contabilidade. Você faz upload de faturas e documentos do Frihet diretamente para essa pasta.

Importar documentos para despesas​

Você tem faturas de fornecedores salvas no Drive. No Frihet, você as baixa para anexá-las como comprovantes ao registrar despesas.

Solução de problemas​

"Erro ao conectar com o Google"​

  • Verifique se sua conta do Google está ativa
  • Se você usa o Google Workspace corporativo, seu administrador pode ter restringido os aplicativos de terceiros
  • Verifique se você não tem bloqueadores de pop-ups que impedem a janela do Google

"Não vejo meus arquivos"​

  • Verifique se você autorizou o acesso ao Google Drive (não apenas ao Gmail)
  • Os arquivos compartilhados com você aparecem na seção "Compartilhados comigo"
  • Recarregue a visualização no Frihet

"Não consigo fazer upload de arquivos"​

  • Verifique se você tem espaço disponível no seu Google Drive
  • O arquivo não deve exceder o limite de tamanho do Google Drive
  • Verifique se a sessão não expirou

"A sessão expirou"​

  • O Google pode solicitar reautenticação periodicamente
  • Vá para Ajustes → Integrações → Google Drive e clique em Reconectar
  • Você retornará à janela do Google para autorizar novamente

"Quero desconectar"​

  1. Vá para Ajustes → Integrações → Google Drive
  2. Clique em Desconectar
  3. Os tokens são removidos do Frihet
  4. Opcionalmente, revogue o acesso em myaccount.google.com/permissions

Próximos passos​