👤 Para quem está começando com integrações ou já usa Workato
🔐 Para empresas com Integrações Pipefy habilitado e os acessos necessários
🎯 Para quem quer transformar dados em solicitações e acompanhar o resultado de cada execução
Esse conteúdo nasceu do treinamento ao vivo “Como construir integrações com o iPaaS nativo do Pipefy”, realizado na Pipefy Academy. A sessão foi conduzida por Guilherme Hora. Nela foram usados dois exemplos práticos: transformar linhas de um arquivo CSV em solicitações no Pipefy e comunicar decisões de aprovação pelo Slack.
Ao terminar a leitura, você entenderá o papel da conexão, do gatilho e das ações, como usar os dados de cada solicitação e como acompanhar as execuções para investigar um resultado diferente do esperado.
📖 O que você vai entender aqui:
Entenda a lógica antes de desenhar o fluxo
Integrações Pipefy é o módulo de iPaaS nativo que conecta dados e ações entre ferramentas. No treinamento, a explicação partiu de três componentes.
- Conexão: autoriza o acesso ao sistema. No conector da Pipefy, usa uma conta de serviço com Client ID e Client Secret. É essa conta que precisa ter acesso aos pipes envolvidos.
- Gatilho: é o acontecimento que inicia o fluxo. Nos exemplos, a criação de um card iniciou a leitura do arquivo e a atualização do campo de avaliação iniciou o tratamento da decisão.
- Ações: são as tarefas executadas depois, como buscar informações, criar um card, atualizar o gestor ou enviar uma mensagem.
Antes de construir, escreva uma frase que reúna esses componentes: “Quando chegar um arquivo de solicitações, criar um card para cada pedido e encaminhar a avaliação ao gestor da área”. Essa frase ajuda a reconhecer o início, o resultado e a regra de encaminhamento.
Saiba mais: consulte a introdução a Integrações Pipefy para conhecer os componentes do módulo.
Transforme cada linha em uma solicitação
Na primeira demonstração, um pipe auxiliar recebeu um card com um arquivo CSV anexado. O arquivo tinha 33 linhas de dados com nome completo, departamento, valor e descrição da requisição. O fluxo leu o arquivo e percorreu a lista para criar os cards no pipe principal.
Pense em uma equipe de Compras que recebe pedidos de TI, Engenharia, Vendas e Marketing. O arquivo reúne os pedidos, mas cada linha precisa seguir como uma solicitação própria, com seus dados e seu gestor.
O ponto central é a origem dos valores. Dentro de uma repetição, chamada de loop, a criação do card deve usar os dados do item atual. Assim, cada card recebe o nome, o departamento, o valor e a descrição daquela solicitação.
Uma informação fixa serve quando deve ser igual para todos. Se cada pedido tem um solicitante diferente, use o valor do item atual da repetição. Selecionar apenas o dado usado na amostra pode repetir o mesmo nome nos demais cards.
Depois da criação, um roteador, ou Router, separou os caminhos por departamento para definir o gestor. A atualização usou o ID do card recém criado no pipe principal. Esse identificador é diferente do ID do card que recebeu o arquivo no pipe auxiliar.
Para adaptar o exemplo, defina quais colunas representam cada pedido, quais departamentos serão reconhecidos e quem avalia cada área. Como recomendação de operação, reserve um tratamento para valores que não correspondam aos departamentos previstos.
Conecte a decisão do gestor ao Slack
Na segunda demonstração, a atualização do campo de avaliação iniciou o fluxo. A decisão levou o card ao caminho de aprovação ou reprovação, com movimentação para a fase correspondente e envio de uma mensagem no Slack.
A mensagem de aprovação mostrou como incluir dados da solicitação e o link do card. Para quem acompanha o pedido pelo Slack, isso reúne o resultado e o acesso ao registro em uma mesma comunicação.
Ao adaptar esse caso, defina quem precisa receber o aviso e quais informações ajudam essa pessoa a agir. Uma mensagem com identificação do pedido, resultado e link do card oferece contexto sem reproduzir todos os campos do processo.
Defina critérios que distingam os resultados com precisão. Em português, “reprovado” também contém a sequência “aprovado”. Prefira critérios explícitos para cada valor completo e teste os dois caminhos. Se houver outros estados, como uma avaliação ainda em aberto, defina o tratamento deles separadamente.
Essa recomendação evita tratar qualquer valor diferente de uma aprovação como reprovação. A regra deve refletir os estados reais do seu processo.
Teste o caminho completo e leia as execuções
Durante a demonstração, cada etapa foi testada para obter seus dados de saída e permitir o uso desses valores nas próximas ações. Para gatilhos de eventos de card, o teste depende de produzir o evento no pipe, como criar um card ou atualizar o campo acompanhado.
O teste também pode produzir um resultado real. Na sessão, testar a criação gerou um card no pipe de destino. Como prática de validação, use dados de teste e confira o que já foi criado antes de repetir o lote.
Na aba Execuções, Guilherme mostrou uma execução concluída e outra que parou na movimentação. A mensagem apontava que a fase de destino não estava habilitada entre as opções de movimentação da fase de origem. Após o ajuste dessa regra, ele demonstrou uma nova tentativa.
Comece pela primeira etapa que não concluiu. Se a movimentação falhou antes do envio ao Slack, investigue a mensagem daquela etapa. Esse caminho ajuda a localizar a causa antes de revisar a comunicação.
As regras de movimentação continuam fazendo parte do processo. Consulte como mover cards pelo pipe e restringir os destinos para avaliar esse cenário.
Outro cuidado demonstrado foi a publicação das alterações: depois de editar a mensagem do Slack, Guilherme publicou novamente o fluxo para que a execução usasse a nova versão. Antes de testar uma mudança, confira a versão publicada e o estado de ativação.
Se você usa Workato, planeje a transição
Conexão, gatilho e ações são conceitos que ajudam quem já cria receitas na Workato a compreender o novo ambiente. No treinamento, Guilherme destacou o uso da conta de serviço no conector da Pipefy e os testes das etapas para disponibilizar os dados ao longo do fluxo.
Para a migração, consulte o FAQ oficial da transição da Workato para o iPaaS Pipefy. O prazo comunicado para concluir a migração é 31 de dezembro de 2026. As conexões precisam ser refeitas e cada integração pode exigir adaptações e validação dos resultados.
O treinamento oferece uma base para entender e testar fluxos. O planejamento da migração precisa considerar as integrações e os acessos específicos da sua empresa.
Perguntas da audiência, respondidas ao vivo
Preciso usar meu token pessoal para conectar a Pipefy?
Não. O conector da Pipefy usa uma conta de serviço, com Client ID e Client Secret. No treinamento, essa separação foi apresentada como forma de manter a integração vinculada a uma conta técnica da empresa.
Quem pode criar a conta de serviço?
Um Super administrador da empresa. A criação da conta e os acessos aos pipes devem ser combinados com a pessoa responsável por essa administração. Veja a documentação de contas de serviço.
A conexão foi criada. Por que o fluxo não acessa um dos pipes?
Confira os acessos da conta de serviço ao pipe usado pelo gatilho ou pela ação. Na demonstração com dois pipes, a conta precisou de acesso ao pipe auxiliar e ao principal.
Por que os dados do gatilho não aparecem para testar as ações?
Para gatilhos baseados em eventos de card, produza o evento correspondente no pipe durante o teste. Um gatilho de card criado precisa receber uma criação; um gatilho de campo atualizado precisa receber a atualização configurada.
Por que foi usado um CSV? Posso trabalhar com planilhas conectadas?
O CSV foi escolhido para demonstrar a leitura de um arquivo anexado ao card. Guilherme também citou os conectores de Google Sheets e Microsoft 365 como alternativas, conforme a origem dos dados e a autenticação disponível.
Como evitar que todos os cards recebam os mesmos dados?
Na ação de criação dentro do loop, use os valores do item atual da repetição. Na demonstração, isso garantiu que cada card recebesse os dados da sua linha do CSV.
Qual ID devo usar para atualizar o gestor de cada solicitação?
Use o ID retornado pela ação que criou aquela solicitação no pipe principal. O ID do card do pipe auxiliar identifica o registro que recebeu o arquivo.
Como definir um gestor diferente para cada departamento?
No exemplo, um Router separou os caminhos conforme o departamento e cada caminho atualizou o gestor do card criado. Adapte as correspondências às áreas e às pessoas da sua empresa.
Por que a movimentação para a fase de reprovação não aconteceu?
No caso mostrado, a fase de destino não estava habilitada nas opções de movimentação da fase de origem. Confira a primeira etapa com falha e sua mensagem em Execuções para identificar se esse é o seu caso.
Editei o fluxo. Por que a execução ainda usa a mensagem anterior?
No treinamento, a mensagem editada passou a valer após uma nova publicação do fluxo. Confira se a alteração foi publicada e se o fluxo está ativo antes do novo teste.
Posso tentar novamente uma execução que falhou?
Na sessão, foram apresentadas opções de nova tentativa na versão mais recente e a partir do passo que falhou. Antes de repetir, avalie as etapas já concluídas para evitar criar novamente cards ou enviar avisos em duplicidade.
Preciso migrar minhas integrações da Workato?
Sim, as integrações que usam a infraestrutura Workato fornecida pela Pipefy devem concluir a transição até 31 de dezembro de 2026. Consulte o FAQ de migração da Workato para responsabilidades, conexões e apoio disponível.
Antes de avançar, confirme que você entende:
☐ Qual evento inicia o fluxo e quais acessos a conta de serviço precisa ter.
☐ Como distinguir o item atual do loop e o card criado no pipe principal.
☐ Como testar aprovação e reprovação e localizar a primeira etapa que não concluiu.
Pronto para aplicar essa lógica? Escolha um pequeno conjunto de solicitações de teste, defina o resultado esperado e use o guia de primeiros passos com o iPaaS da Pipefy para preparar a conexão e validar seu primeiro fluxo.
