n8n — Automações

O n8n é uma plataforma de automação de fluxos de trabalho. Na arquitetura do CRM, ele atua como orquestrador externo que chama o backend CRM via API.

Papel no sistema

• Disparar ações automatizadas com base em eventos externos
• Integrar com sistemas que o CRM não integra diretamente
• Criar fluxos customizados sem modificar o código do CRM

Como o n8n se autentica no CRM

Usa o Internal API Key — uma chave de API dedicada para serviços internos:

Authorization: Bearer {INTERNAL_API_KEY}

Validado pelo InternalApiKeyGuard com crypto.timingSafeEqual(). Falhas são logadas com IP e path.

Variável: INTERNAL_API_KEY — no Azure Key Vault em produção.

Endpoints disponíveis para o n8n

Endpoints marcados com InternalApiKeyGuard (não requerem JWT Clerk):

# Sync manual do ERP
POST /erp/sync/trigger
{ "startDate": "YYYY-MM-DD", "endDate": "YYYY-MM-DD" }

# Recomputar RFM
POST /rfm/recompute

# Retry de jobs com falha
POST /admin/queue/retry-failed

# Verificar health do sistema
GET /health

Casos de uso típicos

Automação	Trigger	Ação no CRM
Sync diário do ERP	Cron 3h da manhã	POST /erp/sync/trigger
Recomputar RFM	Após sync do ERP	POST /rfm/recompute
Alertar sobre jobs com falha	Cron 1x/hora	GET /admin/queue/failed → notificação Slack/email
Webhook externo (ex: e-commerce)	Evento de venda	POST /erp/sync/trigger para data específica

Configuração

O n8n não tem configuração específica no banco do CRM. A configuração fica no próprio servidor n8n:

• URL base do CRM: https://apicrm.galdix.com.br
• Header de auth: Authorization: Bearer {INTERNAL_API_KEY}

Segurança

• INTERNAL_API_KEY tem acesso limitado — apenas endpoints internos, não endpoints de usuário
• Falhas de autenticação são logadas com IP de origem
• O n8n deve rodar na mesma rede privada que o CRM (não exposto à internet)