Como automatizar entrada de dados com n8n — tutorial passo a passo

Cenário: um formulário de contato no site deve registrar cada envio automaticamente em uma planilha do Google Sheets — sem copiar manualmente.

Passo 1: Criar o workflow

Na sidebar do n8n, clique em "New Workflow". Nomeie como "Formulário → Sheets".

Passo 2: Trigger (Webhook)

1. Adicione o nó Webhook ao canvas (clique + busque "Webhook")
2. Selecione método POST
3. Path: formulario-contato
4. O n8n gera a URL: https://seu-n8n.com/webhook/formulario-contato
5. Cole essa URL no atributo action do formulário HTML do site

Passo 3: Processamento (Set)

Adicione um nó Set para mapear os campos do formulário para os nomes das colunas da planilha:

{
  "Nome": "{{ $json.name }}",
  "Email": "{{ $json.email }}",
  "Mensagem": "{{ $json.message }}",
  "Data": "{{ $now.format('DD/MM/YYYY HH:mm') }}",
  "Origem": "Site - Formulário de Contato"
}

Passo 4: Destino (Google Sheets)

1. Adicione nó Google Sheets
2. Conecte credenciais Google (OAuth2 via Credentials Manager)
3. Operação: Append Row
4. Selecione a planilha e a aba de destino
5. Mapeie os campos do nó Set para as colunas da planilha

Passo 5: Testar e ativar

1. Clique em "Test Workflow" e envie um POST de teste (via curl ou webhook.site)
2. Verifique se a linha apareceu na planilha
3. Ative o workflow com o toggle (muda de Test URL para Production URL)

Resultado

Cada submissão do formulário aparece na planilha em <3 segundos. Zero trabalho manual. Se o fluxo falhar, o n8n registra o erro e você pode reprocessar.

Expressões ({{ }})

n8n usa expressões entre chaves duplas para acessar dados dinâmicos. As mais úteis:

Itens e lotes (Items)

Cada nó processa uma lista de itens. Se o nó anterior retorna 50 registros, o próximo nó processa os 50. Conceitos-chave:

• SplitInBatches: Divide itens em grupos menores. Essencial para respeitar rate limits de APIs (ex: "máximo 10 requests por segundo").
• Merge: Combina itens de dois fluxos diferentes (join de dados de dois sistemas).
• Item Lists: Agrupa, ordena, filtra e remove duplicatas de listas de itens.

Fluxo condicional (IF / Switch)

Nem todo item segue o mesmo caminho. Use IF para bifurcações simples (sim/não) e Switch para múltiplos caminhos:

// IF: Valor do pedido > R$ 1.000
// Saída TRUE → notificar gerente
// Saída FALSE → apenas registrar

// Switch: Tipo de ticket
// "bug" → equipe de dev
// "dúvida" → equipe de suporte
// "feature" → backlog do produto

Tratamento de erros

Configure um Error Trigger conectado a um nó de notificação. Assim, se um fluxo falhar, você recebe alerta imediato:

• Conecte Error Trigger → Slack/WhatsApp/Email com mensagem de erro
• Inclua: nome do workflow, nó que falhou, mensagem de erro, timestamp
• Configure para falhas consecutivas (3 falhas seguidas → alerta urgente)

Padrão 1: Formulário → Planilha + Notificação

Trigger: Webhook do formulário do site

Fluxo: Webhook → Set (mapear campos) → Google Sheets (registrar) + WhatsApp (notificar equipe comercial)

ROI: Elimina verificação manual de formulários. Lead recebe atenção em 3s em vez de 2h.

Padrão 2: CRM → ERP (sincronização de pedidos)

Trigger: Pipedrive Trigger → "Deal won"

Fluxo: Pipedrive → HTTP Request (buscar dados do cliente) → Function (transformar formato) → HTTP Request (POST no ERP) → WhatsApp (logística)

ROI: Elimina 3h/dia de transcrição manual de pedidos. Zero erros de digitação.

Padrão 3: E-mail → Banco de dados

Trigger: IMAP Email Trigger → novos e-mails em caixa específica

Fluxo: Email → GPT-4o mini (extrair dados: nome, valor, data) → PostgreSQL (INSERT) → Google Sheets (backup)

ROI: Automatiza extração de dados de e-mails padronizados (NFs de fornecedores, confirmações de pagamento).

Padrão 4: NF emitida → Contabilidade + Cliente

Trigger: Webhook do sistema fiscal (NF emitida)

Fluxo: Webhook → HTTP Request (download PDF da NF) → Google Drive (salvar) → Email (enviar ao cliente) → Google Sheets (controle fiscal)

ROI: Elimina envio manual de NFs. Para 200 NFs/mês, economiza 1 dia inteiro de trabalho.

Padrão 5: Estoque → Alerta + Pedido automático

Trigger: Schedule (a cada 1h) → PostgreSQL (query estoque < mínimo)

Fluxo: Query → IF (estoque < mínimo) → Email para fornecedor (pedido padronizado) + Slack (gerente de compras) + Sheets (log de alertas)

ROI: Elimina ruptura de estoque. Pedidos disparados automaticamente antes de acabar.

Padrão 6: Onboarding → Multi-sistema

Trigger: Webhook (novo funcionário cadastrado no RH)

Fluxo: Webhook → Google Workspace (criar conta de email) → Slack (adicionar aos canais) → Notion (criar página do funcionário) → Email (boas-vindas com links) → Trello (card de onboarding para gestor)

ROI: Onboarding que levava 2h por funcionário cai para 30 segundos automáticos.

Uma distribuidora de materiais de construção com 30 funcionários usava Pipedrive (CRM) para gestão comercial e TOTVS (ERP) para faturamento. O processo era:

Antes (manual)

1. Vendedor fecha negócio no Pipedrive (marca como "won")
2. Vendedor copia os dados do deal para um formulário interno
3. Assistente administrativa recebe o formulário
4. Assistente digita os dados no TOTVS para gerar pedido
5. Assistente avisa o time de logística por WhatsApp

Problema: ~20 pedidos/dia × 15 min cada = 5h/dia de trabalho manual. Erros de digitação geravam retrabalho e atraso na entrega.

Depois (n8n automatizado)

1. Trigger: Pipedrive Trigger → "Deal won" dispara automaticamente
2. Buscar dados completos: HTTP Request → Pipedrive API GET /deals/{id} + /persons/{person_id} + /organizations/{org_id}
3. Transformar formato: Function node com mapeamento Pipedrive → TOTVS:

   return [{json: {
     codigo_cliente: $json.organization.custom_field_cnpj,
     produtos: $json.deal.products.map(p => ({
       sku: p.product_id,
       quantidade: p.quantity,
       preco: p.item_price
     })),
     condicao_pagamento: $json.deal.custom_field_payment,
     endereco_entrega: $json.person.address
   }}]

4. Criar pedido no ERP: HTTP Request → TOTVS API POST /pedidos
5. Notificar logística: WhatsApp API → mensagem formatada com número do pedido, cliente, e data de entrega
6. Log: Google Sheets → registro com timestamp, deal ID, pedido TOTVS ID, status

Resultados

Tempo de implementação: 4 horas (1h setup n8n, 2h mapeamento de campos, 1h testes e ajustes). Payback no primeiro dia útil.

Regra 1: Credentials Manager — sempre

Nunca cole tokens de API, senhas ou chaves diretamente nas expressões do fluxo. Use o Credentials Manager do n8n:

• Credenciais ficam criptografadas com a N8N_ENCRYPTION_KEY
• Não aparecem no JSON exportado do workflow
• Podem ser compartilhadas entre workflows sem duplicação
• Suportam OAuth2 com refresh automático (Google, Microsoft, etc.)

Regra 2: Variáveis de ambiente para configurações

URLs de API, endpoints, e-mails de notificação — tudo que muda entre ambientes (dev/staging/prod) deve ser variável de ambiente:

# No docker-compose ou .env
ERP_API_URL=https://api.totvs.suaempresa.com
NOTIFICATION_EMAIL=financeiro@empresa.com
SLACK_CHANNEL=#automacao-alertas

No n8n, acesse via {{ $env.ERP_API_URL }}.

Regra 3: Princípio do menor privilégio

• Crie tokens de API com escopo mínimo necessário (somente leitura quando não precisa escrever)
• Use service accounts, não contas pessoais, para credenciais de produção
• Rotacione tokens a cada 90 dias
• Revogue tokens imediatamente quando alguém sai da equipe

Regra 4: HTTPS e rede

• n8n em produção deve rodar atrás de reverse proxy (nginx/Caddy) com HTTPS
• Nunca exponha a porta 5678 diretamente à internet
• Configure firewall para permitir apenas IPs necessários
• Use VPN ou Private Networking para acessar bancos de dados

Versionamento de workflows

Workflows são código — devem ser versionados:

1. Exporte cada workflow como JSON (botão "Download" no editor)
2. Salve no Git com nome descritivo: workflows/crm-erp-sync.json
3. Commit com mensagem: "feat: adicionar tratamento de produtos sem SKU"
4. Antes de alterar um workflow em produção, exporte a versão atual como backup

Monitoramento de execuções

n8n guarda histórico de cada execução. Configure:

• Retenção: Mínimo 30 dias de histórico (configurável via EXECUTIONS_DATA_MAX_AGE)
• Error Trigger: Workflow dedicado que recebe todas as falhas e notifica via Slack/WhatsApp
• Health check: Schedule Trigger que roda a cada 5 minutos e verifica se o n8n está respondendo
• Métricas: Configure endpoint Prometheus (/metrics) e monitore com Grafana

Manutenção mensal

Escalando: de 1 fluxo para uma operação inteira

O caminho para escalar automações na empresa:

1. Semana 1: Primeiro fluxo simples (formulário → planilha). Construir confiança.
2. Semana 2-3: Fluxo de maior impacto (CRM → ERP). Demonstrar ROI real.
3. Mês 2: Documentar padrões e treinar 1-2 pessoas na equipe para criar fluxos.
4. Mês 3: Governança: Git para versionamento, alertas para falhas, credenciais centralizadas.
5. Mês 4+: Catálogo de fluxos prontos, templates reutilizáveis, métricas de ROI por automação.

n8n transforma horas de trabalho manual em segundos automáticos — com custo de R$ 100-200/mês em infraestrutura. O ROI típico é medido em dias, não meses.

Checklist para começar agora

1. Identificar: Qual processo da empresa envolve copiar dados entre dois sistemas?
2. Instalar: docker run -p 5678:5678 n8nio/n8n (5 minutos)
3. Construir: Trigger → processamento → destino (30-60 minutos)
4. Testar: Com dados reais, via "Execute once" no n8n
5. Ativar: Toggle → Production URL → pronto
6. Monitorar: Error Trigger + histórico de execuções

O maior obstáculo não é técnico — é identificar os processos que valem a pena automatizar. Comece pelo mais doloroso (onde alguém gasta >1h/dia copiando dados) e o ROI se demonstra sozinho.