Integre Google Sheets com n8n

O que é e por que usar

Integrar Google Sheets com n8n é uma das combinações mais úteis e procuradas no mundo da automação. O Google Sheets é uma ferramenta de planilha amplamente adotada para organizar dados, controlar tarefas e gerar relatórios. O n8n é uma plataforma de automação de fluxos de trabalho (workflows) que conecta diferentes serviços sem depender de código extenso. Juntar os dois permite que dados entrem e saiam da sua planilha de maneira automática, eliminando tarefas manuais de copiar, colar ou exportar informações.

Pense em um cenário real: você trabalha com vendas e recebe pedidos por e-mail ou formulário. Sem automação, seria preciso abrir cada e-mail, copiar os dados do cliente, acessar o Google Sheets e adicionar uma nova linha manualmente. Com n8n integrado ao Google Sheets, esse processo acontece em segundos. O n8n detecta o novo e-mail ou envio de formulário, extrai as informações e as insere na planilha automaticamente. Isso reduz o tempo de processamento de minutos para alguns segundos e diminui erros humanos.

Além de inserir dados, você pode usar a integração para ler dados da planilha e alimentar outros sistemas, como CRM, banco de dados ou envio de e-mails em massa. O n8n oferece um nó nativo do Google Sheets, com suporte para operações de criação, atualização, leitura e busca de linhas. Essa versatilidade torna a integração indispensável para equipes que dependem de informações centralizadas e ações rápidas.

A neat workspace featuring a laptop displaying Google search, a smartphone, and a notebook on a wooden desk.

Pré-requisitos

Antes de começar, você precisa garantir que tem os seguintes itens:

Conta Google ativa — para acessar o Google Sheets e criar as credenciais de API.
Instância n8n instalada e acessível — seja via n8n Cloud, Docker, ou instalação local. Se ainda não tiver, consulte a documentação oficial do n8n.
Conhecimento básico de nós e fluxos no n8n — entender o que é um trigger (acionador) e como conectar dois nós é o suficiente.
Uma planilha do Google Sheets — você pode criar uma nova ou usar uma existente para teste.
Acesso ao Google Cloud Console — para habilitar a API do Google Sheets e criar credenciais de OAuth 2.0, se necessário. (Na maioria dos casos, o n8n fornece uma autenticação simplificada por OAuth, mas você precisa se autenticar com sua conta Google).
Identificação do ID da planilha e da aba — o ID está na URL do documento, e o nome da aba geralmente é “Página1” ou algo que você definir.

Se você nunca usou n8n, recomendo fazer um teste com um workflow simples antes de pular para esta integração. Assim você entende o painel de nós, as conexões e o conceito de “dados estruturados em JSON” que o n8n usa internamente.

Exemplo Prático: Automação de registro de leads recebidos por formulário

Imagine que você mantém uma página de destino para captura de leads. Os visitantes preenchem um formulário com nome, e-mail e telefone. Sem automatização, alguém precisaria acessar o painel do formulário diariamente, copiar os novos leads e colá-los numa planilha compartilhada com o time de vendas. Esse método é lento, sujeito a falhas e atrasa o contato com o cliente.

Neste exemplo, vamos configurar um fluxo no n8n que escuta novas submissões de um formulário (usando o nó de Webhook ou o trigger do Google Forms, por exemplo) e adiciona automaticamente cada lead como uma nova linha no Google Sheets. O resultado esperado é que, no momento em que um visitante envia o formulário, a linha aparece na planilha em menos de 2 segundos. Onde o n8n é o coringa da automação, o Google Sheets se torna o repositório central de dados, sempre atualizado.

Especificamente, faremos o seguinte:

Criar um nó trigger para receber os dados do formulário via Webhook.
Usar um nó do Google Sheets com operação “Append” (adicionar linha) para inserir os dados no final da planilha.
Testar o fluxo com dados fictícios para validar o resultado.

Resultado esperado

A planilha terá colunas como “nome”, “email” e “telefone”. Para cada novo lead, o n8n adiciona uma linha com os dados correspondentes. O workflow mantém um histórico de execuções bem-sucedidas, e você pode monitorar o status diretamente no painel do n8n. Se a planilha estiver configurada para ser compartilhada com a equipe comercial, todos enxergam os novos leads em tempo real.

Configuração Passo a Passo

Agora vamos construir o fluxo. Vamos usar uma automação com dois nós principais: um trigger de Webhook e o nó do Google Sheets. O Webhook simula a chegada de dados, mas você pode substituí-lo por um nó do Google Forms, Typeform ou qualquer outra fonte.

1. Crie um novo workflow no n8n

No painel do n8n, clique em “New Workflow”. Dê um nome descritivo, como “Registro automático de leads no Google Sheets”. O nó inicial será adicionado automaticamente ou você pode clicar no botão “+” para adicionar um trigger.

2. Adicione o nó de Webhook

Clique no nó adicionado e selecione “Webhook” na lista de triggers.
Em “HTTP Method”, escolha POST.
Em “Path”, defina um caminho exclusivo, por exemplo /lead-registration.
Copie a URL gerada (provavelmente algo como https://seu-n8n.com/webhook/lead-registration).
Salve e ative o nó.

Este Webhook será o endpoint que a sua página de formulário ou aplicação externa vai chamar via POST com os dados do lead. Você pode testar com uma ferramenta como Postman ou simplesmente usar o nó de teste no n8n, mas por enquanto vamos continuar a configuração.

3. Configure a credencial do Google Sheets

Antes de usar o nó do Google Sheets, você precisa conectar sua conta Google. No n8n:

Clique no conector do próximo nó e selecione “Google Sheets”.
Se ainda não houver credenciais, clique em “Create New Credential”.
Escolha o tipo OAuth2 e siga o fluxo de autenticação com a sua conta Google.
Garanta que os escopos incluam acesso às planilhas. O n8n solicitará as permissões corretas automaticamente.

Caso a autenticação falhe, verifique se você tem permissão para acessar a planilha que deseja usar. Você deve ser o proprietário ou ter acesso de edição.

4. Adicione o nó do Google Sheets

Após a autenticação, faremos a configuração do nó de gravação:

Arraste um novo nó e selecione Google Sheets.
Na operação, escolha Append or Update (Adicionar ou Atualizar).
Em “Credential to connect with”, escolha a credencial criada.
Em “Document”, selecione a planilha específica no Google Drive ou cole o ID da planilha.
Em “Sheet”, selecione a aba correta. Por exemplo, “Página1”.
Em “Columns”, defina quais colunas devem ser preenchidas. Para isso, você pode colocar os nomes das colunas manualmente. O n8n geralmente lê a primeira linha da planilha e sugere os campos.

A configuração de colunas é importante. Suponha que sua planilha tenha as colunas A, B e C com os títulos “nome”, “email” e “telefone”. No n8n, você pode mapear essas colunas para os dados recebidos. Vamos usar uma expressão para puxar os dados do Webhook.

No campo “Columns” (ou “Mappings”), você configurará algo assim:

{
  "nome": "={{$json.body.nome}}",
  "email": "={{$json.body.email}}",
  "telefone": "={{$json.body.telefone}}"
}

Essa notação diz ao n8n: pegue o valor da propriedade nome que veio no corpo (body) da requisição do Webhook e coloque na coluna “nome”. O mesmo para email e telefone. Se os dados do seu formulário usam outros nomes (por exemplo, “nome_completo”), ajuste a expressão de acordo.

Também é possível selecionar as colunas manualmente via interface, clicando no botão de adicionar mapeamento. Mas a edição via JSON direto dá mais controle e transparência.

5. Conecte os nós e teste

Conecte a saída do nó Webhook à entrada do nó Google Sheets. Execute o workflow no modo de teste (botão “Test workflow”). Com o nó de Webhook ativo, envie uma requisição POST para a URL do webhook com um JSON de exemplo:

{
  "nome": "João da Silva",
  "email": "joao.silva@exemplo.com",
  "telefone": "(11) 99999-1234"
}

Após a execução, verifique sua planilha. Deve aparecer uma nova linha com os dados enviados. Se deu certo, você concluiu com sucesso a integração. Depois, ative o workflow (toggle “Active” no canto superior direito) para que ele funcione em produção.

6. Estrutura do fluxo final

O fluxo terá a seguinte estrutura de dados entre os nós, que você pode inspecionar na aba “Execution” do n8n:

Dados de entrada (Webhook):
{
  "headers": {...},
  "params": {},
  "query": {},
  "body": {
    "nome": "João da Silva",
    "email": "joao.silva@exemplo.com",
    "telefone": "(11) 99999-1234"
  }
}

Após mapeamento no Google Sheets:
{
  "nome": "João da Silva",
  "email": "joao.silva@exemplo.com",
  "telefone": "(11) 99999-1234"
}

O nó do Google Sheets recebe o objeto com as chaves mapeadas e as adiciona como uma nova linha. Repare que o nó de Webhook retorna um objeto grande, com metadados de cabeçalho e query. Por isso, na expressão usamos {{$json.body.nome}} para acessar especificamente o campo “nome” dentro do “body”.

Dicas e Variações

Essa integração é extremamente flexível. Aqui estão algumas dicas para extrair mais valor e evitar armadilhas:

Use o nó “Google Sheets” como fonte de dados (operador “Read”): além de adicionar linhas, você pode ler dados da planilha e alimentar ações seguintes, como enviar e-mails de boas-vindas ou atualizar um CRM.
Em vez de Webhook, use o trigger do “Google Forms”: o n8n tem um nó específico para Google Forms que dispara sempre que uma nova resposta é enviada. Isso é mais prático se o seu formulário já é um Google Form.
Aproveite o operador “Update” para editar linhas existentes: se você precisa marcar um lead como “contatado” ou “convertido”, use uma busca por e-mail e atualize o status.
Adicione um nó de formatação de dados antes do Sheets: às vezes os dados chegam com letras maiúsculas, espaços extras ou formatos de data diferentes. Use um nó “Code” ou “Set” para normalizar antes de gravar.
Monitore o sucesso das execuções: no modo produção, ative as notificações de erro no n8n. Você pode configurar um nó “If” ou “Error Trigger” para enviar um alerta para o seu e-mail ou Slack quando algo falhar.

Smartphone displaying Google search page on a vibrant yellow background.

Erros Comuns e Como Evitá-los

Durante a configuração, você pode encontrar alguns problemas. Veja como resolver os mais comuns:

Erro de autenticação “Invalid credentials”: verifique se a conta Google conectada no n8n tem permissão de edição na planilha. Você precisa ser o dono ou receber um convite de edição.
Colunas não aparecem na seleção do nó Google Sheets: o n8n lê as colunas da primeira linha da planilha para sugerir. Se sua primeira linha não tem cabeçalhos, adicione cabeçalhos descritivos. Caso contrário, você mesmo pode definir os nomes das colunas manualmente.
Webhook retorna erro 404 “Webhook not found”: se o workflow estiver inativo (não ativado), o webhook não irá responder. Ative o workflow antes de enviar dados de teste.
Dados não preenchidos mesmo com execução bem-sucedida: verifique a correspondência entre as chaves no seu JSON e as expressões que você usou no mapeamento. Por exemplo, se o campo vem como “Nome” (com maiúscula) e o mapeamento usa “nome”, o valor virá vazio.
Erro de “an invalid JSON” no Webhook: quando você envia um POST com body não-JSON, o n8n pode não conseguir processar. Certifique-se de enviar o cabeçalho Content-Type: application/json e um JSON válido.

Se mesmo após essas verificações o problema persistir, acesse a aba “Executions” no n8n para ver os logs de cada execução. Com o modo de debug ativo, você pode ver exatamente o que aconteceu em cada nó, incluindo o payload recebido e o item que foi enviado ao Google Sheets.

Próximos Passos

Agora que você tem uma automação funcional entre Google Sheets e n8n, o próximo passo é ampliar o escopo. Pense em como esse mesmo padrão pode servir para outras rotinas da sua empresa ou vida pessoal.

Uma evolução natural é criar um segundo workflow que lê sua planilha todos os dias, busca leads que ainda não foram contatados e dispara um e-mail automático de follow-up. Você poderia usar o nó “Cron” para agendar essa rotina diária e conectar um nó do Gmail ou Outlook. Outra possibilidade é integrar com um CRM como o HubSpot, enviando os dados da planilha como novos contatos.

Se você quer levar suas automações a outro nível, considere usar o nó “Split In Batches” para processar grandes volumes de dados sem sobrecarregar a API do Google, ou adicionar tratamento de erros com o nó “Stop and Error” para registrar falhas em uma aba separada.

A integração entre Google Sheets e n8n é um alicerce. Uma vez que você entende o fluxo de dados e as operações nativas, pode aplicar o mesmo raciocínio em dezenas de outras combinações. Eu recomendo que você comece com uma automação pequena, como esta do registro de leads, e depois vá adicionando complexidade gradualmente. O retorno em tempo economizado e precisão é imediato. Agora é a sua vez: crie um workflow simples, envie um teste com seus dados reais e veja sua planilha se atualizar sozinha. Quando estiver confortável, expanda para outras operações e compartilhe a automação com sua equipe.

Gostou do conteúdo? Inscreva-se para receber as novidades: