CRM - Listagem de Leads

O que é

A página Leads lista todos os clientes que estao em qualificacao no CRM, ou seja, com status configurado que não e convertido nem perdido. E o ponto de partida diario do time comercial: quem entrou, em que estagio esta, quem e o vendedor responsavel e qual o próximo passo.

Você costuma chegar aqui depois que um lead entra (via formulario do site, cadastro manual, importacao em planilha ou indicacao) e precisa qualificar, atribuir a um vendedor ou converter em oportunidade. Vendedores sem a permissão de ver todos os leads do CRM veem apenas os leads cujo vendedor responsavel e ele mesmo - o controlador filtra automaticamente pelo vendedor_id.

Como usar

1. Va em Modulos > CRM > Leads no sidebar.

2. Cards no topo mostram o Total e a contagem por cada status ativo de qualificacao (cores e icones definidos em CRM > Configurações de Status).

3. Use a barra de filtros para refinar a lista:

   • Buscar por nome, email ou telefone... - campo de busca livre.
   • Status - filtra pelo status atual de qualificacao do lead.
   • Fonte - restringe por origem cadastrada (site, indicacao, etc.).
   • Vendedor - exibe so os leads de um vendedor especifico.
   • Ordenar - alterna entre Mais recentes, Maior score e Nome A-Z.

4. Para cadastrar manualmente, clique em Novo Lead (botao flutuante azul no canto superior direito).

5. Para qualificar um lead direto na lista, clique em um dos botoes-pilula coloridos na linha Status: dentro do card. O sistema atualiza o status na hora (rota leads.qualificar).

6. Para converter, clique em Converter (barra de ações verde no card ou opção Converter no dropdown de tres pontos). Preencha:

   • Titulo da Oportunidade (obrigatório).
   • Pipeline (obrigatório) - a oportunidade entra na primeira etapa ordenada do pipeline escolhido.
   • Valor Estimado (opcional, em reais).

   Confirme em Converter em Oportunidade. O lead avanca para um status intermediario (terceiro status ativo, geralmente SQL) e você e redirecionado para a oportunidade criada.

Casos especiais

Vendedor sem permissão de ver todos os leads do CRM

O controlador aplica filtro automático: o vendedor so enxerga os leads em que ele e o vendedor responsavel (crmDados.vendedor_id). Tentar abrir um lead de outro vendedor retorna 403 - "Você não tem acesso a este lead.".

Lead vindo do site ou cadastro de cliente

Quando um cliente e cadastrado fora do CRM (site, importacao, checkout), o Observer cria o CrmClienteDados com status inicial configurado e data_captacao = agora. Por isso o registro ja aparece nesta lista sem ação manual - desde que o status inicial seja ativo, não convertido e não perdido.

Marcar como perdido

Use o botao vermelho com o nome do status perdido configurado (ex: "Não Qualificado" ou "Perdido") na barra de ações rapidas. O sistema pede confirmação via modal antes de aplicar.

Lead com viagens ou oportunidades em aberto

Badges no card sinalizam:

• N viagem(s) (teal, icone de ticket) - passageiros confirmados ou pendentes vinculados ao cliente.
• N oportunidade(s) (verde, icone de cifrao) - oportunidades em aberto daquele lead.

Importacao em massa

Use Importar (botao branco no cabecalho) para subir planilha. A documentacao da importacao tem fluxo proprio (download de template, preview e processamento).

Estado vazio

Se nenhum lead corresponde aos filtros, aparece a mensagem "Nenhum lead encontrado" com texto explicativo "Leads são clientes em processo de qualificacao (não convertidos nem perdidos)" e um atalho para Criar Primeiro Lead.

Erros comuns e como resolver

• "O pipeline selecionado não possui etapas configuradas." - Causa: você escolheu um pipeline sem etapas no modal de conversao. Solucao: cadastre etapas em CRM > Pipelines e tente converter novamente.
• "Você não tem acesso a este lead." (HTTP 403) - Causa: vendedor sem ver todos os leads do CRM tentou abrir lead de outro responsavel. Solucao: pedir ao gerente para reatribuir o lead via Atribuir Vendedor ou conceder a permissão de ver todos os leads do CRM.
• E-mail ja cadastrado / CPF ja cadastrado (validação no formulario Novo Lead) - Causa: ja existe cliente com mesmo email/CPF. Solucao: abrir o cliente existente e qualifica-lo como lead em vez de duplicar.

Onde encontrar

• URL: /admin/crm/leads
• Caminho no menu: Modulos > CRM > Leads
• Permissão necessária: crm.leads (visualizar todos exige também ver todos os leads do CRM)
• Módulo necessário: CRM (slug crm)

Veja também

• CRM - Gestão de Relacionamento (visao geral)
• Oportunidades de Venda
• Pipelines e Kanban
• Interacoes com Clientes
• Tarefas e Follow-ups