Gerenciar Pipelines e Estágios
Somente administradores
As operações desta página (criar, editar, excluir pipelines e estágios) só estão disponíveis para usuários com perfil admin. Agentes veem o board mas não conseguem alterar a estrutura.
O que é um Pipeline
Um pipeline é um funil de vendas com seus próprios estágios. Você pode ter vários pipelines para diferentes produtos ou equipes (ex.: "Vendas B2B", "Assinaturas"). A tela do board exibe um seletor no topo quando há mais de um pipeline cadastrado.
Campos de um Pipeline
| Campo | Descrição |
|---|---|
| Nome | Identificação do pipeline (ex.: "Principal", "Renovação"). |
Padrão (isDefault) | Apenas um pipeline pode ser o padrão. É ele que aparece primeiro ao abrir /pipeline e que recebe deals criados automaticamente a partir de tickets. |
Criar deal automaticamente ao fechar ticket (autoCreateFromTicket) | Quando ativado, o sistema cria um deal neste pipeline sempre que um ticket for fechado como "finalizado com venda". Funciona apenas no pipeline padrão. Ver Pipeline a partir de Ticket. |
O que é um Estágio
Cada pipeline tem uma lista de estágios que formam as colunas do board. Os estágios são ordenados pela posição (campo position).
Campos de um Estágio
| Campo | Descrição |
|---|---|
| Nome | Rótulo da coluna no board (ex.: "Prospecção", "Proposta Enviada", "Fechado"). |
| Cor | Cor da bolinha no cabeçalho da coluna. Padrão: #4CAF50 (verde). |
Estágio final (isFinal) | Marca a coluna como destino de fechamento. A coluna fica recolhida por padrão e não aceita arrasto — deals só chegam aqui via botão "Ganho" ou "Perdido". |
Estágio de perda (isLost) | Indica que deals neste estágio representam oportunidades perdidas. Usado em conjunto com isFinal. |
Estrutura recomendada
Uma estrutura típica de pipeline para PME:
- Prospecção
- Contato Inicial
- Proposta
- Negociação
- Ganho (estágio final)
- Perdido (estágio final + perda)
Reordenar Estágios
A ordem das colunas no board segue o campo position de cada estágio. A API aceita um endpoint de reordenação (PATCH /pipelines/:pipelineId/stages/reorder) com a lista de IDs na nova ordem. A interface de reordenação é gerenciada pelo admin via configurações.
Boas práticas
- Mantenha entre 4 e 8 estágios por pipeline. Mais que isso torna o board difícil de usar.
- Sempre marque pelo menos um estágio como final + ganho e um como final + perdido. Isso garante que os botões "Ganho" e "Perdido" funcionem corretamente.
- Escolha cores distintas para cada estágio para facilitar a leitura visual do board.
- Não exclua um estágio que contenha deals abertos — mova os deals antes.
Exclusão de pipeline
Excluir um pipeline remove todos os seus estágios. Certifique-se de que nenhum deal ativo está associado a ele antes de excluir.