Como referenciar campos de um pipeline em um formulário web

Referenciar campos personalizados de um pipeline em um formulário web permite coletar informações específicas diretamente no fluxo de requisições. Veja como criar e associar esses campos ao seu formulário.

1º Passo: Acessando o pipeline e abrindo a configuração de campos

1. No menu lateral esquerdo, clique em “Pipelines” para abrir a lista de pipelines.




2. Selecione o pipeline onde deseja adicionar o campo personalizado.




3. Clique em “Configurações de Módulo” representado pelo ícone “(...)” no canto superior direito da tela.

4. Na janela modal, clique na aba “Campos”
   

2º Passo: Criando um campo personalizado

1. Clique em “Adicionar campo personalizado”.

2. No modal de criação, preencha as informações:

   • Label: nome/rótulo do campo (ex.: Categoria).

   • Tipo: selecione o tipo de dado (Texto, Número, Data, Lista Suspensa etc.).

   • Layout: “Único” ou “Duplo” para definir a largura.

   • Placeholder (opcional): texto de exemplo dentro do campo.

   • Máscara (opcional): formato para preenchimento automático.

   • O Campo é Obrigatório? (opcional): ative se for obrigatório.

   • O Campo é Somente leitura? (opcional): ative se for apenas para visualização.

3. (Opcional) Na aba “Visibilidade”, configure regras para definir quando o campo será exibido.

4. Clique em “Criar Campo” para finalizar.

3º Passo: Associando o campo personalizado ao formulário web

1. Acesse “Configurações > Formulários Web” no menu lateral.

2. Localize o formulário desejado e clique nele.

3. Na janela modal, clique na aba “Campos”.

4. Clique em “Adicionar campo personalizado” e selecione “Associar com o Campo do Pipeline”.

5. Ajuste a ordem dos campos arrastando-os para a posição desejada. As alterações são salvas automaticamente.

4º Passo: Publicando e testando o formulário

1. Na lista de Formulários Web, clique no formulário e depois em “Abrir” para visualizá-lo em nova guia.

2. Copie a URL e abra em modo anônimo para testar.

3. Verifique se o campo personalizado aparece e funciona conforme configurado (opções corretas, placeholder, obrigatoriedade).

4. Preencha e envie o formulário.

5. No octapipe, confirme que o card criado no pipeline contém o valor informado no campo personalizado.

Boas práticas:

• Padronize nomes dos campos para facilitar manutenção.

• Teste em modo anônimo para validar visibilidade.

• Reveja regras de visibilidade para garantir que refletem o cenário correto.

• Documente cada campo personalizado com propósito e regras.

• Evite duplicidade verificando se o campo já existe antes de criar.

• Atualize fluxos relacionados quando alterar ou remover campos.
  
  

Conclusão:

Você aprendeu a criar um campo personalizado no pipeline e referenciá-lo em um formulário web, garantindo que as informações sejam capturadas e integradas ao fluxo de trabalho. Em caso de dúvidas, entre em contato com nosso suporte.