Olá pessoal,
Queria compartilhar uma experiência curiosa que tive ao tentar automatizar o preenchimento de endereço a partir de um CEP dentro do Pipefy, utilizando a API pública do ViaCEP.
A ideia inicial era fazer tudo 100% dentro das automações do Pipefy, usando a ação “Make an HTTP request” e depois o gatilho “When an HTTP response is received” para atualizar os campos do card.
A configuração seguiu exatamente o que aparece em exemplos da comunidade:
Method: GET
URL: https://viacep.com.br/ws/[CAMPO_CEP]/json/
Authentication: None
Headers: não necessário
Content type: JSON
Request body: vazio
Também configurei o JSON schema com o retorno esperado da API (logradouro, bairro, localidade, etc.) para conseguir mapear os campos depois.
Testei vários cenários:
-
CEP vindo de campo dinâmico
-
CEP fixo na URL (ex:
https://viacep.com.br/ws/01232000/json/) -
campo CEP como texto
-
campo CEP como numérico
-
schema completo da resposta
Mesmo assim, os campos nunca eram preenchidos e não há logs claros para entender se a requisição foi executada ou não.
Depois de algumas tentativas, resolvi testar uma abordagem diferente: criar um pequeno middleware em Python (Flask).
O fluxo ficou assim:
-
Pipefy dispara um webhook quando o card é criado
-
O webhook envia card_id + CEP para um endpoint Flask
-
O serviço consulta o ViaCEP
-
O middleware processa o JSON retornado
-
O próprio serviço faz uma mutation na API do Pipefy (GraphQL) para atualizar os campos de endereço do card
Resultado: funcionou imediatamente e de forma consistente.
Ou seja, acabamos criando uma espécie de “mini gateway de integração” só para fazer algo que teoricamente poderia acontecer dentro da própria automação.
Minha curiosidade é entender:
-
Existe alguma limitação conhecida no uso de HTTP request + HTTP response automations para esse tipo de cenário?
-
O comportamento pode estar relacionado ao fato dessas features ainda estarem em beta?
-
Existe alguma recomendação oficial de arquitetura para integrações simples com APIs externas?
No fim das contas, o processo gerou um pequeno “Frankenstein” de integração (Pipefy → Webhook → Flask → ViaCEP → GraphQL → Pipefy), que acabou funcionando muito bem.
Se alguém do time ou da comunidade tiver curiosidade sobre a implementação, fico feliz em compartilhar os detalhes.
Obrigado!
