Integração N8N com Google Sheets: Tutorial Passo a Passo

Você receberá uma tela com um Client ID e um Client Secret. Copie ambos. Eles serão essenciais na configuração do nó no n8n.

2. Preparar a Planilha Google

• Crie uma nova planilha no Google Sheets.
• Na primeira linha, defina os cabeçalhos. Por exemplo: ID, Email, Status, Data Processamento.
• Anote o ID da planilha na URL. A URL será algo como https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit. O ID é a parte longa entre /d/ e /edit.
• Compartilhe essa planilha com o endereço de e-mail que aparece no seu Client ID do Google Cloud (geralmente termina em .gsproject.gserviceaccount.com ou seu email pessoal, dependendo da configuração).

Configurando a Credencial OAuth no N8N

Agora que temos as credenciais do Google e a planilha pronta, vamos integrar os dois sistemas.

1. Acesse sua instância do n8n.
2. No menu lateral esquerdo, clique em Credenciais.
3. Clique no botão + Adicionar Credencial.
4. Pesquise por Google Sheets.
5. Selecione a opção Google Sheets OAuth2 API.

O formulário de configuração abrirá. Preencha os campos conforme abaixo:

• Name: Dê um nome identificável, como Credencial Google Sheets Prod.
• Client ID: Cole o Client ID obtido no Google Cloud Console.
• Client Secret: Cole o Client Secret correspondente.

Após preencher, clique em Conectar. O n8n abrirá uma nova janela ou pop-up solicitando que você faça login com sua conta do Google e conceda permissões para acessar as planilhas. Após aceitar, a credencial será salva.

Criando o Workflow de Automação

Vamos construir um fluxo simples: ler todas as linhas da planilha, filtrar aquelas que não foram processadas e atualizar o status para "Processado".

Passo 1: Adicionar o Trigger (Gatilho)

Para iniciar o processo, precisamos de um gatilho. Podemos usar o Cron para rodar a automação periodicamente ou o Webhook para acioná-la sob demanda. Para este exemplo, usaremos o Cron.

• No canvas do n8n, clique no botão + Adicionar nó.
• Pesquise por Cron.
• Selecione o nó Cron.
• Nas configurações do nó, defina o intervalo. Para testes, use * * * * * (todos os minutos). Em produção, ajuste conforme a necessidade (ex: 0 */2 * * * a cada 2 horas).

Passo 2: Ler Dados do Google Sheets

Agora vamos buscar os dados da planilha.

• Clique em + Adicionar nó e conecte-o ao nó Cron.
• Pesquise por Google Sheets.
• Selecione o nó Google Sheets.
• Nas configurações, selecione a Credencial que criamos anteriormente.
• Em Operation, escolha Read.
• Em Resource, escolha Spreadsheet ou Row. Para ler todas as linhas de uma aba específica, selecione Row.
• Preencha o Spreadsheet ID com o ID da sua planilha.
• Em Range, insira a aba e o intervalo. Se quiser todos os dados da aba 1, use Arena ou especifique A2:D1000 (evite usar apenas Arena em planilhas muito grandes para evitar lentidão).
• Clique em Execute Node para testar. Você verá os dados brutos no painel de saída à direita.

Passo 3: Filtrar e Processar Dados (Code Node)

Os dados vêm em formato JSON. Vamos usar um nó Code para filtrar apenas as linhas que precisam ser atualizadas (por exemplo, onde a coluna Status está vazia).

• Conecte um novo nó ao Google Sheets.
• Pesquise por Code e selecione o nó Code.
• No editor de código JavaScript, insira o seguinte script:

// Dados de entrada vêm em item.json.data
const items = $input.all();

// Filtra apenas itens onde a coluna 'Status' (índice 2) está vazia ou não processada
const filteredItems = items.filter(item => {
  const status = item.json['Status']; // Ajuste o nome da chave conforme seu JSON
  return !status || status === '';
});

// Retorna os itens filtrados
return filteredItems;

Nota: O formato do JSON retornado pelo Google Sheets depende de como você configurou a leitura. Se usar Return Array, cada item será um objeto. Verifique o painel de saída do nó anterior para saber as chaves exatas (ex: $0, Email, etc.). Ajuste o script conforme a estrutura real.

Passo 4: Atualizar a Planilha

Agora precisamos atualizar o status das linhas filtradas. Para isso, usaremos o nó Google Sheets novamente, mas com uma operação de escrita.

• Conecte um novo nó ao Code Node.
• Pesquise por Google Sheets.
• Em Operation, escolha Update.
• Em Resource, escolha Row.
• Preencha o Spreadsheet ID.
• Em Range, precisamos informar a linha específica. Se o filtro for complexo, pode ser necessário usar um laço (Loop) ou o nó Write com múltiplas linhas. Para simplificar este tutorial, vamos assumir que atualizaremos uma linha por vez usando o Split In Batches.