Skip to main content
O Pipeline de Leads é um board Kanban que organiza seus contatos em estágios de funil de vendas. Cada card representa um lead, e você move ele entre colunas conforme o avanço da negociação — manualmente por drag-and-drop ou automaticamente via regras de automação. Board Kanban do Pipeline de Leads com estágios e cards

​
Estágios padrão

O pipeline vem com sete estágios predefinidos, mas você pode personalizar a lista:
EstágioCorDescrição
NovoAzulLead recém-criado ou importado
ContatadoAmareloPrimeiro contato realizado
QualificadoVerdePerfil confirma potencial de compra
PropostaRoxoProposta comercial enviada
NegociaçãoLaranjaEm processo de fechamento
GanhoVerde escuroVenda concluída
PerdidoVermelhoOportunidade encerrada sem venda
O agente de IA pode mover leads automaticamente entre estágios via a ferramenta update-lead-stage. Configure no prompt quando e como o agente deve fazer essa transição — por exemplo, quando o contato confirmar interesse ou solicitar uma proposta.

​
Criando um lead

1

Abra o Pipeline

No menu lateral, vá em CRM → Pipeline de Leads.
2

Clique em '+ Novo Lead'

O botão fica no canto superior direito do board.
3

Preencha os dados

Campos disponíveis: nome, e-mail, telefone, empresa, cargo, fonte do lead (website, whatsapp, instagram, indicação, importação), faixa de orçamento, prazo de decisão e pontos de dor.
4

Vincule a um contato

Se o lead já existe como contato na base, você pode vinculá-lo no campo contact_id. Isso conecta o lead ao histórico de conversas do contato.
5

Salve

O card aparece na coluna Novo automaticamente.

​
Movendo leads

Arraste o card da coluna atual para a coluna de destino. O sistema usa @dnd-kit/core com detecção por closestCorners — funciona em desktop e touch screen.
Toda movimentação de estágio registra um evento na timeline do contato vinculado. Você sempre sabe quando e por quem o lead foi movido, com motivo quando preenchido.

​
Score de leads

Cada lead tem um score numérico de 0 a 100 que representa a qualidade da oportunidade. O score é calculado com base em:
  • Completude do perfil (e-mail, telefone, empresa preenchidos)
  • Faixa de orçamento declarada
  • Prazo de decisão (quanto mais curto, mais alto o score)
  • Número de interações via chat
  • Estágio atual no funil
O score aparece como badge em cada card do Kanban. Use o filtro de score mínimo para ver apenas leads quentes.

​
Filtros e busca

Busca por texto

Filtra por nome do lead, empresa ou e-mail em tempo real enquanto você digita. Opera sobre todos os estágios simultaneamente.

Filtro por fonte

Selecione website, whatsapp, instagram ou outra fonte para ver apenas leads de um canal específico. Ideal para medir ROI por canal.

​
Convertendo um lead

Quando o lead é ganho, use o botão Converter no card para:
  1. Marcar o estágio como won
  2. Criar um registro de cliente na base de contatos com todos os dados do lead
  3. Opcionalmente abrir um workflow de onboarding automaticamente
O diálogo de conversão (ConversionDialog) permite ajustar dados antes de confirmar e associar o lead a um workspace ou produto específico.
Leads marcados como lost ficam visíveis no board mas são excluídos do funil ativo por padrão. Use o toggle Mostrar perdidos para incluí-los na visualização e analisar padrões de perda.

​
Métricas do pipeline

No canto superior do board, o painel de métricas exibe:
  • Total de leads ativos — excluindo ganhos e perdidos
  • Taxa de conversão — leads ganhos / total
  • Ticket médio — média das faixas de orçamento dos leads qualificados
  • Tempo médio no funil — dias desde criação até ganho ou perda