👤 Para todos os usuários
🔐 Disponível para todos os planos
🎯 Para quem está configurando as fases e o formulário de um pipe pela primeira vez
Você montou as fases do seu pipe, abriu o editor de campos e se deparou com mais de 15 opções. Texto curto, texto longo, seleção de lista, seleção de única opção, data, data de vencimento... qual escolher? Essa dúvida aparece o tempo todo e faz sentido. Não é uma questão de preferência, é uma decisão de arquitetura.
Cada tipo de campo no Pipefy carrega um comportamento diferente: ele define como a informação vai ser inserida, como vai ser validada, se pode ser usada como gatilho de automação e como vai aparecer em relatórios.
Um campo de data de vencimento, por exemplo, ativa automaticamente o indicador de SLA do card. Um campo de seleção única, por outro lado, é o tipo que você vai querer usar para criar condicionais que mostram ou escondem outros campos com base na resposta.
O seu processo já tem uma estrutura. Os campos que você vai configurar agora são os elementos que vão capturar as informações corretas em cada etapa, o que impacta diretamente a qualidade dos dados que você vai usar para tomar decisões depois.
📖 O que você vai entender aqui:
Por que a escolha do tipo de campo importa
No Pipefy, campo não é só um espaço para digitar. É um contrato com o seu processo: você está dizendo qual tipo de informação vai entrar ali, como ela será validada e o que acontece depois que ela existir.
Um campo Numérico só aceita números, sem necessidade de criar uma regra de validação manual. Um campo Email exige formato de endereço válido antes de salvar. Um campo Responsável lista apenas membros do pipe. Isso protege a integridade dos seus dados sem exigir esforço extra de quem preenche.
A segunda implicação é nas automações. Campos de data (Data, Data e Hora, Data de Vencimento) podem ser usados como gatilhos: "quando a data de vencimento passar de hoje, mover o card para a fase Atrasado". Campos de seleção (Checkbox, Seleção Única, Seleção de Lista) funcionam como condicionais: "se o tipo de contrato for PJ, mostrar o campo CNPJ". Texto curto não faz isso.
A terceira implicação é nos relatórios. Campos de Moeda aparecem como valores numéricos nos dashboards. Campos de Data alimentam os gráficos de lead time. Texto Longo não entra em nenhuma agregação: é apenas informação qualitativa.
Escolher o tipo errado não quebra o pipe imediatamente, mas cobra o preço mais tarde: dados inconsistentes, automações que não disparam, relatórios que não somam o que deveriam. O cuidado agora economiza retrabalho depois.
💡 Se você não tem certeza qual campo usar, pergunte: "esse dado vai ser usado em alguma automação ou relatório?" Se sim, fuja do Texto Curto e use o tipo especializado correspondente.
Catálogo completo: os 17 tipos de campo
A tabela abaixo organiza todos os tipos disponíveis com o critério principal de uso e um exemplo aplicado ao template de onboarding de colaboradores.
| Campo | Quando usar | Exemplo no onboarding | Observação |
|---|---|---|---|
| Texto Curto | Dados curtos: nomes, endereços, cargos, IDs | Nome do colaborador, cargo, escritório | Suporta valor único (ver seção abaixo) |
| Texto Longo | Respostas descritivas, briefings, feedbacks | Feedback qualitativo do primeiro mês | Não agregável em dashboards |
| Conteúdo Dinâmico | Exibir informações do próprio card automaticamente | Resumo do onboarding preenchido automaticamente | Não é preenchido pelo usuário |
| Anexo | Upload de documentos, fotos, PDFs, planilhas | Contrato assinado, cronograma de treinamento | Formatos múltiplos aceitos |
| Checkbox | Listas de verificação com múltiplas opções | Checklist do primeiro dia (apresentação, reuniões) | Aceita múltiplas seleções simultaneamente |
| Responsável | Atribuir membros do pipe a um card | Responsável pelo onboarding (buddy) | Só lista membros cadastrados no pipe |
| Data | Calendário: dia, mês e ano | Primeiro dia do colaborador | Sem horário; use Data e Hora se precisar |
| Data e Hora | Calendário com horário | Agendamento de reunião de alinhamento | Suporta valor único |
| Data de Vencimento | Prazo com horário; ativa indicador de SLA | Prazo para concluir onboarding do primeiro mês | Campo-chave para automações de escalonamento |
| Etiquetas | Tags coloridas no topo do card | Urgência, tipo de contrato (CLT/PJ/Estágio) | Visual; não filtrável diretamente em automações |
| | Coleta de endereço de e-mail com validação | E-mail corporativo do novo colaborador | Valida formato automaticamente |
| Número de Telefone | Número com código de país e validação | Telefone do colaborador ou do buddy | Suporta valor único |
| Seleção de Lista | Lista longa com seleção única; exibida ao clicar | Departamento, localização do escritório | Ideal para mais de 5 opções |
| Seleção Única | Opções sempre visíveis lado a lado; seleção única | Regime de trabalho (Presencial/Remoto/Híbrido) | Ideal para até 5 opções; base para condicionais |
| Tempo | Seletor de horário | Horário preferido para reuniões de alinhamento | Sem data; use Data e Hora se precisar das duas |
| Numérico | Valores numéricos sem moeda | Pontuação de desempenho no primeiro mês (1–5) | Suporta valor único |
| Moeda | Valores monetários com seleção de tipo de moeda | Pretensão salarial (em processos de recrutamento) | Aparece como valor agregável em dashboards |
| Documentos | Dados de documentação com validação (CPF, CNH) | CPF ou CNH em processos que exijam identificação | Validação automática do formato do documento |
| ID | Código de identificação único gerado automaticamente | ID do onboarding (#ON-0042) | Não é preenchido manualmente |
| Conexão de Pipe | Vincula o card a um card em outro pipe | Vincular onboarding ao card de recrutamento | Permite autopreenchimento de campos do pipe origem |
| Conexão de Database | Vincula o card a um registro de banco de dados | Buscar dados do colaborador em um database de RH | Cria ou pesquisa registros no database conectado |
Aplicando os campos corretos no template de onboarding
O template de onboarding de colaboradores tem quatro fases (Planejamento, Primeiro Dia, Primeira Semana, Primeiro Mês) mais um formulário inicial. Veja como a escolha de tipos de campo opera na prática:
Formulário inicial
Este é o ponto de entrada, preenchido por RH no momento da abertura do card. Precisa capturar dados que vão se propagar por todas as fases seguintes.
- Nome do colaborador → Texto Curto (com valor único, para evitar duplicar o mesmo onboarding)
- E-mail corporativo → Email (validação automática de formato)
- Tipo de contrato → Seleção Única (CLT / PJ / Estágio, 3 opções sempre visíveis; base para condicionais que mostram campos específicos por tipo de vínculo)
- Regime de trabalho → Seleção Única (Presencial / Remoto / Híbrido; aciona campos de endereço se for remoto)
- Primeiro dia → Data (alimenta o cálculo de SLA da fase Planejamento)
- Departamento → Seleção de Lista (lista longa; ideal para organizações com muitos departamentos)
Fase primeiro mês
Esta fase captura avaliações que vão alimentar relatórios de efetividade do onboarding.
- Desempenho no primeiro mês → Numérico (escala 1-5; somável em dashboards de média)
- Feedback qualitativo → Texto Longo (descritivo; não vai para dashboards, mas é consultável por card)
- Plano de desenvolvimento → Anexo (PDF do plano assinado pelo gestor)
- Prazo de conclusão do onboarding → Data de Vencimento (ativa o indicador visual de prazo e pode disparar automação de escalonamento se vencer sem conclusão)
💡 No template de onboarding, o campo "Estação preparada" (sim/não) pode ser implementado como Seleção Única com duas opções, servindo como gatilho de automação: "se Estação preparada = não na véspera do primeiro dia, enviar alerta para o buddy".
Seleção de lista vs. seleção única: a distinção que mais confunde
Esta é a dúvida mais recorrente entre quem está configurando campos pela primeira vez. Ambos permitem escolher apenas uma opção. A diferença está em como as opções são exibidas e em qual contexto cada um funciona melhor.
| Seleção Única | Seleção de Lista |
|---|---|
| Todas as opções ficam visíveis na tela o tempo todo | As opções aparecem apenas quando o usuário clica no campo |
| Ideal para 2 a 5 opções | Ideal para 6 ou mais opções |
| Ex: Regime de trabalho (Presencial / Remoto / Híbrido) | Ex: Departamento (lista com 15 departamentos) |
| Base recomendada para regras condicionais em campos | Menos indicado para condicionais — use Seleção Única |
| Visual mais limpo em listas curtas | Evita poluição visual em listas longas |
A regra prática: se você vai criar condicionais que dependem da resposta desse campo, use Seleção Única. A interface de configuração de condicionais funciona com os dois tipos, mas Seleção Única torna o formulário mais claro para quem preenche, já que as opções estão todas visíveis sem clique extra.
Campos que ativam automações e o que muda na prática
Nem todo campo pode ser usado como gatilho de automação. Conhecer quais podem muda o nível de sofisticação que você consegue alcançar no processo.
Campos de data como gatilhos temporais
Data de Vencimento é o tipo mais poderoso nesta categoria. Quando configurado em uma fase, ele ativa automaticamente o indicador visual de prazo (cor laranja = próximo de vencer, vermelho = vencido) e pode ser referenciado em automações baseadas em tempo:
- "Quando a Data de Vencimento passar de hoje → mover card para fase Atrasado"
- "3 dias antes da Data de Vencimento → enviar e-mail automático para o Responsável"
O campo Data simples (sem hora, sem vencimento) também pode ser gatilho, mas não ativa o indicador visual de SLA. Use Data quando precisar registrar um marco do processo; use Data de Vencimento quando o campo representa um prazo com consequência.
Campos de seleção como gatilhos de condicionais
Seleção Única e Seleção de Lista podem ser usados em automações do tipo "quando o valor do campo X for Y, executar ação Z". No template de onboarding:
- "Quando Tipo de contrato = PJ → adicionar campo CNPJ na fase de Planejamento" (via condicional)
- "Quando Regime de trabalho = Remoto → notificar TI para preparar acesso remoto" (via automação)
Responsável como referência para notificações
O campo Responsável é o único tipo que armazena um membro do pipe como dado. Isso significa que automações podem usar "enviar e-mail para o Responsável pelo card" de forma dinâmica. Cada card pode ter um responsável diferente e a automação sabe para quem enviar sem precisar de configuração específica por pessoa.
💡 Checkbox é excelente para checklists de tarefas dentro de uma fase (como o "Checklist do primeiro dia"), mas não funciona como gatilho de automação da mesma forma que Seleção Única. Se você precisa disparar uma ação com base na conclusão de um item de checklist, avalie modelar isso como um campo separado de Seleção Única (Concluído / Pendente).
Valores únicos: evitando duplicatas no processo
Alguns tipos de campo permitem ativar a opção "valor único". Quando habilitada, o Pipefy recusa qualquer tentativa de salvar um card com o mesmo valor já existente naquele campo, em qualquer outro card do mesmo pipe.
Tipos que suportam valor único: Texto Curto, Email, Número de Telefone, Documento, Numérico, Moeda, Data e Hora, Data de Vencimento.
No onboarding de colaboradores, o caso mais comum é o campo Email corporativo: ao ativar valor único, você garante que o mesmo e-mail não pode abrir dois onboardings ao mesmo tempo. Se alguém tentar, o Pipefy alerta antes de salvar.
⚠️ Atenção ao ativar valor único em campos que já têm dados: o Pipefy vai aceitar a configuração, mas cards já existentes com valores duplicados não serão afetados retroativamente. A validação passa a valer apenas para novos cards criados após a ativação.
Para ativar: no editor de campos, clique no campo desejado, acione o toggle "Este campo deve ter valor único" e salve.
Dois tipos especiais: Conteúdo Dinâmico e ID
Conteúdo Dinâmico
Este campo não é preenchido pelo usuário. Ele exibe informações já existentes no card (de outros campos) formatadas como texto. Funciona como um campo descritivo inteligente que monta frases automaticamente.
Exemplo prático: em vez de o buddy precisar consultar três campos diferentes para saber quem está em onboarding, você cria um campo dinâmico na fase "Primeiro Dia" com a mensagem: "Onboarding de [Nome do colaborador] | [Departamento] | Início: [Data do primeiro dia]". O campo se preenche automaticamente com os valores dos outros campos.
ID
Gera um código único e sequencial para cada card automaticamente (#001, #002, #003...). Você não define o valor: o Pipefy atribui na criação do card. É útil quando o processo precisa de um número de protocolo ou referência externa.
No onboarding: um campo ID na fase de Planejamento gera um código como #ON-0042 para cada novo colaborador, que pode ser compartilhado com TI e Financeiro para rastrear solicitações associadas.
Checklist: antes de avançar para a próxima etapa
☐ Todos os campos do formulário inicial têm o tipo adequado para o dado que vão coletar
☐ Campos de data que representam prazos usam Data de Vencimento (não Data simples)
☐ Campos que vão virar opções em condicionais usam Seleção Única
☐ Campos que vão virar departamentos ou listas longas usam Seleção de Lista
☐ O campo de e-mail usa o tipo Email (não Texto Curto)
☐ Campos críticos para integridade dos dados (e-mail, CPF) têm valor único ativado
☐ Há pelo menos um campo de Data de Vencimento na fase com prazo mais crítico do processo
FAQ
Qual a diferença entre Data e Data de Vencimento?
Data é um campo calendário simples para registrar qualquer marco do processo (ex: data de admissão). Data de Vencimento também é um calendário, mas ativa o indicador visual de SLA do card (laranja/vermelho) e pode ser usado em automações baseadas em prazo. Se o campo representa um deadline com consequência, use Data de Vencimento.
Posso mudar o tipo de um campo depois de já ter dados nele?
Não. O Pipefy não permite alterar o tipo de um campo existente com dados. A alternativa é criar um novo campo com o tipo correto, migrar os dados manualmente nos cards existentes e depois arquivar ou apagar o campo antigo. Por isso vale a pena planejar os tipos antes de começar a usar o pipe em produção.
Checkbox e Seleção Única parecem fazer a mesma coisa. Qual a diferença?
Checkbox permite marcar várias opções ao mesmo tempo (ex: "quais materiais você precisa: computador, mouse, teclado"). Seleção Única permite escolher apenas uma opção (ex: "qual o regime de trabalho: Presencial, Remoto ou Híbrido"). Se a resposta pode ser múltipla, Checkbox. Se só pode ser uma, Seleção Única.
O campo Conteúdo Dinâmico substitui o Texto Curto para mostrar informações?
Conteúdo Dinâmico é para exibir informações que já existem em outros campos do card, montadas em uma frase. Não é para coletar informação nova: é para contextualizar quem está trabalhando naquele card. Se você precisa que alguém preencha um dado, use Texto Curto. Se você quer mostrar automaticamente um resumo de dados já preenchidos, use Conteúdo Dinâmico.
Quando faz sentido usar Conexão de Pipe vs. Conexão de Database?
Conexão de Pipe é para vincular cards entre dois fluxos ativos (ex: vincular o card de recrutamento ao card de onboarding quando a vaga é preenchida). Conexão de Database é para buscar dados em um repositório estático ou semi-estático (ex: puxar dados de um colaborador de um banco de dados de RH). Se o dado muda frequentemente e tem seu próprio ciclo de vida, use pipe. Se é um registro de referência, use database.
O campo ID pode ser personalizado com um prefixo?
O campo ID gera um número sequencial automático, mas o formato do código (prefixo, quantidade de dígitos) pode ser configurado nas propriedades do campo no editor. Você pode definir um prefixo como "ON-" para os onboardings ficarem com códigos como ON-001, ON-002, e assim por diante.
