Skip to main content
Question

Como fazer o Pipefy identificar automaticamente o cliente pelo CPF no Start Form?

  • December 8, 2025
  • 1 reply
  • 35 views

luisa-digitalingressos

Oi, pessoal! Tudo bem?

Tenho um pipe chamado Cadastro de Clientes, onde já mantenho todos os dados dos meus clientes (PF e PJ). Agora quero criar um Start Form público para que eles abram solicitações — mas quero deixar o processo o mais simples possível.

A ideia é que, no Start Form, o cliente digite apenas o CPF, e o Pipefy reconheça automaticamente quem é essa pessoa usando o cadastro que já existe no outro pipe. Depois disso, o card da solicitação já deve ficar conectado ao cliente certo, sem o cliente precisar procurar nada.

O ponto é:
eu não posso usar um campo de conexão no Start Form, porque isso mostraria a lista inteira de clientes para quem está preenchendo — o que não pode acontecer.

Então minha dúvida é:
👉 Qual é a melhor forma de fazer o Pipefy identificar automaticamente um cliente pelo CPF e conectar o card ao cadastro dele sem expor a database?
Não sei se uso IA, automação ou outro recurso, então qualquer sugestão já ajuda muito.

Obrigada! 🙏✨

1 reply

joao-quint
Pipefy Staff
Forum|alt.badge.img+6
  • Pipefy Staff
  • February 27, 2026

Oi ​@luisa-digitalingressos 

Hoje o Pipefy não possui um recurso nativo no Start Form que faça a identificação automática de um cliente pelo CPF e conecte o card a um registro existente sem expor a lista da database. Campos de conexão em formulários públicos sempre exibem os registros disponíveis, o que inviabiliza esse uso por questões de privacidade.

O padrão atual funciona assim: o Start Form apenas cria o card com os dados preenchidos, e qualquer lógica de identificação ou vínculo precisa acontecer após a criação do card.

Abordagem técnica recomendada (mais usada em cenários como o seu)

A forma mais segura e escalável de resolver isso é:

  1. No Start Form, coletar o CPF em um campo de texto (ou CPF).

  2. Após a criação do card, executar uma automação ou integração que:

    • Consulte a sua base de clientes (Database ou outro Pipe) buscando o registro pelo CPF.

    • Conecte automaticamente o card recém-criado ao cliente correto.

Isso pode ser feito via:

  • Integração externa usando a API do Pipefy: consultando registros por campo (CPF) e atualizando o campo de conexão do card via mutation. A documentação oficial da API de campos e registros está em https://developers.pipefy.com/reference/fields.

  • Ferramentas de automação: usando webhooks do Pipefy para buscar o cliente pelo CPF e atualizar o card sem nenhuma interação do usuário final.

  • Agente de IA do Pipefy:  em cenários mais avançados, para interpretar o CPF, consultar a database e decidir automaticamente qual registro deve ser conectado (especialmente útil se houver regras adicionais além do CPF).

Esse padrão evita totalmente a exposição da base no formulário público e mantém o processo simples para o cliente final.