Skip to main content

Como configurar e usar o Pipeline

Updated today

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

  1. No menu lateral, clique em Funis

  2. A página abre em Funis (Pipeline Kanban)

  3. 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:

  1. Localize o dropdown de seleção de funil na barra superior (ao lado do search)

  2. Clique para abrir a lista de Funis Inteligentes ativos

  3. Selecione o Funil desejado

  4. 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):

  1. Identificador — mostra/oculta telefone ou email do contato

  2. Atendimento — mostra/oculta o nome da IA ou atendente responsável

  3. Data — mostra/oculta a timestamp da última atividade

  4. 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

  1. Clique e segure no card do contato

  2. Arraste para a coluna da etapa de destino

  3. Solte o card

  4. 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

  1. Selecione as opções desejadas nos filtros

  2. Clique em Aplicar para atualizar o Kanban

  3. 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

  1. Localize o card do contato no Kanban

  2. Clique no ícone de seta (abrir em nova aba) no canto superior direito do card

  3. Você é redirecionado para o módulo Conversas com o detalhamento completo da interação

  4. 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.

Did this answer your question?