Integrações Externas

O CRM Galdix integra com os seguintes serviços externos:

Mapa de integrações

CRM Backend
  │
  ├── Clerk           → Autenticação de usuários do CRM
  ├── Meta WhatsApp   → Envio de templates e recebimento de mensagens
  ├── Chatwoot        → Atendimento ao cliente (inbox)
  ├── Evolution API   → WhatsApp não-oficial por loja (QR code)
  ├── Millennium ERP  → Fonte de dados (clientes, vendas, produtos)
  ├── n8n             → Automações e orquestração
  └── MinIO           → Storage de arquivos (imagens de email, templates)

Tabela resumo

Integração	Protocolo	Autenticação	Direção
Clerk	REST + Webhooks	JWT (verificado localmente)	Bidirecional
Meta WhatsApp	REST + Webhooks	Bearer token	Bidirecional
Chatwoot	REST + Webhooks + DB direto	API Key	Bidirecional
Evolution API	REST	API Key	Saída
Millennium ERP	REST (HTTP pull)	Basic ou API Key	Entrada (pull)
n8n	REST (Internal API Key)	Bearer INTERNAL_API_KEY	Entrada
MinIO	S3 API	Access Key + Secret	Saída

Dependências críticas

Se qualquer integração estiver fora do ar:

Integração	Impacto se indisponível
Clerk	Nenhum usuário consegue logar
Meta WhatsApp	Campanhas WhatsApp falham, inbox não recebe mensagens
Postgresql	Sistema completamente fora do ar
Redis	Filas param; rate limiting falha
Chatwoot	Atendimento ao cliente não funciona
Evolution API	Números Evolution não funcionam
Millennium ERP	Sync de dados para; dados ficam desatualizados
n8n	Automações param
MinIO	Upload de imagens falha

Ver Contingência para como agir em cada caso.

Configuração de secrets

Todas as credenciais de integração ficam no Azure Key Vault em produção. Em desenvolvimento, no arquivo .env.secrets.

Ver Secrets & Criptografia para detalhes.