Skip to main content

# 🤖 N8N WORKFLOWS - CONTEÚDO COMPLETO

📑 CAPÍTULO 1: INTRODUÇÃO AO N8N

🎯 O QUE É N8N?

N8N é nossa plataforma de automação no-code que conecta diferentes serviços e automatiza processos repetitivos da MeMude Core.

🔗 Acesso: http://n8n.memudecore.com.br 👤 Login: Solicitar credenciais à equipe técnica 📚 Documentação Oficial: https://docs.n8n.io/

🏗️ CONCEITOS BÁSICOS

🔄 Workflows

Um workflow é uma sequência automatizada de tarefas conectadas. Cada workflow:

  • É composto por "nodes" (nós) conectados
  • Tem um trigger (gatilho) que inicia a execução
  • Processa dados através dos nodes
  • Pode executar ações em múltiplos serviços

📦 Nodes (Nós)

  • Trigger Nodes: Iniciam o workflow (webhook, cron, manual)
  • Regular Nodes: Processam dados ou executam ações
  • Core Nodes: Funcionalidades básicas (HTTP, Set, Code)
  • Integration Nodes: Conectam com serviços externos

🔗 Connections

As conexões determinam o fluxo de dados entre nodes:

  • Main Connection: Fluxo principal de dados
  • Error Connection: Tratamento de erros
  • Conditional Paths: Ramificações baseadas em condições

🚀 PRIMEIROS PASSOS

  1. Acessar a Interface

    • URL: http://n8n.memudecore.com.br
    • Login com credenciais fornecidas
    • Interface principal com lista de workflows

  2. Navegar pelos Workflows

    • Menu lateral: "Workflows"
    • Status: Ativo/Inativo
    • Última execução e resultados

  3. Executar Workflow Manual

    • Abrir workflow desejado
    • Botão "Execute Workflow"
    • Acompanhar execução em tempo real

📑 CAPÍTULO 2: WORKFLOWS EXISTENTES

📊 WORKFLOWS ATIVOS (Janeiro 2026)

🚨 MONITORAMENTO E ALERTAS

📡 Monitor de Serviços

  • ID: monitor-servicos-v2
  • Função: Verificar status de todos os serviços críticos
  • Trigger: Cron (a cada 5 minutos)
  • Serviços Monitorados:
    • BookStack (docs.memudecore.com.br)
    • N8N (n8n.memudecore.com.br)
    • CRM Krayin (crm.memudecore.com.br)
    • Website principal
  • Alertas: Slack #tech + Email emergência
  • Status: ✅ Ativo

📈 Relatório Diário de Sistemas

  • ID: relatorio-diario-sistemas
  • Função: Compilar métricas diárias de todos os sistemas
  • Trigger: Cron (todos os dias às 8h)
  • Dados Coletados:
    • Uptime de serviços
    • Uso de recursos (CPU, RAM, disk)
    • Backup status
    • Logs de erro
  • Destino: Email + Slack #reports
  • Status: ✅ Ativo

🔗 INTEGRAÇÕES CRM

📇 Sync CRM → Slack

  • ID: crm-slack-integration
  • Função: Notificar novos leads e atividades do CRM
  • Trigger: Webhook do Krayin CRM
  • Eventos:
    • Novo lead cadastrado
    • Oportunidade criada
    • Status de deal alterado
  • Canal: #vendas
  • Formato: Card rico com detalhes do lead
  • Status: ✅ Ativo

💾 Backup Automático CRM

  • ID: backup-crm-database
  • Função: Backup automático da base do CRM
  • Trigger: Cron (diário às 2h da madrugada)
  • Processo:
    1. Dump do banco MySQL do CRM
    2. Compressão do arquivo
    3. Upload para storage seguro
    4. Notificação de sucesso/erro
  • Retenção: 30 dias
  • Status: ✅ Ativo

📧 AUTOMAÇÕES DE EMAIL

🎯 Workflow de Boas-vindas

  • ID: welcome-email-sequence
  • Função: Sequência de emails para novos usuários
  • Trigger: Novo usuário no CRM
  • Sequência:
    • Email imediato de boas-vindas
    • Email +1 dia com guia de primeiros passos
    • Email +7 dias com dicas avançadas
  • Templates: HTML responsivos
  • Status: ✅ Ativo

🔄 SINCRONIZAÇÕES

📊 Sync Analytics → Dashboard

  • ID: analytics-dashboard-sync
  • Função: Atualizar dashboard interno com dados do GA4
  • Trigger: Cron (a cada hora)
  • Métricas:
    • Visitantes únicos
    • Páginas mais acessadas
    • Conversões
    • Tempo de sessão
  • Destino: Dashboard interno (Grafana)
  • Status: ✅ Ativo

📑 CAPÍTULO 3: COMO CRIAR WORKFLOWS

🛠️ SETUP INICIAL

1️⃣ Criar Novo Workflow

1. Login no N8N (n8n.memudecore.com.br)
2. Clicar em "New workflow"
3. Dar nome descritivo: "projeto-funcao-versao"
4. Adicionar descrição clara do objetivo

2️⃣ Escolher Trigger Node

Tipos de Trigger mais usados:

  • Manual Trigger: Para testes e execuções pontuais
  • Cron Trigger: Para automações periódicas
  • Webhook Trigger: Para integrações em tempo real
  • Email Trigger: Para workflows baseados em email

🔧 NODES MAIS UTILIZADOS

📊 Dados e Processamento

  • HTTP Request: Fazer chamadas para APIs externas
  • Set Node: Definir ou modificar dados
  • Code Node: JavaScript customizado para lógicas complexas
  • Function Node: Transformações simples de dados
  • Switch Node: Criar condicionais e ramificações

🔗 Integrações

  • Slack: Envio de mensagens e notificações
  • Gmail/SMTP: Automações de email
  • MySQL: Consultas e inserções no banco
  • Google Sheets: Manipular planilhas
  • Discord: Notificações para canais

📋 BOAS PRÁTICAS

🎯 Nomenclatura

Padrão de Nomes:
  Workflow: "projeto-funcao-versao"
  Exemplo: "crm-backup-v2", "monitor-sites-v1"

Nodes:
  Usar nomes descritivos
  Exemplo: "Buscar Novos Leads", "Enviar Slack", "Salvar Database"

🔄 Tratamento de Erros

  • Sempre configurar "On Error" connections
  • Usar "Error Trigger" para workflows de tratamento
  • Log detalhado em caso de falhas
  • Notificações de erro para equipe técnica

⚡ Performance

  • Evitar loops infinitos
  • Usar "Batch Processing" para grandes volumes
  • Implementar timeouts apropriados
  • Monitorar uso de recursos

🧪 PROCESSO DE TESTES

1. Desenvolvimento:
   - Usar "Manual Trigger" para testes
   - Dados de exemplo/mock
   - Verificar cada node individualmente

2. Homologação:
   - Testar com dados reais (ambiente seguro)
   - Validar todas as condições
   - Confirmar integrações externas

3. Produção:
   - Ativar workflow gradualmente
   - Monitorar primeiras execuções
   - Ajustar conforme necessário

📑 CAPÍTULO 4: BIBLIOTECA DE TEMPLATES

🔔 TEMPLATE: NOTIFICAÇÃO SLACK BÁSICA

{
  "name": "Template - Slack Notification",
  "description": "Template base para enviar notificações no Slack",
  "nodes": [
    {
      "name": "Manual Trigger",
      "type": "n8n-nodes-base.manualTrigger",
      "parameters": {}
    },
    {
      "name": "Set Message",
      "type": "n8n-nodes-base.set",
      "parameters": {
        "values": {
          "string": [
            {
              "name": "message",
              "value": "🤖 Mensagem automática do N8N"
            },
            {
              "name": "channel",
              "value": "#general"
            }
          ]
        }
      }
    },
    {
      "name": "Send to Slack",
      "type": "n8n-nodes-base.slack",
      "parameters": {
        "channel": "={{ $json.channel }}",
        "text": "={{ $json.message }}",
        "username": "N8N Bot"
      }
    }
  ]
}

🎯 Como usar:

  1. Import este template no N8N
  2. Configure credentials do Slack
  3. Customize mensagem e canal
  4. Teste e ative

💾 TEMPLATE: BACKUP DE BANCO

{
  "name": "Template - Database Backup",
  "description": "Backup automatizado de banco MySQL/MariaDB",
  "nodes": [
    {
      "name": "Cron Trigger",
      "type": "n8n-nodes-base.cron",
      "parameters": {
        "cronExpression": "0 2 * * *"
      }
    },
    {
      "name": "Generate Filename",
      "type": "n8n-nodes-base.set",
      "parameters": {
        "values": {
          "string": [
            {
              "name": "backup_filename",
              "value": "backup_{{ DateTime.now().format('yyyy-MM-dd_HH-mm') }}.sql"
            }
          ]
        }
      }
    },
    {
      "name": "Execute Backup",
      "type": "n8n-nodes-base.mysql",
      "parameters": {
        "operation": "executeQuery",
        "query": "SELECT * INTO OUTFILE '/backups/{{ $json.backup_filename }}' FROM information_schema.tables"
      }
    },
    {
      "name": "Notify Success",
      "type": "n8n-nodes-base.slack",
      "parameters": {
        "channel": "#tech",
        "text": "✅ Backup realizado: {{ $json.backup_filename }}"
      }
    }
  ]
}

🌐 TEMPLATE: MONITOR DE WEBSITE

{
  "name": "Template - Website Monitor",
  "description": "Monitorar status de websites e alertar se offline",
  "nodes": [
    {
      "name": "Cron Every 5min",
      "type": "n8n-nodes-base.cron",
      "parameters": {
        "cronExpression": "*/5 * * * *"
      }
    },
    {
      "name": "Check Website",
      "type": "n8n-nodes-base.httpRequest",
      "parameters": {
        "url": "https://docs.memudecore.com.br",
        "timeout": 10000,
        "options": {
          "response": {
            "response": {
              "fullResponse": true
            }
          }
        }
      }
    },
    {
      "name": "Check Status",
      "type": "n8n-nodes-base.switch",
      "parameters": {
        "conditions": {
          "boolean": [
            {
              "value1": "={{ $json.statusCode }}",
              "value2": 200,
              "operation": "equal"
            }
          ]
        }
      }
    },
    {
      "name": "Alert if Down",
      "type": "n8n-nodes-base.slack",
      "parameters": {
        "channel": "#alerts",
        "text": "🚨 WEBSITE DOWN: {{ $('Check Website').item.json.config.url }} - Status: {{ $('Check Website').item.json.statusCode }}"
      }
    }
  ]
}

📧 TEMPLATE: PROCESSAMENTO DE EMAIL

{
  "name": "Template - Email Processing",
  "description": "Processar emails recebidos e criar tasks",
  "nodes": [
    {
      "name": "Email Trigger",
      "type": "n8n-nodes-base.emailReadImap",
      "parameters": {
        "format": "simple",
        "options": {
          "allowUnauthorizedCerts": true
        }
      }
    },
    {
      "name": "Parse Email Content",
      "type": "n8n-nodes-base.set",
      "parameters": {
        "values": {
          "string": [
            {
              "name": "subject",
              "value": "={{ $json.subject }}"
            },
            {
              "name": "from",
              "value": "={{ $json.from.text }}"
            },
            {
              "name": "priority",
              "value": "={{ $json.subject.includes('[URGENT]') ? 'high' : 'normal' }}"
            }
          ]
        }
      }
    },
    {
      "name": "Create Task in System",
      "type": "n8n-nodes-base.httpRequest",
      "parameters": {
        "method": "POST",
        "url": "https://api.sistema-interno.com/tasks",
        "body": {
          "title": "={{ $json.subject }}",
          "description": "Email de: {{ $json.from }}",
          "priority": "={{ $json.priority }}"
        }
      }
    }
  ]
}

📑 CAPÍTULO 5: TROUBLESHOOTING

🚨 PROBLEMAS COMUNS

❌ Workflow Não Executa

Possíveis Causas:

  • Workflow desativado
  • Trigger configurado incorretamente
  • Credenciais expiradas
  • Erro no primeiro node

🔧 Soluções:

1. Verificar Status:
   - Toggle "Active" deve estar ligado
   - Verificar na aba "Executions" se há tentativas

2. Validar Trigger:
   - Cron: verificar expressão cron válida
   - Webhook: testar URL do webhook
   - Manual: executar manualmente primeiro

3. Credenciais:
   - Settings → Credentials
   - Testar conexão de todas as integrações
   - Renovar tokens expirados

4. Debug:
   - Executar step-by-step
   - Verificar dados de entrada de cada node
   - Logs detalhados na aba "Executions"

⚠️ Erro de Conexão com APIs

Sintomas:

  • Timeout errors
  • 401/403 HTTP errors
  • SSL/Certificate errors

🔧 Soluções:

HTTP Errors:
  401 Unauthorized: Verificar API keys/tokens
  403 Forbidden: Verificar permissões da API
  429 Rate Limited: Implementar retry com delay
  500 Server Error: Verificar status da API externa

Timeout Errors:
  - Aumentar timeout no HTTP Request node
  - Implementar retry logic
  - Dividir requests grandes em lotes

SSL Errors:
  - Habilitar "Ignore SSL Issues"
  - Verificar certificados da API
  - Usar HTTP ao invés de HTTPS se necessário

🔄 Performance Lenta

Causes:

  • Loops desnecessários
  • Processamento de grandes volumes
  • Muitas chamadas de API sequenciais
  • Nodes com lógica complexa

🔧 Otimizações:

Batch Processing:
  - Usar "Batch Size" em nodes que suportam
  - Agrupar operações similares
  - Processar em paralelo quando possível

Reduce API Calls:
  - Cache de dados quando apropriado
  - Bulk operations quando disponível
  - Conditional execution (Skip Node)

Code Optimization:
  - Evitar loops desnecessários no Code Node
  - Usar Set Node ao invés de Code para operações simples
  - Limitar dados processados (filters)

🔍 FERRAMENTAS DE DEBUG

📊 Executions Tab

  • Histórico de todas as execuções
  • Status: Success, Error, Running
  • Tempo de execução
  • Dados de entrada/saída de cada node

🔬 Node Inspector

  • Clicar em qualquer node durante/após execução
  • Ver dados exatos processados
  • Input e Output de cada step
  • Error details se aplicável

📝 Logging

// Em Code Nodes, usar console.log para debug
console.log('Debug info:', JSON.stringify(items, null, 2));

// Logs aparecem na aba "Executions"
// Útil para rastrear valores de variáveis

🧪 Test Mode

Workflow Testing:
  1. Use "Execute Workflow" (não "Save & Execute")
  2. Dados de teste no primeiro node
  3. Step-by-step execution
  4. Validate cada node antes de continuar

📞 QUANDO PEDIR AJUDA

🆘 Suporte Interno

  • Problemas de Workflow: dev@memudecore.com.br
  • Integração com APIs: Verificar docs da API primeiro
  • Performance Issues: Incluir detalhes de execução
  • Bugs do N8N: Verificar versão e known issues

📚 Recursos Externos

  • N8N Community: https://community.n8n.io/
  • Documentation: https://docs.n8n.io/
  • GitHub Issues: https://github.com/n8n-io/n8n/issues

📑 CAPÍTULO 6: WORKFLOWS PERSONALIZADOS

📝 COMO SOLICITAR NOVO WORKFLOW

1️⃣ Definir Necessidade

Template de Solicitação:

📋 Título: [Nome do Workflow]
🎯 Objetivo: [O que deve fazer]
🔄 Trigger: [Como deve ser acionado]
📊 Dados Necessários: [Quais informações precisa]
📤 Ações: [O que deve fazer com os dados]
⏰ Frequência: [Quando deve executar]
👥 Responsável: [Quem vai usar/monitorar]

Exemplo:
📋 Título: Alerta Estoque Baixo
🎯 Objetivo: Notificar quando produtos estão com estoque baixo
🔄 Trigger: Diário às 9h
📊 Dados: Consultar estoque no sistema ERP
📤 Ações: Enviar email para compras + Slack #estoque
⏰ Frequência: Diária
👥 Responsável: Equipe de Compras

2️⃣ Análise de Viabilidade

Checklist Interno:
  - [ ] APIs/Sistemas envolvidos estão acessíveis
  - [ ] Credenciais e permissões disponíveis
  - [ ] Complexidade técnica (1-5)
  - [ ] Tempo estimado de desenvolvimento
  - [ ] Impacto nos recursos do servidor
  - [ ] Dependências de outros sistemas

3️⃣ Processo de Desenvolvimento

Fases:
  1. Análise Técnica (1-2 dias)
     - Mapeamento de integrações
     - Definição de arquitetura
     - Identificação de riscos

  2. Desenvolvimento (3-10 dias)
     - Implementação step-by-step
     - Testes com dados mock
     - Tratamento de erros

  3. Homologação (2-3 dias)
     - Testes com dados reais
     - Validação com solicitante
     - Ajustes finais

  4. Deploy (1 dia)
     - Ativação em produção
     - Monitoramento inicial
     - Documentação final

🎛️ CONFIGURAÇÕES AVANÇADAS

⚙️ Environment Variables

Variáveis de Ambiente N8N:

Desenvolvimento:
  N8N_BASIC_AUTH_ACTIVE: true
  N8N_BASIC_AUTH_USER: admin
  N8N_BASIC_AUTH_PASSWORD: ***

Produção:
  N8N_HOST: n8n.memudecore.com.br
  N8N_PROTOCOL: https
  N8N_PORT: 5678

Database:
  DB_TYPE: mysql
  DB_MYSQLDB_HOST: bookstack_bookstack_db
  DB_MYSQLDB_PORT: 3306
  DB_MYSQLDB_DATABASE: n8n

🔐 Credentials Management

Boas Práticas:
  - Nunca hardcode API keys nos workflows
  - Usar "Credentials" do N8N para armazenar tokens
  - Rotacionar credenciais regularmente
  - Testar conexões após atualizações

Tipos de Credenciais:
  - API Keys (tokens simples)
  - OAuth2 (Google, Microsoft, etc)
  - Basic Auth (usuário/senha)
  - Headers customizados

📊 Monitoring e Alertas

Metrics Dashboard:
  - Total de execuções por workflow
  - Taxa de sucesso/erro
  - Tempo médio de execução
  - Uso de recursos

Alertas Configurados:
  - Workflow falha > 3x consecutivas
  - Execução > 10 minutos
  - Uso de memória > 80%
  - API rate limit atingido

🚀 ROADMAP DE AUTOMAÇÕES

🔄 Q1 2026 - Em Desenvolvimento

  • Automação de Deploy: Git → N8N → Slack notification
  • Customer Journey Tracking: CRM events → Analytics dashboard
  • Automated Testing: Daily health checks de todas as integrações

📋 Q2 2026 - Planejado

  • AI Content Generation: Triggers para geração de conteúdo automático
  • Advanced Analytics: Consolidação de métricas multi-fonte
  • Customer Support Automation: Ticket routing inteligente

🎯 Backlog - Ideias

  • Social Media Automation: Posts automáticos baseados em eventos
  • Invoice Processing: OCR + validation + CRM integration
  • Advanced Monitoring: ML-based anomaly detection

📞 SUPORTE E CONTATOS

🔧 Suporte Técnico

  • Email: dev@memudecore.com.br
  • Assunto: [N8N] Descrição do problema
  • Include: Screenshot, workflow export, error logs

💡 Solicitações de Novos Workflows

  • Email: workflows@memudecore.com.br
  • Template: Usar template da seção "Como Solicitar"
  • SLA: Resposta em 48h, desenvolvimento 5-15 dias
  • N8N Instance: http://n8n.memudecore.com.br
  • Documentation: https://docs.n8n.io/
  • Community: https://community.n8n.io/
  • Templates: https://n8n.io/workflows/

💡 Dica Final: Mantenha workflows simples e bem documentados. Um workflow que funciona 90% das vezes é melhor que um complexo que quebra constantemente.

📝 Última atualização: Janeiro 2026 | ✍️ Mantido por: Equipe Tech MeMude

No Comments
Back to top