> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orquena.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CRM e conectores

> Estratégia do CRM nativo e avaliação de Twenty, EspoCRM e SuiteCRM.

# 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

| Informação                    | Fonte oficial     |
| ----------------------------- | ----------------- |
| Identidade, telefone e email  | Contacts          |
| Conversas e mensagens         | Inbox             |
| Agenda e disponibilidade      | Scheduling        |
| Lead, oportunidade e pipeline | CRM               |
| IDs externos                  | Connector mapping |

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.

<Warning>
  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.
</Warning>

## 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.

## Links oficiais

<CardGroup cols={2}>
  <Card title="Twenty" icon="blocks" href="https://docs.twenty.com/">
    Documentação e APIs do principal CRM de referência.
  </Card>

  <Card title="Twenty no GitHub" icon="github" href="https://github.com/twentyhq/twenty">
    Código, releases e licença.
  </Card>

  <Card title="EspoCRM Developers" icon="code" href="https://docs.espocrm.com/development/">
    REST API, metadata e extensões.
  </Card>

  <Card title="EspoCRM no GitHub" icon="github" href="https://github.com/espocrm/espocrm">
    Código e releases.
  </Card>

  <Card title="SuiteCRM Developers" icon="book-open" href="https://docs.suitecrm.com/developer/">
    Referência técnica e API.
  </Card>
</CardGroup>