Como conectar uma pasta do Google Drive

A conexão com o Google Drive serve para quem prefere manter a planilha de pessoas elegíveis viva, sempre atualizada no seu Drive habitual. Em vez de subir o arquivo toda vez que muda algo, você aponta a Blue para a pasta uma única vez e ela passa a ler a planilha sozinha, todos os dias de madrugada.

A Blue só lê o arquivo. Nunca apaga, nunca move e nunca altera nada dentro do seu Drive.

Para que serve

Indicado para você que:

• Já mantém a sua planilha de pessoas no Drive e quer evitar uploads repetidos.
• Tem a equipe de RH ou da secretaria editando a planilha com frequência.
• Quer que a entrada de uma pessoa nova na empresa vire convite na rede no dia seguinte, sem ninguém ter que se lembrar de subir nada.

O que você vai precisar

• Acesso de administrador ao painel da sua rede.
• Acesso a uma conta Google Workspace ou Google Cloud da sua empresa, onde você consiga criar uma chave de serviço.
• A planilha de pessoas dentro de uma pasta do Drive — só ela, isolada das demais.

A chave de serviço é como se fosse uma conta de e-mail só para a Blue. Você cria uma vez, dá acesso de leitura à pasta, e pronto. Essa conta não tem senha nem login no navegador. Ela só serve para a Blue conseguir abrir o seu arquivo.

1. Crie a chave de serviço no Google

Entre no console.cloud.google.com, com a conta de administrador da sua empresa.

1. No topo da tela, clique em Selecionar projeto e crie um projeto novo chamado, por exemplo, Blue. Se já tem um projeto que usa para integrações internas, pode reaproveitar.
2. No menu lateral, vá em APIs e serviços → Biblioteca.
3. Procure por Google Drive API e clique em Ativar. Procure também por Google Sheets API e ative do mesmo jeito.
4. Em APIs e serviços → Credenciais, clique em + Criar credenciais → Conta de serviço.
5. Dê um nome qualquer, como blue-sincronizacao. A descrição é opcional.
6. Pule a etapa de papéis. A Blue não precisa de nenhum acesso especial além de ler a pasta que você for compartilhar mais tarde.
7. Termine a criação.

Pronto, a sua conta de serviço já existe.

2. Baixe a chave em formato JSON

Ainda na lista de contas de serviço, abra a que você acabou de criar.

1. Vá na aba Chaves.
2. Clique em Adicionar chave → Criar nova chave.
3. Escolha o formato JSON e confirme.

O navegador baixa um arquivo .json no seu computador. Guarde esse arquivo em um lugar seguro. Ele é a credencial que vai dar à Blue o acesso de leitura.

Atenção: trate esse arquivo como se fosse uma senha. Não envie por canais públicos e não compartilhe com pessoas que não precisem.

3. Copie o e-mail da conta de serviço

Na tela da conta de serviço, na aba Detalhes, você vê um endereço de e-mail que termina em iam.gserviceaccount.com. Esse é o e-mail que você vai usar no próximo passo para dar acesso à pasta. Copie e deixe ao lado.

4. Compartilhe a pasta do Drive com a conta de serviço

Abra o Google Drive e vá até a pasta onde está a sua planilha.

1. Clique com o botão direito na pasta e escolha Compartilhar.
2. Cole o e-mail da conta de serviço que você copiou no passo anterior.
3. No nível de acesso, escolha Leitor.
4. Desmarque a opção “Notificar pessoas” — a conta de serviço não lê e-mails, então a notificação só geraria um aviso de erro.
5. Confirme.

A partir desse momento, a sua conta de serviço enxerga a pasta. Ninguém mais perdeu acesso ao que tinha. Você só adicionou a Blue à lista.

5. Copie o endereço da pasta

Ainda no Drive, entre na pasta. Olhe a barra de endereço do navegador. Ela tem um formato como drive.google.com/drive/folders/1AbCdEfGh.... Copie o endereço inteiro.

6. Configure a conexão no painel da Blue

Agora é a parte rápida. No painel da sua empresa:

1. Vá em Elegíveis no menu lateral.
2. Clique em Importar e escolha Google Drive.
3. Cole o arquivo JSON que você baixou no passo 2 no campo Chave da conta de serviço. Você pode abrir o arquivo no editor de texto e colar o conteúdo, ou arrastar o arquivo direto para o campo.
4. Cole o endereço da pasta no campo Pasta do Drive.
5. Clique em Testar conexão.

A Blue tenta ler a pasta com a chave que você colou. Se tudo estiver certo, aparece um aviso verde com o nome da pasta e o número de planilhas encontradas. Se algo estiver errado, a mensagem diz exatamente onde olhar (chave inválida, pasta não compartilhada, API não ativada).

7. Salve e deixe a Blue trabalhar

Com a conexão testada, clique em Salvar e ativar sincronização.

A partir daí, todos os dias entre 3h e 4h da manhã, a Blue:

1. Abre a pasta com a sua chave.
2. Encontra a planilha mais recente que segue o formato esperado de colunas (CPF, nome, e-mail, categoria, identificador externo).
3. Aplica a mesma conferência da importação por CSV: identifica novos, já cadastrados e linhas com problema.
4. Insere os novos e, se você marcou a opção, dispara os convites.
5. Salva um relatório que você pode abrir no painel.

A sincronização nunca apaga pessoas que não aparecem mais na planilha. Isso é proposital: você não corre risco de uma pessoa sair da rede por causa de um erro de digitação. Para remover alguém, marque manualmente como inativo.

Como acompanhar o que aconteceu

Em Elegíveis → Histórico de sincronização, você vê o resumo de cada execução: data, quantos foram inseridos, quantos foram ignorados por duplicidade, quantas linhas tinham problema e o motivo. Se algo der errado, a Blue manda o aviso para o e-mail do administrador para você não descobrir só ao olhar.

Pontos de atenção

• Limite do período de teste. Durante o trial, vale a mesma regra do CSV: até 50 pessoas. A sincronização para de inserir quando atinge o limite e te avisa para ativar a assinatura.
• Mudou de planilha? Basta substituir o arquivo dentro da mesma pasta. A Blue lê sempre a planilha mais recente. Não precisa reconfigurar nada.
• Mudou de pasta? Reabra Elegíveis → Importar → Google Drive, cole o endereço novo e salve. Sem precisar refazer a chave.
• Quer pausar? No mesmo painel, há um botão Pausar sincronização. A configuração fica salva. Quando você voltar a ativar, a próxima execução acontece na madrugada seguinte.
• Erro recorrente. Se aparecer um erro três dias seguidos, a Blue pausa a sincronização automaticamente e te avisa por e-mail. Isso evita que um problema silencioso vire ruído todo dia.

Por que não usar minha conta Google direto

A conta de serviço existe justamente para isolar este uso. Se um dia você sair da empresa ou trocar de senha, a Blue continua funcionando. E o acesso da Blue se limita à pasta que você compartilhou, em vez de toda a sua conta. É mais seguro para você e mais previsível para nós.

Está com dúvida em algum passo?

Mande mensagem para a gente que respondemos em até um dia útil.