Visão geral
A versão v0.2.0 do Pipefy Connector traz retorno modular para as ações de busca e consulta de cards e registros. Agora você define, campo a campo, o que cada ação traz de volta. Payloads menores, execuções mais rápidas e etapas seguintes mais limpas no seu flow.
O que há de novo?
- Seleção de campos de retorno para cards, disponível em Get card by id, Get cards by field value, Get cards by phase e Get cards by title. As seções que você pode marcar ou desmarcar são: Card Information, Phases History, Attachments, Comments, Inbox Emails, Assignees, Created By, Parent Relations e Child Relations. Os campos `id`, `fields` e `pipe` são sempre retornados.
- Seleção de campos de retorno para registros, disponível em Get record by id e Get records by filter. As seções disponíveis são: Record Information, Status, Assignees, Parent Relations e Created By. Os campos `id`, `fields` e `database` são sempre retornados.
Em todas as ações, cada seção vem marcada por padrão. Desmarque o que não precisar, ou limpe uma seção inteira, para reduzir a resposta. Se você não mexer em nada, continua recebendo o payload completo.
Como isso ajuda?
- Flows mais rápidos e leves: ao trazer só os campos que a etapa seguinte usa, o payload encolhe e a execução consome menos memória, diferença real em flows grandes que rodam perto dos limites de memória e tempo.
- Etapas seguintes mais limpas: com menos dados irrelevantes trafegando, o mapeamento de campos nas ações posteriores fica mais direto e fácil de manter.
- Controle campo a campo: você decide o escopo de cada consulta de forma independente, sem tratar toda ação de busca da mesma maneira.
Casos de uso
Sincronização de cards para um data warehouse externo
Um flow noturno usa Get cards by phase para exportar cards da fase de faturamento para um BI externo. Antes de v0.2.0, cada card vinha com histórico de fases, comentários e e-mails de inbox que o destino nunca consumia. Marcando apenas Card Information e Assignees, o flow passa a trafegar uma fração do volume, roda dentro da janela noturna sem estourar o limite de tempo e entrega ao BI exatamente o schema esperado, sem etapas de limpeza depois.
Mais relevante para
- Builders de integrações no Pipefy Integrations
- Times de Operações que mantêm flows de alto volume
- Pipe Admins responsáveis por sincronização de dados
- Times de dados e BI que consomem cards e registros do Pipefy
Planos e disponibilidade
Esta atualização não é aplicada automaticamente e é opcional. Para receber as mudanças, atualize a versão do conector manualmente seguindo o passo a passo do vídeo incluído nesta publicação. Depois de atualizar, será necessário reconectar sua Service Account, sua organização e seu Pipe. Ao atualizar uma etapa já existente para esta versão, os campos que você já havia preenchido serão limpos e precisarão ser preenchidos novamente.
