Skip to main content

​
CRM e conectores

O CRM será uma capacidade opcional da Nuvexa, não o núcleo da plataforma. Uma organização poderá utilizar contatos, inbox, agenda e agentes de IA sem instalar pipelines comerciais.

​
Decisão principal

A Nuvexa terá um CRM nativo e progressivo como fonte oficial de estado comercial. Escopo inicial:
  • Leads.
  • Empresas.
  • Pipelines e etapas.
  • Oportunidades.
  • Tarefas e follow-ups.
  • Notas e atividades.
  • Responsáveis.
  • Campos customizados controlados.
  • Filtros e relatórios básicos.

​
Fronteiras de dados

O CRM referencia outras entidades sem copiá-las como registros concorrentes.

​
Por que não incorporar um CRM inteiro

  • Os agentes precisam de contratos estáveis e tenant-aware.
  • Permissões e auditoria devem ser consistentes com o restante da plataforma.
  • Um CRM genérico possui grande quantidade de funções fora do primeiro vertical.
  • Licenças e ciclos de release externos não podem controlar o Platform Kernel.
  • Dois sistemas editando o mesmo contato ou oportunidade gerariam conflitos silenciosos.

​
Twenty

Papel: principal referência moderna e futuro connector opcional. Pontos relevantes:
  • TypeScript e Nx.
  • NestJS e React.
  • PostgreSQL, Redis e BullMQ.
  • Objetos e campos configuráveis.
  • Views, filtros, kanban e workflows.
  • APIs REST, GraphQL e metadata.
  • Aplicações que estendem workspaces.
O repositório do Twenty possui termos mistos e restrições comerciais em partes do software. Pesquisa e integração por API estão aprovadas; fork, white-label e cópia de UI não estão aprovados sem revisão jurídica por arquivo e versão.

​
EspoCRM

Papel: connector secundário para clientes que precisam de um CRM maduro separado. Características úteis:
  • Leads, contas, contatos e oportunidades.
  • REST API usada pela própria aplicação.
  • Entidades, campos e relacionamentos customizados.
  • API users com roles específicas.
  • OpenAPI gerado pela instância.
  • Extension packages.
  • PostgreSQL, MySQL e MariaDB.
O EspoCRM usa AGPLv3 e uma stack PHP própria. Por isso, ficará em deployment e banco separados.

​
SuiteCRM

Papel: referência de funcionalidades enterprise e watchlist. Possui amplo conjunto de CRM, suporte, marketing, quotes, produtos e relatórios. Entretanto, a diferença entre SuiteCRM 7 e 8, a stack PHP/Angular/Symfony e o custo operacional não justificam um connector inicial.

​
Modos de sincronização

Cada entidade seleciona um modo:
  • NUVEXA_PRIMARY
  • EXTERNAL_PRIMARY
  • BIDIRECTIONAL
  • IMPORT_ONLY
BIDIRECTIONAL exige versão, conflito, tombstone e prevenção de loops. Nunca será ativado por padrão.

​
Ferramentas para agentes

O CRM poderá expor ferramentas controladas:
  • getLead
  • createLead
  • qualifyLead
  • listPipelineStages
  • moveOpportunity
  • createFollowUpTask
  • recordCommercialActivity
  • requestHumanSalesHandoff
A IA não poderá criar desconto, quote ou mudança de etapa que viole políticas.

Twenty

Documentação e APIs do principal CRM de referência.

Twenty no GitHub

Código, releases e licença.

EspoCRM Developers

REST API, metadata e extensões.

EspoCRM no GitHub

Código e releases.

SuiteCRM Developers

Referência técnica e API.