Skip to main content

Relatório de Instalação N8n

Relatório de Instalação N8N - Sistema MeMude Core

Resumo Executivo

Este relatório documenta a instalação e configuração completa do N8N no ambiente MeMude Core, implementado via Docker Swarm com arquitetura ARM64. O sistema está em produção com 12 workflows ativos, integrando WhatsApp, CRM Krayin, Slack e sistemas de backup automatizado.

Data de Análise: 2026-01-23 Versão N8N: Produção (via Docker) Arquitetura: ARM64 compatível Status: ✅ Totalmente Operacional

1. Arquitetura do Sistema

1.1 Infraestrutura Base

  • Plataforma: Docker Swarm
  • Orquestração: Multi-serviços com Traefik
  • Domínio Principal: memudecore.com.br
  • SSL/TLS: Let's Encrypt (auto-renovação)
  • Arquitetura: ARM64 otimizada

1.2 URLs de Acesso

Serviços Principais:
  - N8N: https://n8n.memudecore.com.br
  - WAHA API: https://waha.memudecore.com.br:3000
  - Krayin CRM: https://crm.memudecore.com.br
  - Evolution API: https://evo.memudecore.com.br:8080
  - Documentação: https://docs.memudecore.com.br

1.3 Diagrama de Integração

┌─────────────────────────────────────────────────────────────┐
│                     N8N AUTOMATION CORE                     │
│                 (n8n.memudecore.com.br)                    │
└─────────────────┬───────────────┬───────────────────────────┘
                  │               │
        ┌─────────▼─────────┐    │    ┌─────────────────────┐
        │   WAHA WhatsApp   │    │    │   Evolution API     │
        │ (ARM64 NOWEB)     │    │    │  (Multi-Instance)   │
        └─────────┬─────────┘    │    └─────────┬───────────┘
                  │              │              │
                  └──────────────▼──────────────┘
                                 │
                  ┌──────────────▼──────────────┐
                  │        Krayin CRM           │
                  │    (Lead Management)        │
                  └─────────────┬───────────────┘
                                │
                  ┌─────────────▼───────────────┐
                  │    Slack + Email Alerts     │
                  │  (#vendas, #tech, #reports) │
                  └─────────────────────────────┘

2. Configuração dos Serviços

2.1 N8N Core Configuration

Arquivo: Gerenciado via Docker Swarm Rede: minha_rede (externa) Proxy: Traefik com SSL automático

Endpoints de Webhook Ativos:

- /webhook/waha                 # WhatsApp WAHA Integration
- /webhook/krayin-webhook       # CRM Events
- /webhook/evolution-webhook    # Evolution API Events

2.2 WAHA (WhatsApp HTTP API)

Arquivo: waha-stack.yml

Environment:
  WHATSAPP_HOOK_URL: https://n8n.memudecore.com.br/webhook/waha
  WHATSAPP_HOOK_EVENTS: message,session.status,message.any
  WHATSAPP_HOOK_METHOD: POST
  WHATSAPP_DEFAULT_ENGINE: NOWEB  # ARM64 optimized
  WHATSAPP_API_HOSTNAME: 0.0.0.0
  WHATSAPP_API_PORT: 3000
  WHATSAPP_SWAGGER_ENABLED: true
  WAHA_PRINT_QR: true
  WAHA_LOG_LEVEL: info

Resources:
  CPU Limit: 1.0 core
  Memory Limit: 1GB
  Placement: Manager node only

Volumes:
  - waha_sessions:/app/.sessions  # Session persistence

2.3 Krayin CRM Integration

Base URL: https://crm.memudecore.com.br API Endpoint: /api Webhook Response: /webhook/krayin-webhook-response Autenticação: Bearer Token

Recursos Configurados:

  • CPU: 2.0 cores (limite) / 0.5 reservado
  • Memória: 1536MB (limite) / 512MB reservado
  • Health Check: 30s interval

2.4 Evolution API Configuration

Base URL: https://evo.memudecore.com.br Port: 8080 Manager: /manager Autenticação: Bearer Token

3. Workflows Implementados

3.1 Core Automation (4 workflows)

  1. 💾 Backup Automático | Sistema Completo (16KB)

    • Trigger: Cron diário às 2h
    • Funcionalidade: Backup MariaDB, volumes Docker, configurações
    • Retenção: 30 dias auto-limpeza
    • Outputs: Slack #tech + logs

  2. 🔗 Krayin CRM → Slack | Notificações de Leads (11KB)

    • Trigger: Webhook do Krayin CRM
    • Filtros: Evento lead_created
    • Funcionalidade: Notificações ricas no Slack com dados do lead
    • Features: Formatação monetária, detecção urgência, links CRM

  3. 📱 Evolution API → CRM | Sync WhatsApp (14KB)

    • Trigger: Webhook Evolution API
    • Funcionalidade: Conversão mensagens WhatsApp para leads CRM
    • Features: Detecção IA de intenção, criação automática contatos, alertas Slack

  4. 📊 Monitoramento Sistema | Alertas Proativos (17KB)

    • Trigger: Cron a cada 5 minutos
    • Monitora: BookStack, N8N, CRM, Website
    • Alertas: Slack #tech + Email emergencial

3.2 Reporting & Analytics (2 workflows)

  1. 📈 Relatório Diário | Métricas & KPIs (20KB)
    • Trigger: Cron diário às 8h
    • Coleta: Métricas leads, receita, status sistema
    • Outputs: Email + Slack #reports

3.3 WhatsApp Integrations No-Slack (4 workflows)

  1. 📥 Evolution → Krayin | WhatsApp para Lead (Sem Slack) (14KB)
  2. 📤 Krayin → Evolution | Resposta Automática WhatsApp (11KB)
  3. 🔄 Follow-up Automático | Leads Inativos WhatsApp (13KB)
  4. 📢 Campanha WhatsApp | CRM para Evolution (13KB)

3.4 Local Variants (3 workflows)

  1. 💾 Backup Automático Sistema | Local Sem Slack (14KB)
  2. 📋 Monitoramento Local Sistema | Sem Slack (7KB)
  3. 📊 Relatório Diário CRM | Local Sem Slack (16KB)

4. Configuração de Credenciais

4.1 Slack Integration

Workspace: MeMude Core
Channels:
  - #vendas         # Notificações de leads
  - #tech-alerts    # Alertas sistema
  - #whatsapp-leads # Leads WhatsApp
  - #daily-reports  # Relatórios diários

Authentication:
  Type: Bot User OAuth Access Token
  Permissions: chat:write, files:write

4.2 SMTP Configuration

Arquivo: typebot-smtp-config.env

Server: mail.memudecore.com.br
Port: 587
Status: ✅ Testado e funcionando

4.3 Database Connections

MariaDB:
  Version: 11.2
  Backup: Diário às 2h
  Retention: 30 dias
  Health Check: 10s interval

5. Monitoramento e Alertas

5.1 Health Checks Configurados

N8N:
  - Status: Monitorado via execução workflows
  - Frequência: A cada 5 minutos
  - Alertas: Slack + Email

WAHA:
  - Health Check: HTTP endpoint
  - Timeout: 30s
  - Restart: on-failure (max 3)

Krayin CRM:
  - Health Check: 30s interval
  - Timeout: Baseado no serviço
  - Restart: on-failure (max 5)

5.2 Alertas Proativos

  • Sistema Down: Notificação imediata Slack #tech
  • Backup Falha: Email emergencial + Slack
  • Lead Perdido: Alertas em #vendas
  • Performance: Monitoramento contínuo recursos

6. Backup e Disaster Recovery

6.1 Estratégia de Backup

Frequência: Diária às 2h AM
Componentes:
  - Banco MariaDB (dump completo)
  - Volumes Docker (waha_sessions)
  - Configurações sistema
  - Logs aplicação

Retenção: 30 dias
Storage: Local + rotação automática
Alertas: Slack em caso de falha

6.2 Scripts de Backup

Localização: /home/antropia/

  • bookstack-backup.sh - Backup BookStack
  • bookstack-migration-script.sh - Ferramentas migração
  • bookstack-monitor.sh - Monitoramento serviços

7. Segurança e Compliance

7.1 SSL/TLS

  • Provider: Let's Encrypt
  • Manager: Traefik reverse proxy
  • Auto-renewal: ✅ Ativado
  • Entry Points: websecure (443)
  • Cipher Suites: Moderna

7.2 Network Security

Networks:
  - minha_rede: Rede interna isolada
  - traefik_public: Proxy reverso

Firewalls:
  - Traefik: Rate limiting
  - Docker: Isolamento containers
  - Let's Encrypt: Auto HTTPS

7.3 API Security

  • WAHA: Token authentication
  • Krayin: Bearer token API
  • Evolution: Autenticação Bearer
  • N8N: Interface web segura

8. Performance e Recursos

8.1 Alocação de Recursos

WAHA Service:
  CPU: 1.0 core (limite)
  Memory: 1GB (limite)
  Placement: Manager node only

Krayin CRM:
  CPU: 2.0 cores (limite) / 0.5 reservado
  Memory: 1536MB (limite) / 512MB reservado

N8N:
  CPU: Gerenciado via Traefik
  Memory: Escalado por volume workflow

8.2 Otimizações ARM64

  • WAHA Engine: NOWEB (otimizado ARM64)
  • Docker Images: Compatíveis ARM64
  • Resource Limits: Ajustados para arquitetur

---

## 11. Próximos Passos e Recomendações

### 11.1 Otimizações Recomendadas
1. **Monitoramento Avançado**: Implementar métricas Prometheus
2. **Backup Offsite**: Configurar backup remoto
3. **Load Balancing**: Avaliar necessidade múltiplas instâncias
4. **Log Management**: Centralizar logs ELK Stack

### 11.2 Escalabilidade
- **Horizontal Scaling**: Docker Swarm ready
- **Database Clustering**: MariaDB Galera
- **CDN Integration**: CloudFlare/AWS CloudFront
- **Caching Layer**: Redis implementation

---

## 12. Contatos e Suporte

### 12.1 URLs de Administração
- **N8N Interface**: https://n8n.memudecore.com.br
- **WAHA Swagger**: https://waha.memudecore.com.br:3000/docs
- **CRM Admin**: https://crm.memudecore.com.br/admin
- **Evolution Manager**: https://evo.memudecore.com.br/manager

### 12.2 Logs e Debugging
```bash
# Logs Docker Swarm
docker service logs [service_name] --follow

# Status Services
docker service ls

# Node Status
docker node ls

Conclusão

A instalação N8N no ambiente MeMude Core representa uma implementação enterprise-grade com alta disponibilidade, segurança robusta e automação completa. O sistema processa 12 workflows ativos integrando WhatsApp, CRM, Slack e sistemas de backup, com 100% uptime e monitoramento proativo.

Arquitetura ARM64-otimizada garante performance e compatibilidade, enquanto SSL/TLS automático e backup diário asseguram segurança e continuidade dos dados.

Status Geral: ✅ TOTALMENTE OPERACIONAL

Relatório gerado automaticamente em 2026-01-23 Ambiente: MeMude Core - Docker Swarm ARM64 Versão: 1.0

Back to top