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

# CRM nativo

> Leads, pipelines, atividades e custom fields — a base operacional do funil, com agentes integrados.

## Por que CRM nativo

A maioria dos produtos de IA pra vendas é **um plug-in** em cima de um
CRM externo (HubSpot, Salesforce, Pipedrive). O problema: cada
movimentação precisa ir e voltar pelo CRM externo, criando latência,
custo de licença adicional e fricção de sincronização.

O Apollo Space entrega um **CRM nativo** dentro da própria plataforma. Cada
movimentação (criar lead, mover stage, anexar atividade) acontece
direto no banco multi-tenant — sem ida-e-volta. Agentes operam
nativamente. Auditoria é completa.

Se você já usa um CRM externo, dá pra **rodar em paralelo** durante a
transição (via Composio).

## Leads

Um **lead** é o registro de uma pessoa/empresa potencial no seu funil.
Campos padrão:

* Nome do contato
* Nome da empresa
* E-mail / telefone (E.164)
* Website
* Cidade / estado / país
* Pipeline + stage atual
* Owner (responsável)
* Tags
* Valor potencial do negócio (em moeda + centavos)

### Custom fields

Você cria campos próprios pra capturar atributos do seu nicho — ex.:
"Setor", "Tamanho do time", "Tier", "Última interação". Suportados:

* Texto curto / longo
* Número (inteiro / decimal)
* Data
* Select (lista de opções)
* Multi-select

Custom fields podem ser **arquivados** (some da UI mas dado preservado)
e **restaurados** depois sem perder histórico. Útil pra refatoração de
modelo sem destruir nada.

## Pipelines

Um **pipeline** é uma sequência de **stages** que um lead percorre. Cada
org pode ter múltiplos pipelines (ex.: "Outbound novo", "Inbound
inbound", "Pós-venda — upsell").

Stages são totalmente customizáveis — começa com defaults razoáveis
("Novo lead", "Qualificado", "Proposta enviada", "Fechado-Ganho",
"Fechado-Perdido"), e você ajusta livremente.

Fluxo típico de um lead pelo pipeline default:

```mermaid theme={null}
flowchart LR
    A[Importação CSV / API / Agente] --> B[Novo lead]
    B --> C{Qualifica?}
    C -->|Sim| D[Em conversa]
    C -->|Não| Z1[Fechado-Perdido]
    D --> E[Proposta enviada]
    E --> F{Resposta?}
    F -->|Avança| G[Negociação]
    F -->|Recusa| Z2[Fechado-Perdido]
    G --> H[Fechado-Ganho]
    G -->|Impasse| Z2
```

Cada movimentação entre stages é registrada como **atividade** —
humano ou agente, autor + timestamp + razão preservados.

## Atividades

Cada movimentação relevante de um lead vira uma **atividade** no seu
histórico. Tipos automáticos:

| Tipo                                  | Como aparece                                |
| ------------------------------------- | ------------------------------------------- |
| `lead_imported`                       | Quando um lead novo é criado                |
| `stage_changed`                       | Quando muda de stage no pipeline            |
| `email_sent` / `email_received`       | E-mails enviados / recebidos                |
| `whatsapp_sent` / `whatsapp_received` | Mensagens WhatsApp                          |
| `contact_enriched`                    | Enrichment via [Apify](/integrations/apify) |
| `note_added`                          | Nota manual do humano ou agente             |
| `task_created`                        | Tarefa criada relacionada ao lead           |

Atividades carregam **quem fez** (humano ou agente) — auditoria
completa sem ambiguidade.

## Visualizações

<CardGroup cols={2}>
  <Card title="Kanban" icon="square-kanban">
    Stages do pipeline em colunas, leads como cards. Bom pra
    operação visual ("o que tá parado em Proposta há mais de 7 dias?").
  </Card>

  <Card title="Lista" icon="table-list">
    Tabela densa com colunas configuráveis. Bom pra análise + bulk
    actions (selecionar 20 leads e mudar de owner de uma vez).
  </Card>
</CardGroup>

Você alterna entre os dois com 1 click. Cada usuário pode ter sua
preferência salva.

## Filtros e segmentação

Filtros customizáveis salvam as suas combinações favoritas:

* "Leads do meu pipeline, sem atividade nos últimos 7 dias"
* "Leads com valor > 50k em stage de proposta"
* "Leads importados via Maps na última semana, sem e-mail enriquecido"

Filtros salvos são **por usuário** (cada um tem os seus) — não
poluem a UI dos colegas.

## Importação de leads

Três caminhos pra trazer leads pro Apollo Space:

<CardGroup cols={3}>
  <Card title="CSV upload" icon="file-csv">
    Subir arquivo com header → mapear colunas pros campos padrão +
    custom. Dedup automático contra leads existentes.
  </Card>

  <Card title="API" icon="code">
    Endpoint REST pra criar/atualizar leads programaticamente. Útil
    pra times com sistema próprio de captura.
  </Card>

  <Card title="Agentes" icon="robot">
    Athena ou Marcus criam leads conforme operam — ex.:
    `maps_lead_search` popula automaticamente via [Apify](/integrations/apify).
  </Card>
</CardGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Pipelines (conceito)" icon="diagram-project" href="/concepts/pipelines">
    Como modelar pipelines pro seu funil.
  </Card>

  <Card title="Outbound multicanal" icon="paper-plane" href="/features/outbound">
    Como leads do CRM viram campanhas de e-mail + WhatsApp.
  </Card>

  <Card title="Brain — knowledge da org" icon="brain" href="/features/brain">
    Onde docs + capturas ficam pros agentes consultarem.
  </Card>
</CardGroup>