👤 Para equipes que criam e mantêm conexões de integração
🔐 Gestão de Service Account exige Super Admin; acesso às integrações conforme permissões da conta
🎯 Planejar capacidade de execução, autenticação e manutenção das conexões
Uma integração de compras precisa continuar operando quando a pessoa que a criou muda de equipe. Ao mesmo tempo, uma carga inicial de dados pode gerar muito mais trabalho do que a rotina diária. Planejar autenticação e capacidade de execução ajuda a equipe a lidar com as duas situações.
Ao terminar este artigo, você vai saber considerar limites de execução, separar credenciais de integração das contas pessoais e organizar acessos e manutenção dos flows em Integrações Pipefy.
📖 O que você vai entender aqui:
Como Integrações Pipefy processa execuções (e os limites que moldam o design dos seus flows)
Entender como a plataforma executa um flow, e dentro de qual envelope de tempo, memória e concorrência ela opera, é o que separa uma integração que escala de uma que quebra em produção.
Como a plataforma processa execuções
Diferencie o recebimento de um evento da conclusão do trabalho iniciado por ele. A confirmação de recebimento informa ao sistema de origem que a solicitação chegou; ela não confirma, por si só, que todas as ações seguintes terminaram.
Defina se o sistema de origem pode continuar depois da confirmação ou se precisa de um resultado de negócio antes de prosseguir. Essa escolha orienta o que precisa estar no caminho de resposta e o que pode ser processado depois.
A tabela oficial de limites estabelece 30 segundos para reconhecer um gatilho de webhook recebido. Trate essa confirmação separadamente do tempo de conclusão do flow. Planeje chamadas externas lentas e processamento mais pesado conforme o contrato de resposta exigido pelo sistema de origem.
O limite de 50 execuções simultâneas
O limite documentado é de 50 execuções simultâneas por empresa em ambientes compartilhados, identificados como Multi Tenant ou MT. A documentação exclui explicitamente os ambientes dedicados Single Tenant ou ST desse controle de concorrência. Confirme o ambiente aplicável antes de usar esse número para planejar uma carga.
Em operações em lote, considere quantas execuções podem se sobrepor e por quanto tempo cada uma permanece ativa. O tamanho de um lote, sozinho, não determina o tempo de espera nem garante ausência de fila.
Comece com um lote pequeno e representativo, observe duração e espera e ajuste volume e intervalos. Considere os outros flows ativos que usam a mesma capacidade. Escolha o tamanho dos lotes a partir dessas observações, em vez de aplicar um número fixo a qualquer processo.
Os limites de governança que afetam o design de flows
Além do limite de concorrência, alguns parâmetros técnicos definem o envelope de operação de cada execução individual.
Timeout de 5 minutos por execução
A tabela Integrations Limits informa duração máxima de 5 minutos para uma execução de flow. Use essa referência documentada para avaliar a divisão do trabalho. Consulte a tabela vigente para o ambiente utilizado antes de alterar uma integração em produção.
Divida trabalhos longos em unidades menores e avalie subflows para responsabilidades independentes. Lotes menores e um caminho de recuperação definido facilitam a manutenção. Um loop dentro da mesma execução não concede automaticamente um novo limite de execução a cada repetição.
512 MB de RAM por execução
O limite de memória documentado é de 512 MB por execução. Ao tratar arquivos ou grandes conjuntos de dados em JSON, considere a memória das transformações além do tamanho da entrada. Carregue apenas a informação necessária para a próxima ação.
O limite de arquivo de 10 MB tem escopo na utilidade Files. Isso não garante que arquivos maiores possam ser processados por qualquer outro caminho: memória e capacidades de cada conector continuam relevantes. Quando houver suporte, use URLs assinadas e streaming para evitar manter o arquivo inteiro em memória.
Planeje cargas iniciais separadamente do tráfego diário. Acompanhe as respostas das APIs conectadas, respeite seus limites de requisição e defina como retomar ou investigar solicitações recusadas. Mantenha o registro da execução para identificar o que terminou e o que ainda exige atenção.
Consulte a tabela oficial de limites junto das recomendações de desempenho dos flows ao planejar volume, memória e divisão do trabalho.
Service Account: autenticação sem credenciais pessoais
Uma Service Account é uma conta de serviço criada especificamente para autenticar integrações. Ela não representa um usuário humano. Tem um email próprio, um Client ID e um Client Secret, e é essa combinação que o Integrações Pipefy usa para se autenticar e operar dentro dos pipes com os quais precisa interagir.
Usar uma Service Account separa a autenticação da integração do acesso de um colaborador. Isso reduz a dependência de uma pessoa, mas a conta ainda precisa de responsável pela manutenção. Desativá la ou alterar seus acessos pode interromper as conexões que a utilizam; identifique essas dependências antes de fazer mudanças.
Nomenclatura e permissões: decisões que importam antes de criar
Dois pontos merecem atenção antes de criar a primeira Service Account, porque são difíceis de corrigir depois que as integrações já estão em uso.
Use um nome descritivo para a conta e registre finalidade, sistemas conectados e responsável técnico na descrição. A descrição é opcional no produto; preenchê la é uma recomendação de governança. Nomeie as conexões de integração com o prefixo padronizado, por exemplo [Service account] Compras ERP.
Criar e gerenciar Service Accounts exige Super Admin. A própria conta possui uma função e precisa de acesso compatível com os recursos e ações utilizados pela integração. Revise as permissões da conexão real, em vez de tratar Pipe Administrator como requisito universal para qualquer operação por API. Consulte o guia de Service Accounts.
Organize credenciais e manutenção das conexões
Client ID identifica a conta, Client Secret é uma credencial sensível e o token autoriza requisições autenticadas durante sua validade. No fluxo Client Credentials, a integração obtém um token no endpoint de autenticação. Planeje a verificação de expiração e a renovação; possuir as credenciais da conta não torna um token permanente. O guia de Developers explica esse ciclo.
Como recomendação de modelagem, organize as contas por departamento e diferencie uso interno de conexões externas quando houver responsabilidades e acessos distintos. Por exemplo, separe uma integração interna de compras de uma conexão com fornecedor. Mantenha os segredos no mecanismo aprovado de conexão ou gestão de credenciais, com acesso controlado.
Mantenha um inventário que relacione cada conta às conexões, pipes, flows, responsável técnico e processo de renovação. Revise conexões legadas preventivamente. Antes de substituir ou desativar credenciais, teste a nova conexão com as ações necessárias e planeje a transição. Essa manutenção é diferente da substituição de uma pessoa aprovadora.
Antes de avançar, confirme que você entende
☐ O escopo do limite de concorrência e como a duração das execuções afeta o planejamento de carga.
☐ Por que o timeout de 5 minutos afeta o design de flows com alto volume de dados
☐ A diferença entre uma Service Account e as credenciais de um usuário Pipefy
☐ Quem gerencia a Service Account, quais acessos a integração exige e como manter tokens e dependências.
Pronto para conectar as informações usadas em cada etapa? Data Mapping
