Arquitetura
Como o NeuralClint é construído, para quem quer entender por dentro.
WhatsApp Cloud │ WhatsApp (QR code) │ Instagram DM
└──────────────┬──────────────┘
▼
Gateway de canais (webhooks → mensagem unificada)
│
┌──────────┬────────┴──────┬──────────────┬─────────────┐
Inbox/CRM Motor de fluxos Agentes de IA Integrações Tempo real
└──────────┴───────────────┴──────────────┴─────────────┘
│
Registro de ferramentas (fonte única de ações)
┌──────────────┼──────────────┐
Interface Copilot API / MCP (em breve)Princípios
- Simples e clean — mínimo de campos, bons padrões, opções avançadas escondidas.
- AI-first — toda ação é uma ferramenta exposta a todas as superfícies.
- Descreva → Revise → Aplique — a IA nunca altera nada em silêncio.
- Multi-tenant — isolamento por Row Level Security.
- Configuração como dados — agentes e fluxos são JSON validados por schema e versionados.
- Adaptadores intercambiáveis — canais e provedores de IA atrás de interfaces únicas.
Componentes
| Camada | Tecnologia |
|---|---|
| Aplicação web | Next.js, React, Tailwind, React Flow (editor) |
| API | Node.js, Fastify, Zod |
| Banco | PostgreSQL com pgvector (busca semântica) e busca textual em português |
| Tempo real | Eventos do Postgres (LISTEN/NOTIFY) entregues por Server-Sent Events |
| Motor de fluxos | Motor puro e determinístico; execuções e esperas duráveis no Postgres (FOR UPDATE SKIP LOCKED) |
| WhatsApp por QR code | Serviço isolado dedicado |
| IA | SDKs oficiais da Anthropic, OpenAI e Google; DeepSeek compatível com OpenAI |
Ordem de atendimento
Mensagem recebida → retoma um fluxo aguardando resposta → senão verifica gatilhos → senão o agente de IA do canal responde.