Documentação Técnica - Automações n8n | Sullaser Group

📚 Documentação Técnica - Automações n8n

Sullaser Group | Sistema Completo de Automações Empresariais

👤 Funções, Responsabilidades e Escopo Operacional

Por Everson Santos — Infraestrutura • Automação • Observabilidade • Suporte Multiplataforma

🧠 Escopo Geral da Função

Profissional responsável por toda a camada crítica de infraestrutura, redes, automações, servidores, observabilidade e manutenção de sistemas da empresa. Atua como ponto único entre TI, operações, marketing, comercial, automação e plataformas externas, garantindo continuidade dos serviços, segurança e desempenho.

⚙️ Infraestrutura & Redes (On-Premise + Cloud)

🖥️ Responsabilidades Gerais:
• Administração completa do servidor principal (Hostinger + Self-Hosted)
• Gestão de Docker Swarm e stacks complexas (n8n, Redis, PostgreSQL, Browserless, APIs)
• Gestão de Portainer e reinstalação de containers, imagens e serviços
• Monitoramento de CPU/RAM, uso de disco, I/O e rede
• Controle de logs em tempo real de cada serviço da infraestrutura
• Implementação de mecanismos de alta disponibilidade e failover básico
🌐 Rede Interna:
• Monitoramento de tráfego e latência da rede
• Auditoria de consumo de banda
• Diagnóstico avançado (ping, traceroute, rota, DNS, packet loss)
• Monitoramento da saúde dos provedores (Mundo Vox etc)
• Restabelecimento de serviços quando há queda ou instabilidade
🔐 Segurança:
• Atualização de componentes (imagens, libs e patches de segurança)
• Auditoria de portas abertas
• Configuração de firewall e regras de acesso
• Aplicação de boas práticas de segurança para APIs e webhooks
• Gestão de backups diários e verificação de integridade

🧩 Automação – n8n (DevOps + Observabilidade + Arquitetura)

🧬 Desenvolvimento & Arquitetura:
• Criação de automações avançadas para: comercial, WhatsApp, SDR, marketing, financeiro, customer success, RH, captura de leads, dashboards e relatórios
• Modelagem lógica de workflows eficientes
• Redução de carga com split in batches, reprocessamento e filas
🐞 Monitoramento e Resolução:
• Monitoramento contínuo: filas Redis, workers, stuck executions, erros repetitivos, workflows pesados
• Identificação do ponto de falha pelo log do n8n, Redis e Postgres
• Reinício de containers quando necessário
• Correção de fluxos corrompidos ou parametrizações incorretas
• Otimização contínua dos workflows para reduzir processamento
📊 Documentação e Governança:
• Documentação de 64 automações ativas
• Registro das dependências críticas
• Mapeamento de triggers, integrações e APIs utilizadas
• Boas práticas de versionamento e controle de mudanças

🏗️ Gestão de Servidores e Sites (Hostinger + WordPress + APIs)

🌍 Monitoramento:
• Monitoramento da saúde dos sites
• Verificação de uptime e checagens manuais de desempenho
• Acompanhamento de logs de erro, 500s, timeouts e comportamento anormal
🛠️ Manutenção:
• Correção de falhas de plugins Elementor/WooCommerce
• Solução para problemas de carrinho, checkout e scripts JS
• Ajustes em funções PHP ou scripts customizados
• Monitoramento de APIs externas utilizadas pelos sites
📦 Infra Web:
• Configuração de DNS, CDN, SSL e cache
• Regras de firewall no servidor Hostinger
• Testes de rota e debugging de latência

📞 Suporte Multiplataforma (Nível Sênior)

Você é hoje o "nível 3 / especialista", resolvendo o que nenhum outro time consegue.

🎯 Plataformas Suportadas:
• Digisac (WhatsApp API)
• GoTo Connect / GoTo Phone
• Zoho CRM, People, Campaigns
• Prontuário Verde
• Mundo Vox (internet)
• Meta Business Suite
• Google Cloud / Gmail / Agenda
• Hostinger (suporte técnico e advanced)
⚡ Atividades:
• Diagnóstico de falhas em integrações
• Análise avançada de logs de plataformas
• Comunicação técnica com suporte externo
• Reestabelecimento de serviços críticos
• Ajuste de webhooks e APIs desconectadas

🤖 Observabilidade — Monitoramento Proativo

Você atua como "NOC + SRE" da empresa.

📌 O que você monitora:
• Status dos containers e stacks Docker Swarm
• Status dos workers e filas do Redis
• Falhas consecutivas nos workflows
• Erros críticos da Digisac
• Quedas de internet do provedor
• Status de envio e recebimento no WhatsApp API
• Domínios, DNS, SSL
• Consumo dos sites (erro 500, 403, 404)
• Performance geral da infraestrutura
🔔 Alertas Executados:
• Redis READONLY
• Banco PostgreSQL travado
• Erros repetitivos em automações
• Queda de conexão do servidor
• Falha em servidores da Hostinger
• Problemas no fluxo do Zoho CRM
🔄 Backup & Rotinas:
• Backup automático diário das automações
• Limpeza automática de filas Redis às 03:30
• Limpeza de logs e execuções antigas
• Acompanhamento do snapshot do Hostinger

🛠️ Desenvolvimento e Suporte de APIs

• Webhooks oficiais (Meta/WhatsApp, Zoho etc)
• Endpoints para integrações
• Conexão com bancos externos
• Scripts em JavaScript, Node e Python quando necessário
• Testes de endpoints via Postman, Insomnia e cURL

📊 Análise de Dados, Dashboards e Monitoramento Comercial

📈 Dashboards Mantidos:
• Google Sheets com fórmulas avançadas
• Dashboards de desempenho de vendas
• Dashboards de campanhas
• Extração de logs de conversas e métricas
• Relatórios de faturamento
• Relatórios de atendimento do WhatsApp
🤖 Automações Criadas:
• KPIs comerciais
• Fluxos de comissão
• Painéis diários por setor
• Dados vindos do WhatsApp

🧯 Gestão de Incidentes (Nível Crítico)

🔎 Diagnóstico:
• Identificação do ponto exato da falha
• Execução de testes avançados (rede, API, infra, automações)
• Análise cruzada entre logs dos sistemas
🛠️ Recuperação:
• Reinício de serviços críticos
• Reprocessamento de filas
• Reconstrução de workflows corrompidos
• Correção emergencial de scripts
📄 Documentação Pós-Incidente:
• Registro técnico da causa raiz
• Passos executados para solucionar
• Prevenção futura

📚 Governança e Padrões Técnicos

• Como criar automações corretamente
• Padrões de nomeação de workflows e variáveis
• Estrutura e organização dos scripts
• Regras para não quebrar serviços existentes
• Regras para inserção de chaves e credenciais
• Diretrizes para chamadas de API

⭐ Valor Agregado — O Diferencial

Você executa TI, DevOps, suporte avançado, lógica, análise, desenvolvimento e monitoramento, tudo ao mesmo tempo.

• Responsável por centenas de processos críticos da empresa
• Único profissional capaz de operar muitos sistemas essenciais
• Evita quedas, prejuízos, falhas de automação e interrupções de serviço
• Garante que operações de vendas, atendimento e marketing rodem diariamente sem falhas
• Você é o "sistema nervoso central" da empresa — infraestrutura, automações e sistemas

64

Workflows Ativos

9

Categorias

25+

Integrações Externas

100%

Documentado

⚠️ Avisos Críticos

🔴 IMPORTANTE: Esta documentação contém informações sensíveis. Mantenha em ambiente seguro e com acesso restrito.
🟡 ATENÇÃO: Antes de modificar qualquer workflow, verifique dependências críticas listadas na documentação de cada automação.

🆘 Troubleshooting & Suporte

❌ Digisac Caiu - O que fazer?

Ação: Entrar em contato com o time de suporte para sinalizar o ocorrido

Contato: 55 14 98175-6948

🌐 Internet Caiu - O que fazer?

Ação 1: Verificar modem e reiniciá-lo

Ação 2: Se não voltar após reiniciar, entrar em contato com Mundo Vox

Contato: 3512-1500

🔧 n8n Server Caiu - Procedimento

Acesso: Portainer (orquestrador Docker Swarm)

Ação 1: Verificar status dos containers no Portainer

Ação 2: Restart do serviço n8n via Portainer

Ação 3: Verificar logs para identificar causa raiz

Nota: Sistema self-hosted sem suporte oficial - resolução independente necessária

📊 Redis/PostgreSQL com problemas

Verificação: Workflow "LIMPAR FILAS WEBHOOK REDIS" executa automaticamente às 03:30

Manual: Acesso via Portainer para restart dos containers Redis/PostgreSQL

Logs: Verificar logs em Portainer > Container específico > Logs

📞 Contatos de Suporte

Prontuário Verde

Sistema de gestão da clínica

Suporte: 55 41 99954-8978

Zoho CRM

Sempre abrir chamado via:

zoho.com/pt-br/one/

Ação: Abrir ticket no portal

Mundo Vox (Internet)

Provedor de internet

Suporte: 3512-1500

Digisac (WhatsApp)

Plataforma de WhatsApp Business

Suporte: 55 14 98175-6948

GoTo (Ligações)

Sistema de ligações VoIP

Site: goto.com/pt

Suporte: Pesquisar erros no site

📞 GoTo - Problemas e Soluções

O que fazer quando der problema?

Passo 1: Entrar no site oficial goto.com/pt

Passo 2: Pesquisar os erros ocorridos na base de conhecimento

Passo 3: Estudar sobre a plataforma para resolver os problemas

⚠️ Importante: O suporte do GoTo é um pouco precário, então é necessário ter conhecimento da plataforma para resolução independente

Dica: Documentar soluções encontradas para referência futura

🏗️ Infraestrutura Técnica

Servidor self-hosted com orquestração Docker Swarm via Portainer

🐳 Docker Swarm

  • Orquestração de containers
  • Alta disponibilidade
  • Escalabilidade horizontal
  • Balanceamento de carga

🎛️ Portainer

  • Interface gráfica para Docker
  • Gerenciamento de stacks
  • Monitoramento de containers
  • Visualização de logs

⚙️ n8n (Self-Hosted)

  • Sem suporte oficial
  • Resolução independente de problemas
  • Backup automático diário (18:30)
  • 64 workflows ativos

💾 Bancos de Dados

  • Redis: Memória cache e filas
  • PostgreSQL: n8n_queue database
  • Limpeza automática às 03:30
  • Monitoramento via Portainer