Pular para o conteúdo principal
O módulo Pipeline é o CRM kanban da Leavo. Enquanto o módulo de Leads registra o contato, a Pipeline registra a negociação: valor, produtos, etapa do funil e motivo de perda.
Todo negócio está sempre vinculado a um Lead real. Os dados de contato (nome, empresa, email, telefone) nunca são duplicados no negócio — são lidos do Lead no momento da leitura.

​
Hierarquia

O catálogo de produtos é global por conta — é compartilhado por todas as pipelines, nunca escopado a uma delas.

​
Recursos

Pipelines e Grupos

Criar, configurar, reordenar e excluir funis e seus grupos

Etapas

Colunas do kanban, incluindo as etapas de Ganho e Perdido

Negócios

Quadro, listagem paginada, criação, edição e movimentação

Produtos

Catálogo global de produtos da conta

Atividades, Arquivos e Histórico

Tarefas, anexos e o log de eventos de cada negócio

​
Etapas especiais (kind)

Uma etapa pode ter um kind que muda o comportamento do negócio ao entrar nela: Cada pipeline tem no máximo uma etapa won e uma etapa lost. Elas não podem ser excluídas, porque não existe rota que as recrie. Toda pipeline nova nasce com quatro etapas padrão: E com os motivos de perda padrão: Sem orçamento, Sem resposta / sumiu, Fechou com concorrente, Sem fit com o produto, Momento errado.

​
Regras garantidas pela API

Estas regras são validadas no servidor — não são apenas travas de interface:
Mover um negócio para a etapa lost (ou criá-lo já nela) sem loss_reason retorna 400. Não existe caminho que perca um negócio em silêncio.
Excluir uma etapa que ainda contém negócios sem informar target_stage_id retorna 409. Os negócios nunca são apagados junto com a etapa.
Retorna 409 com a contagem de pipelines. Mova-as para outro grupo antes.
As linhas de produto já existentes viram linhas avulsas (custom: true), preservando nome e preço. Os negócios continuam editáveis.
Criar ou mover um negócio para uma etapa de outra pipeline retorna 400.

​
Permissões

Toda rota da Pipeline — inclusive as de leitura — é protegida por uma permissão granular. Um papel customizado sem pipeline.view recebe 403 da API, e não apenas um menu escondido. O papel de sistema OPERATOR recebe pipeline.view, pipeline.deals.create e pipeline.deals.edit. Para descobrir as permissões efetivas do usuário autenticado:

GET /backend/roles/my-permissions

​
Valor de um negócio

O total de um negócio (total) é calculado assim:
  • Se o negócio tem produtos: soma de price × qty de cada linha.
  • Se não tem produtos: usa o campo legado value.
O campo total sempre vem calculado na resposta — não é preciso somar no cliente.

​
Autenticação

Todos os endpoints da Pipeline exigem autenticação:
Veja Autenticação para detalhes.