Hierarquia simples
Pipeline
Um pipeline representa um fluxo específico do seu funil — um caminho que um lead percorre do início ao fim. Exemplos comuns:
A separação de pipelines existe pra que cada um tenha sua própria
métrica + cadência. O conversion rate de outbound não deve se misturar
com o de inbound.
Stages
Stages são os estágios que um lead percorre dentro de um pipeline. Defaults razoáveis pra outbound B2B:Stages “fechados”
Stages podem ser marcados como fechados-ganho ou fechados-perdido. Isto:- Move o lead pra view de “histórico” automaticamente
- Conta nas métricas de conversion rate
- Sinaliza pros agentes “não precisa fazer mais nada com este lead”
Lead
Um lead é um card que vive em um stage de um pipeline. Cada lead carrega:- Dados de contato (nome, e-mail, telefone, site)
- Dados de empresa (nome, localização, setor)
- Owner — pessoa responsável (humano ou agente)
- Valor potencial — quanto vale fechar esse lead (em centavos da moeda configurada)
- Tags — labels customizáveis
- Custom fields — campos da sua org
Owner
Quem é “dono” do lead determina quem o sistema notifica em eventos (reply chegou, hora de follow-up, etc.). O owner pode ser:- Um humano (membro da org)
- Um agente (Marcus, Athena, ou customizado)
Atividades
Toda movimentação relevante de um lead gera uma atividade no histórico. É o audit log do CRM — append-only, nada deletado. Tipos automáticos:
Cada atividade carrega quem fez (humano X ou agente Y), quando
e o payload da mudança. Auditoria total — você reconstrói o
histórico de qualquer lead em segundos.
Movimentação humano vs agente
Quando o Marcus move um lead de stage (ex.: “Em conversa” → “Proposta enviada” após disparar a proposta), a atividade carregaactor_type = 'agent' + o ID do agente.
Quando você move manualmente, actor_type = 'user' + seu user ID.
Isso aparece na timeline do lead — em vez de “Stage mudou para X”,
você vê “Marcus moveu pra X” ou “João Silva moveu pra X”. Sem
ambiguidade.
Filtros e segmentação
Filtros aplicam-se sobre o conjunto de leads visíveis. Combina:- Pipeline + stage
- Owner (humano específico, qualquer humano, agente específico)
- Tags
- Custom field values
- Data (criação, última atividade, próxima ação)
- Valor potencial (range)
Próximos passos
CRM (feature)
Como operar no dia-a-dia: kanban, lista, custom fields, import.
Outbound
Como leads viram campanhas geridas pelo Marcus.
Agentes
Quando um agente é owner de um lead, ele opera autonomamente.