CRM - Pipelines e Kanban

O que é

Pipelines (também chamados de funis de venda) são os processos comerciais que organizam suas oportunidades em etapas, do primeiro contato até o fechamento. Cada pipeline tem suas próprias etapas, cores, probabilidades de fechamento e alertas de inatividade, permitindo modelar fluxos diferentes para cada tipo de negócio (vendas diretas, retorno de clientes, B2B, etc.). O cadastro e edição ficam em Configurações do CRM > Pipelines (/admin/crm/pipelines).

O Kanban (/admin/crm/kanban) é a visualização visual das oportunidades de um pipeline: cada coluna é uma etapa, cada cartão é uma oportunidade, e arrastar um cartão de uma coluna para outra atualiza a etapa automaticamente e dispara as automações configuradas. Você geralmente chega no Kanban depois de criar oportunidades, ou ao trocar a visualização da Lista para o quadro. Se você ainda não tem nenhum pipeline, ao abrir o Kanban o sistema redireciona para o formulário de criação com o aviso "Crie um pipeline primeiro para usar o CRM.".

Como usar

Criar um pipeline novo

1. Vá em CRM > Configurações do CRM > Pipelines no sidebar.
2. Clique em Novo Pipeline (botão azul no canto superior direito).
3. Preencha os campos do formulário:
   • Nome - obrigatório, até 100 caracteres (ex.: "Vendas de Excursões").
   • Descrição - opcional, livre.
   • Padrão - marque para que este seja o pipeline aberto por padrão no Kanban. Ao salvar, o sistema desmarca automaticamente o padrão dos demais pipelines.
   • Visibilidade - escolha Pública (todos com permissão de CRM enxergam) ou Restrita (apenas o proprietário e os usuários/papéis liberados).
   • Proprietário e Acessos (somente quando Visibilidade for Restrita) - selecione um usuário responsável e os usuários ou papéis que terão acesso. O formato interno aceita user:ID e role:ID.
4. Clique em Salvar para criar e ir direto para a edição das etapas, ou em Salvar e criar novo se quiser cadastrar outro pipeline em sequência.

Ao criar, o sistema gera automaticamente 7 etapas padrão: Novo Lead (10%), Contato Inicial (20%), Qualificado (40%), Proposta (60%), Negociação (80%), Ganho (100%, etapa final do tipo ganho) e Perdido (0%, etapa final do tipo perdido). Você pode editar, remover ou reordenar essas etapas na tela seguinte.

Configurar etapas de um pipeline

1. Em CRM > Configurações do CRM > Pipelines, clique no ícone de lápis (Editar) na linha do pipeline desejado.
2. Adicione ou edite cada etapa preenchendo:
   • Nome - obrigatório, até 100 caracteres.
   • Cor - usada na coluna do Kanban e nas badges das listagens.
   • Probabilidade - inteiro de 0 a 100, usado no cálculo de valor ponderado do funil.
   • Dias de alerta - número de dias após o qual uma oportunidade parada na etapa é destacada como inativa no Kanban.
   • Etapa final - marque para indicar que oportunidades nessa etapa estão fechadas. Quando marcada, escolha o Tipo final: ganho ou perdido.
3. Reordene as etapas arrastando-as. A ordem é persistida automaticamente.
4. Marque Salvar e continuar se quiser permanecer na tela após salvar.

Visualizar e mover oportunidades no Kanban

1. Vá em CRM > Kanban no sidebar.
2. Se houver mais de um pipeline ativo visível para você, clique em Trocar pipeline (link azul ao lado do nome do pipeline) e escolha outro. O pipeline atual fica memorizado na sessão.
3. Use os Filtros rápidos na linha de filtros no topo:
   • Todos os vendedores - filtra por vendedor (visível apenas para quem tem ver todas as oportunidades do CRM).
   • Todas as etiquetas - filtra por etiqueta.
   • Todas as prioridades - filtra por Urgente, Alta, Média ou Baixa.
   • Limpar - remove todos os filtros aplicados.
4. Para mover uma oportunidade de etapa, segure a barra Arrastar no topo do cartão (faixa cinza com ícone de duas linhas) e solte-a sobre a coluna de destino. A atualização é instantânea e o sistema dispara as automações configuradas para o evento "etapa alterada".
5. Use os botões na barra do cartão para ações rápidas: Visualizar (olho azul), Editar (lápis âmbar) e Mais ações (três pontinhos), que abre Duplicar, Definir Etiquetas, Nova Interação, Nova Tarefa, Mover p/ outro funil e Excluir.

Casos especiais

Mover oportunidade para outro pipeline

Quando o cliente muda de processo comercial (por exemplo, sai de "Vendas" e entra em "Retorno"), abra o menu de três pontinhos no cartão e clique em Mover p/ outro funil. Essa opção só aparece quando há pelo menos dois pipelines visíveis para o usuário. Ao trocar de pipeline, a oportunidade vai para a primeira etapa do novo funil.

Vendedor sem permissão crm.oportunidades.all

Vendedores que não têm a permissão de ver todas as oportunidades do CRM veem no Kanban apenas as próprias oportunidades (filtragem por vendedor_id). O filtro Todos os vendedores fica oculto para esse perfil, e a tentativa de mover uma oportunidade de terceiros retorna 403 com a mensagem "Você não tem acesso a esta oportunidade.".

Pipeline restrito a usuários ou papéis

Ao marcar a Visibilidade como Restrita, o pipeline só aparece para o Proprietário e para os usuários/papéis listados em Acessos. Administradores com configurar o CRM continuam enxergando todos os pipelines para fins de gestão. Se um pipeline restrito for salvo sem proprietário e sem acessos, a página de listagem mostra um aviso amarelo: "Restrita sem proprietário nem usuários definidos · apenas administradores com permissão de gestão a verão.".

Sem nenhum pipeline cadastrado

Ao abrir o Kanban sem nenhum pipeline existente, o sistema redireciona para /admin/crm/pipelines/create com a mensagem "Crie um pipeline primeiro para usar o CRM.". O Kanban só funciona após o primeiro pipeline ser criado.

Etapas finais (ganho/perdido)

Marque Etapa final e escolha Tipo final = ganho para sinalizar que oportunidades nessa coluna foram fechadas com sucesso, ou perdido para registrar perda. Essa marcação alimenta os relatórios de conversão e os totais de oportunidades abertas vs. fechadas.

Erros comuns e como resolver

• "Não e possível excluir um pipeline com oportunidades vinculadas." - Causa: o pipeline tem ao menos uma oportunidade associada. Solução: mova as oportunidades para outro pipeline pelo cartão (ação Mover p/ outro funil) ou exclua-as antes de remover o pipeline.
• "Não e possível excluir uma etapa com oportunidades." - Causa: a etapa tem oportunidades vinculadas. Solução: arraste os cartões da etapa para outra coluna no Kanban e tente excluir novamente.
• "Você não tem acesso a esta pipeline." - Causa: o pipeline é restrito e o usuário não está na lista de acessos nem é o proprietário. Solução: peça ao administrador para incluir seu usuário ou papel em Acessos, ou troque a visibilidade para Pública.
• "Você não tem acesso a esta oportunidade." - Causa: vendedor sem ver todas as oportunidades do CRM tentou mover uma oportunidade de outro vendedor. Solução: peça ao administrador a permissão de ver todas as oportunidades do CRM ou solicite que o vendedor responsável faça a movimentação.
• "Crie um pipeline primeiro para usar o CRM." - Causa: nenhum pipeline cadastrado para você. Solução: clique em Novo Pipeline para criar o primeiro funil.

Onde encontrar

• URL: /admin/crm/pipelines (configuração) e /admin/crm/kanban (visualização)
• Caminho no menu: CRM > Kanban (visualização) e CRM > Configurações do CRM > Pipelines (gerenciamento)
• Permissões necessárias: crm.pipeline (Kanban), configurar o CRM (cadastrar/editar pipelines e etapas), crm.oportunidades (mover cartões), ver todas as oportunidades do CRM (mover oportunidades de outros vendedores)
• Módulo necessário: CRM - Gestão de Relacionamento

Veja também

• Oportunidades de Venda - gerencie os cartões que aparecem no Kanban.
• Gerenciar Leads - qualifique potenciais clientes antes de transformá-los em oportunidades no funil.