👤 Para todos os usuários
🔐 Disponível para todos os planos
🎯 Para quem já criou um pipe e quer garantir que está configurado certo
Criar o pipe é o primeiro passo. Configurá-lo é o que determina se ele vai funcionar para um time de duas pessoas ou para trinta, se os dados certos aparecem no lugar certo e se o processo fica protegido de edições que ninguém pediu.
A maioria dos problemas de adoção que aparecem semanas depois do lançamento de um pipe tem raiz nas configurações puladas na pressa de começar: nomes genéricos que confundem o time, visibilidade aberta demais ou fechada demais, cards que não mostram a informação certa no kanban.
Este artigo cobre as decisões de configuração que têm impacto real na operação. Você sai daqui sabendo o que ajustar e por quê.
📖 O que você vai decidir aqui:
Primeiro: um pipe ou mais de um?
Antes de configurar qualquer propriedade, vale responder a pergunta que mais impacta a saúde do processo a longo prazo: esse fluxo cabe em um único pipe ou precisa ser dividido?
O consenso de quem constrói processos profissionalmente no Pipefy é manter entre 10 e 15 fases por pipe. Acima de 10, já vale avaliar a divisão. Acima de 15, o pipe está exótico e a manutenção começa a ser problemática.
Mas o número de fases é só um dos critérios. A tabela abaixo mostra quando faz sentido manter tudo em um pipe e quando a divisão é necessária:
| Continue no mesmo pipe | Crie um pipe separado |
| O processo tem escopo único do início ao fim | O escopo muda no meio do fluxo (ex: pedido vira cotação) |
| O mesmo time opera todas as fases | Times diferentes precisam de permissões distintas |
| Menos de 10 fases | Mais de 10 fases: avalie quebrar |
| Relação 1 para 1 entre o card e a demanda | Uma demanda gera múltiplos registros filhos (relação 1 para N) |
Um erro comum é criar pipes de gestão vazios só para dar visibilidade gerencial. A prática recomendada é usar Interfaces do Pipefy para fornecer visão consolidada de múltiplos pipes sem criar estruturas paralelas que precisam ser mantidas.
Cores de fase: sistema de leitura, não decoração
Cor de fase é um recurso de governança visual. Usado com critério, permite que qualquer pessoa olhe para o kanban e entenda quem é responsável por cada etapa sem precisar abrir um card.
A lógica recomendada: use a mesma cor para fases que pertencem ao mesmo agente ou equipe. Fases de aprovação, todas na mesma cor. Fases de execução pelo time de TI, todas em outra cor. Fases de responsabilidade do solicitante, em uma terceira.
Exemplo no onboarding de colaboradores:
Azul: fases sob responsabilidade do RH (Documentação pendente, Documentação em análise).
Laranja: fases sob responsabilidade de TI (Equipamentos solicitados, Acessos em configuração).
Verde: fase de conclusão (Concluído).
Um gestor olha para o kanban e sabe imediatamente em qual equipe está cada demanda, sem abrir um card.
Ícone e nome do pipe. Workspaces com vários pipes precisam de diferenciação visual rápida. Use cores distintas entre pipes de áreas diferentes e ícones que tornam o reconhecimento imediato, sem precisar ler o nome completo.
Nome dos cards. O Pipefy chama os itens do processo de "cards" por padrão. Renomear para "Solicitação", "Candidato" ou "Chamado" reduz fricção para o time operacional: o botão de criação e os textos da interface refletem o vocabulário do processo.
Condicional de ocultar por fase: proteção de manutenção
Uma boa prática pouco conhecida, mas muito valorizada por quem mantém processos complexos: use uma condicional única por fase para ocultar todos os campos e mostrar apenas os necessários para aquela etapa.
O motivo não é estético. É operacional: sem essa condicional de referência, a ordem em que as condicionais são avaliadas pode gerar conflitos de latência. Com ela, quem precisar fazer manutenção no processo no futuro, mesmo sem conhecer a lógica original, consegue entender o que está sendo exibido em cada fase sem ter que analisar dezenas de regras isoladas.
Nunca duplique campos copiando um existente. Clonar um campo gera um novo ID de forma imprevisível, o que quebra automações e filtros que referenciam o campo original. Se precisar de um campo semelhante, crie do zero com nome pensado no ID que será gerado.
Sobre nomes de campo: não numere os campos ("1. Nome", "2. Cargo"). Se a ordem mudar, os números ficam defasados e o time começa a ignorar a numeração. Use nomes descritivos que fazem sentido independentemente da posição.
Visibilidade e segurança: configurações que não devem ficar para depois
Três configurações de segurança devem ser ativadas antes de lançar qualquer pipe para o time. São decisões que ficam mais difíceis de corrigir depois que o processo está em produção com dados reais:
- Pipe privado como padrão. Um pipe público aparece para todos os membros da empresa e pode ser acessado por qualquer um. Comece privado e adicione membros com critério. É mais fácil abrir acesso do que restringir depois.
- Exclusão de cards restrita a administradores. Um card deletado por engano não tem recuperação nativa. Restringir exclusão a admins desde o início evita perda de dados por erro operacional.
- Edição restrita ao responsável pelo card. O Pipefy tem uma configuração nas opções do pipe que permite restringir a edição de campos ao responsável designado pelo card. Para processos com múltiplos membros, essa restrição reduz edições fora do fluxo esperado e mantém a integridade dos dados.
Visibilidade e permissões são decisões separadas. Mudar o pipe de público para privado não remove automaticamente quem já tem acesso. Verifique a lista de membros depois de fazer a mudança.
O que configurar agora e o que pode esperar
Configure antes de lançar:
- Decisão de arquitetura: um pipe ou múltiplos (escopo, equipes, número de fases)
- Cor de cada fase por responsabilidade
- Ícone e nome do pipe; nome dos cards
- Visibilidade: privado
- Segurança: exclusão restrita a admins, edição restrita ao responsável
Pode esperar até o pipe estar em uso:
- Condicional de ocultar por fase (configure depois que todos os campos estiverem criados)
- Funções personalizadas (só crie se as funções padrão não atenderem após uso real)
- Clone do pipe para replicar em outras equipes
Antes de lançar para o time, confirme:
☐ O escopo do processo cabe em um único pipe
☐ Cada fase tem uma cor que representa seu agente responsável
☐ Pipe está configurado como privado
☐ Exclusão de cards restrita a administradores
☐ Edição de campos restrita ao responsável pelo card
☐ Nome dos cards usa o vocabulário do processo, não o padrão genérico
