O Pipeline é um Kanban em tempo real que mostra todos os seus contatos organizados por etapa do funil de vendas. Cada coluna representa uma etapa configurada no Funil Inteligente — do primeiro contato até o fechamento ou descarte — e cada card é um contato com resumo de conversa, canal de origem e dados de atendimento. Você arrasta contatos entre etapas, filtra por status/canal/atendente e acompanha a saúde geral do seu funil de forma visual e prática.
Disponível em: todos os planos.
Quem pode fazer: qualquer usuário com acesso ao módulo Funis.
Módulo: Menu lateral > Funis
O que você precisa antes de começar
Ter ao menos um Funil Inteligente criado com etapas configuradas
O Funil Inteligente deve estar ativo para aparecer no Pipeline
Ter contatos vinculados ao Funil Inteligente para visualizá-los no Kanban
Para saber como criar um Funil Inteligente, consulte Como criar o primeiro Funil Inteligente.
Conceitos fundamentais
Conceito
| O que é
| Detalhes
|
Pipeline / Funis
| Kanban em tempo real do funil de vendas
| Visa contatos organizados por etapa — é a visão de vendas central
|
Etapas (Steps)
| Colunas do Kanban
| Configuradas no Funil Inteligente. Tipos: Entrada (INITIAL), Principal (DEFAULT), Sucesso (SUCCESS), Descarte (CLOSED)
|
Card de contato
| Unidade do Kanban
| Exibe nome, identificador (telefone/email), channel, snippet de conversa, status, atendente e data — tudo configurável
|
Movimento entre etapas
| Drag and drop
| Alterar a etapa de um contato arrasta-o para a nova coluna. Gera evento de rastreamento (trackContactStageChanged)
|
Status da conversa
| Estado do contato
| OPEN (aberta) ou RESOLVED (resolvida) — mostrado no card
|
Paginação
| Carregamento de cards
| 20 itens por página. Use "Carregar mais" na base de cada coluna
|
Acessar o Pipeline
No menu lateral, clique em Funis
A página abre em Funis (Pipeline Kanban)
Você verá todas as etapas configuradas do seu Funil Inteligente como colunas
💡 Dica: O título da página é "Funis" e o subtítulo diz "Gerencie seus contatos e acompanhe o funil de vendas". Este é seu ponto central de visão de pipeline.
Selecionar um Funil Inteligente
Se você tem mais de um Funil Inteligente:
Localize o dropdown de seleção de funil na barra superior (ao lado do search)
Clique para abrir a lista de Funis Inteligentes ativos
Selecione o Funil desejado
O Pipeline recarrega com as etapas e contatos daquele Funil
Apenas um Funil Inteligente é exibido por vez. Quando você muda de Funil, todas as colunas, filtros e dados mostrados se atualizam para refletir a estrutura do novo Funil.
Entender o Kanban
Estrutura das colunas
O Kanban exibe as etapas do seu Funil Inteligente como colunas. Cada coluna tem:
Cabeçalho — nome da etapa + badge com contagem de contatos (ex: "Entrada (12)")
Botão Minimizar — recolhe a coluna para economizar espaço na tela (não remove dados)
Cards de contato — cada card é um contato naquela etapa
Botão "Carregar mais" — aparece na base se houver mais de 20 contatos na etapa
Tipos de etapa e cor/ícone
As etapas são classificadas conforme configurado no Funil Inteligente:
Tipo
| Código
| Significado
|
Entrada
| INITIAL
| Primeiras interações — contatos que acabaram de chegar
|
Principal
| DEFAULT
| Etapas intermediárias de qualificação e acompanhamento
|
Sucesso
| SUCCESS
| Conversão realizada — lead → oportunidade ou fechamento
|
Descarte
| CLOSED
| Leads descartados ou perdidos
|
Anatomia de um card de contato
Cada card exibe:
Nome do contato — campo de identificação principal
Identificador (telefone ou email) — toggle na barra superior para mostrar/ocultar
Ícone de canal — WhatsApp, LinkedIn, Email (mostra qual canal originou o contato)
Snippet de conversa — resumo da última mensagem (automático)
Status chips — tags indicando estado (ex: "Resolvida", "Em Follow-up", "Em Campanha")
Atendente (toggle) — quem está responsável (IA ou nome do humano)
Data de última atividade (toggle) — quando foi o último contato
Link para conversa — ícone de seta (abrir em Conversas)
Toggles de visibilidade
Na barra superior, você encontra quatro toggles (ícone de olho):
Identificador — mostra/oculta telefone ou email do contato
Atendimento — mostra/oculta o nome da IA ou atendente responsável
Data — mostra/oculta a timestamp da última atividade
Estado — mostra/oculta o status da conversa (Aberta/Resolvida)
Alternar esses toggles não deleta dados — apenas muda o que é exibido visualmente nos cards.
Mover contatos entre etapas
Fazer o drag and drop
Clique e segure no card do contato
Arraste para a coluna da etapa de destino
Solte o card
O sistema processa a mudança
Feedback visual
Toast de sucesso: "Contato movido para '[nome_da_etapa]' com sucesso!" — a mudança foi salva
Toast de erro: "Este contato não possui conversa para ser movido" — o contato não pode ser movido (verifique se tem conversa associada)
Quando você pode mover um contato
O drag and drop só funciona se o contato possui uma conversa associada. Contatos sem conversa geram erro ao tentar mover.
⚠️ Importante: Mover um contato de etapa gera um evento de rastreamento (trackContactStageChanged) que alimenta análises e histórico do funil. Essa ação é irreversível — planeje bem a estrutura das suas etapas.
Filtrar o Pipeline
A barra superior contém um ícone de Filtros (sliders). Clique para abrir o painel de filtros lateral.
Filtros disponíveis
Filtro
| Opções
| Comportamento
|
Status
| "Todas", "Abertas" (OPEN), "Resolvidas" (RESOLVED)
| Filtra contatos por status da conversa
|
Canal
| "Todos", "WhatsApp", "LinkedIn", "Email"
| Mostra apenas contatos originários de um canal
|
Atendente
| "Todos", "AI Agent", "Humano"
| Filtra por tipo de responsável (IA autônoma ou atendente humano)
|
Intervalo de datas
| Date range picker
| Filtra por data de última atividade — permite seleção customizada
|
Aplicar e limpar filtros
Selecione as opções desejadas nos filtros
Clique em Aplicar para atualizar o Kanban
Para voltar ao estado sem filtros, clique em Limpar
Os filtros são cumulativos (AND) — ao selecioná-los, o resultado mostra contatos que satisfazem todos os critérios simultâneamente.
💡 Dica: Use filtros para focar em ações específicas — ex: filtrar "Abertas + Humano + WhatsApp" para encontrar conversas em espera para você responder.
Personalizar a visibilidade de colunas
Ocultar uma coluna
Cada coluna possui um botão Minimizar no cabeçalho. Clique para recolher a coluna — ela fica invisível mas os dados não são perdidos.
Mostrar colunas ocultas
Quando há colunas minimizadas, um controle de visibilidade de colunas aparece (geralmente um ícone de "olho" em X colunas ocultas). Clique para expandir a lista de colunas minimizadas e clique novamente no botão de cada uma para restaurá-la.
Abrir uma conversa a partir do card
Localize o card do contato no Kanban
Clique no ícone de seta (abrir em nova aba) no canto superior direito do card
Você é redirecionado para o módulo Conversas com o detalhamento completo da interação
Na tela de Conversas, você pode responder mensagens, visualizar histórico completo e transferir para outro atendente
💡 Dica: Abrir a conversa é útil para qualificar o contato ou responder a perguntas antes de mover para a próxima etapa.
Limites e regras
Limite
| Valor
|
Contatos por página (paginação)
| 20 itens — use "Carregar mais" para ver próximos 20
|
Tipos de etapa configuráveis
| 4 tipos: INITIAL, DEFAULT, SUCCESS, CLOSED
|
Funis simultâneos no Pipeline
| Apenas 1 Funil Inteligente por vez (use o dropdown para trocar)
|
Drag and drop válido
| Apenas contatos COM conversa associada podem ser movidos
|
Atualização em tempo real
| Cards refletem mudanças imediatas; etapas atualizam a cada segundos
|
Histórico de movimento
| Cada mudança de etapa gera evento de rastreamento (não é exibido no Pipeline, mas fica em logs)
|
Erros comuns e soluções
Problema
| Causa provável
| Solução
|
Nenhum card exibido no Kanban
| Nenhum contato vinculado ao Funil ou filtro muito restritivo
| Verifique se há contatos no Funil; limpe os filtros usando Limpar
|
"Este contato não possui conversa para ser movido"
| Contato existe mas não tem conversa iniciada
| Inicie uma conversa com o contato (via WhatsApp, LinkedIn, etc.) e tente mover novamente
|
Coluna vazia após mover todos os contatos
| Comportamento normal — etapas podem ficar vazias
| Contatos podem ser movidos para outras etapas a qualquer momento; não há mínimo obrigatório
|
Dropdown de Funil não exibe opções
| Nenhum Funil Inteligente ativo criado
| Acesse o módulo Funis Inteligentes e crie ao menos um Funil ativo
|
Filtros não funcionam
| Critério selecionado não tem dados correspondentes
| Limpe filtros e aplique um por um para isolar o problema
|
Botão "Carregar mais" não aparece
| Etapa tem 20 contatos ou menos
| Comportamento normal; todas as conversas estão carregadas
|
Card mostra informação desatualizada
| Cache ou sincronização lenta
| Recarregue a página (F5) para forçar sincronização
|
Perguntas frequentes
Posso criar etapas diretamente no Pipeline?
Não. As etapas são configuradas no módulo Funis Inteligentes (não no Pipeline). O Pipeline apenas exibe as etapas já criadas no Funil. Para adicionar ou editar etapas, acesse Menu lateral > Funis Inteligentes, selecione o Funil desejado e edite as etapas na aba Configuração.
Como adicionar um contato ao Pipeline?
Contatos chegam ao Pipeline quando: (1) são criados manualmente na base e vinculados ao Funil, (2) responderam a uma campanha no WhatsApp, ou (3) chegam via integração com CRM (webhook ou sincronização). O Pipeline não é um formulário de entrada — é um reflexo do seu funil de vendas. Para adicionar contatos, use o módulo Listas ou Campanhas.
O que acontece quando movo um contato para a etapa de sucesso?
Mover para uma etapa de sucesso (tipo SUCCESS) é um marco — o sistema registra a ação e a conversa pode ser marcada como Resolvida. Isso não fecha automaticamente o contato nem impede que você o mova novamente se precisar. A etapa de sucesso é apenas uma classificação visual e analítica.
Posso mover múltiplos contatos de uma vez?
Não. O Pipeline exibe drag and drop para um card por vez. Para mover em lote, você precisará: (1) usar Filtros para isolar um grupo e (2) mover individualmente, ou (2) automatizar via Funil Inteligente (usando regras de transição automática, se disponível na sua versão).
Qual é a diferença entre "Resolvida" e "Descarte"?
Resolvida é um status de conversa (a conversa foi encerrada). Descarte é um tipo de etapa (uma classificação do funil). Um contato pode ter conversa Resolvida mas estar em uma etapa Principal ou Sucesso. Use o filtro de Status para conversas e a estrutura de etapas para pipeline.
Se eu minimizar uma coluna, os contatos nela são deletados?
Não. Minimizar apenas oculta a coluna visualmente. Os contatos continuam existindo e as conversas estão intactas. Clique no ícone de visibilidade para restaurar a coluna quando quiser.
Como garantir que nenhum lead fica parado no pipeline?
Use a coluna Data de última atividade (ative o toggle) para identificar contatos inativos. Combine com Filtros de Data para encontrar leads parados há X dias. O ideal é fazer follow-up automático via Campanha ou agendamento de Tarefas (veja Como criar e gerenciar tarefas).
Posso exportar o Pipeline para Excel ou PDF?
Não diretamente do Pipeline. Para exportar dados, use o módulo Painéis (Dashboard) que tem opção de exportação em PDF com gráficos de funil. Alternativamente, exporte contatos da Listas como CSV e filtre por Funil.
Como o Pipeline se conecta ao meu CRM (HubSpot, Salesforce, etc.)?
O Pipeline é a visão nativa da Nuvia. Para sincronizar com CRM externo, use as Integrações (Menu > Plataforma > Integrações). Cada integração tem suas próprias regras de sincronização — contatos podem ser pushados para o CRM quando mudam de etapa no Pipeline.
Posso configurar alertas para contatos que ficam muito tempo em uma etapa?
Não é um recurso nativo do Pipeline atual. A recomendação é usar o módulo Tarefas para criar alertas manuais (ex: "Acompanhar lead X") vinculado a contatos específicos, ou usar o Dashboard para monitorar tempo médio por etapa.
