Skip to main content
Esta página lista os tipos de campo, as configurações de cada campo e a lógica condicional. Você cria formulários em Ajustes → Formulários. Eles existem por conta própria, e você os anexa a lugares depois. Ver Formulários dinâmicos.

​
Os tipos de campo

O campo Texto com formatação está em beta e aparece marcado como tal na tela de criação.
Para os três, as opções são cadastradas no próprio campo, uma por linha.
Seleção de lista e Seleção de única se comportam igual e mudam só na interface. A primeira funciona melhor com muitas opções. A segunda, com poucas, porque mostra todas de uma vez.
Use a matriz para avaliar vários itens pelos mesmos critérios. Numa escala Likert, por exemplo, as linhas são as afirmações e uma coluna do tipo Seleção de única traz a escala.Cada coluna tem o seu próprio tipo, entre os de texto, número, moeda, data, hora, e-mail, telefone, link e os três de escolha. Uma coluna pode ser obrigatória por conta própria, independentemente das outras.Um campo de matriz não pode ser o campo que decide em uma condicional, porque a resposta dele é uma grade inteira, não um valor comparável. Ele pode, sim, ser mostrado ou escondido por condicional de outro campo.
O tipo de uma coluna que já existe não pode ser trocado depois. Para mudar, remova a coluna e crie outra — lembrando que remover descarta o que já foi respondido nela.
Campos de data podem alimentar o gatilho Data de projeto atingida.
Estes tipos guardam o vínculo com o registro, e não um texto solto. É o que permite navegar do formulário para o cadastro e usar a resposta em filtros.
Arquivos anexados em campo de formulário aparecem também no botão Arquivos do cartão. Ver Conteúdo do projeto.

​
As configurações de cada campo

Cada campo tem as configurações abaixo. Algumas valem só para certos tipos, indicados em seguida. Múltiplas respostas está disponível para Anexo(s), Contato, Cliente, Projeto, Usuário e Link.

​
Validação Regex

Disponível para Texto curto, Texto longo, Email, Número de telefone, Moeda e Numérico. Nos campos de texto, além de escrever a própria expressão, existem máscaras prontas: CPF, CNPJ, Apenas letras, CEP, Placa Mercosul e RG.
A validação de regex e a obrigatoriedade não são aplicadas no servidor para campos que têm condicional configurada — nesses casos a verificação acontece apenas na interface. Se a integridade do dado for crítica, prefira validar também no consumo, ou evite condicional em campos que dependem de máscara.

​
Lógica condicional

A condicional é o que transforma um formulário em árvore de decisão: o campo aparece ou some conforme o que foi respondido antes.
1

Escolha a ação

Mostrar ou Esconder o campo.
2

Escolha o campo que decide

Qual resposta anterior será avaliada.
3

Escolha o operador e o valor

Igual a · Diferente de · Contém · Não contém · Começa com · Termina com · Maior que · Menor que · Maior ou igual a · Menor ou igual a · Está vazio · Não está vazio
Encadeando condicionais, o formulário vai se abrindo: a pessoa preenche o primeiro campo, aparece o segundo; preenche o segundo, aparece o terceiro.
Uma árvore de decisão bem montada substitui vários formulários diferentes. Em vez de um formulário por tipo de pedido, um único formulário cujo primeiro campo é o tipo — e o resto se ajusta.

​
Condicional e obrigatoriedade

Um campo obrigatório que está oculto por condicional não é cobrado. A plataforma avalia apenas os campos que de fato estão aparecendo para quem preenche. Ver Checklists e formulários obrigatórios.

​
O campo oculto como decisão de administrador

A condicional também serve para o contrário do que parece: esconder um campo de quase todo mundo. Pense num campo visível apenas para quem administra, cuja resposta dispara uma automação. Com ele, essa pessoa pode corrigir uma rota, como mover um projeto que a restrição não deixa voltar. E ela faz isso sem ganhar permissão para furar as regras do funil. Ver Padrões de desenho.

​
Limites dos campos de texto

A interface limita o tamanho destes campos:

​
Depois de criar

Um formulário recém-criado ainda não coleta nada — ele precisa ser anexado a um lugar:

Em um objeto

Ajustes → Formulários → Formulário dos objetos, para valer em todos os registros daquele tipo.

Em um funil ou etapa

Na edição do funil, no campo Formulário dinâmico ou no formulário da etapa.

Em um projeto específico

Como formulário avulso, manualmente ou por automação.

Publicado

Como link público ou como solicitação.
A tela Formulário dos objetos lista cinco objetos, mas apenas Projeto, Cliente, Contato e Usuário aceitam formulário hoje. Squad aparece na lista sem suporte correspondente.

​
Próximos passos

Formulários dinâmicos

Onde anexar e como escolher o nível certo.

Formulário avulso, versões e contador

Exceções, ciclos recorrentes e medição de retrabalho.

Criar e editar formulários pela API

A mesma estrutura em JSON, com os nomes literais de cada tipo.