O que são conexões
Uma conexão representa o vínculo seguro entre o iPaaS e o sistema que você deseja integrar, por exemplo, Slack, Salesforce ou Google Sheets.
Cada conector possui um tipo de autenticação próprio (token, chave API, OAuth, etc.).
No caso do conector da Pipefy, a autenticação é feita por meio de uma Service Account (SA), garantindo controle e governança sobre permissões.
Após criada e configurada, uma conexão pode ser reutilizada em quantos fluxos quiser, sem precisar autenticar novamente.
⚠️ Importante: apenas o conector HTTP Request (usado para chamadas genéricas de API) não reutiliza credenciais entre fluxos diferentes dentro do mesmo pipe.
🧩 Quando usar o conector da Pipefy
Use o conector da Pipefy sempre que o fluxo depender de ações ou eventos internos da plataforma, como:
Gatilhos (triggers):
Card criado
Card movido
Card concluído
Campo atualizado
Comentário adicionado
Para que o conector funcione corretamente, é necessário criar uma conexão autenticada via Service Account, que terá acesso apenas aos pipes nos quais possui permissão.
📘 Saiba mais: veja neste artigo como criar uma Service Account dentro da Pipefy.
Configurando sua Service Account (SA)
Uma Service Account é uma conta técnica usada para permitir que integrações acessem dados da Pipefy de forma controlada e auditável, sem depender de credenciais pessoais.
Ela garante segurança, rastreabilidade e controle de escopo.
Passos para criar uma conexão com sua Service Account
Acesse o iPaaS da Pipefy e selecione o conector da Pipefy.
No menu lateral direito, encontre a opção Connection e clique em + Create Connection.
Preencha os dados da sua Service Account:
Client ID
Client Secret
Clique em Salvar.
Após autenticação bem-sucedida, uma nova conexão será criada e exibida na sua lista de conexões disponíveis.
💡 Dica: Você só precisa criar essa conexão uma vez por Service Account. Depois disso, sempre que usar o conector da Pipefy em outros fluxos, basta selecionar a conexão existente na lista.
Autenticação em outros conectores
Cada conector pode ter um tipo de autenticação diferente. Sempre que selecionar um conector externo, no menu lateral direito localize a opção Connection e siga as instruções para criar a conexão.
📘 Exemplo:
Ao usar o Google Sheets, você será direcionado para o login da sua conta Google. Após autorizar o acesso, o iPaaS da Pipefy poderá interagir com suas planilhas do Drive.
Criando um novo fluxo
Você pode criar novos fluxos no iPaaS da Pipefy de duas formas:
A partir de um template — escolha um modelo pronto, já com estrutura de gatilhos e ações, e personalize conforme seu processo.
Ideal para começar rapidamente, com exemplos de automações já validadas.
From scratch (do zero) — crie seu fluxo manualmente, adicionando conectores, definições de entrada, condições e ações conforme a lógica do seu processo.
Recomendado quando você precisa de uma integração personalizada ou complexa.
💡 Dica: antes de salvar e ativar, teste sempre cada etapa do fluxo (trigger + steps).
Testando o gatilho (trigger) do seu fluxo
Para testar corretamente um fluxo cujo gatilho é baseado em eventos de card, é necessário executar a ação real dentro do pipe.
Por exemplo:
Se o gatilho for “Card criado”, crie um novo card no pipe.
Se for “Card movido”, mova manualmente um card entre fases.
Se for “Campo atualizado”, altere um valor em qualquer campo configurado como trigger.
Após executar a ação no pipe, o evento será capturado pelo iPaaS, permitindo que você teste os steps subsequentes do fluxo.
⚠️ Importante: o trigger precisa receber um evento real da Pipefy para carregar os dados do card.Sem isso, o fluxo não avança para o teste das etapas seguintes.
🔄 Quando criar novas conexões
Crie uma nova conexão quando:
Estiver configurando fluxos em pipes diferentes, e cada pipe utilizar sua própria Service Account.
A Service Account anterior tiver sido revogada ou substituída.
Desejar segmentar conexões por área, ambiente ou finalidade (por exemplo, Financeiro, RH, Produção).
🔒 Atenção: cada pipe deve estar explicitamente autorizado à Service Account usada. Caso contrário, os gatilhos e ações desse pipe não funcionarão.
🚀 Próximos passos
Após criar sua conexão:
Acesse a biblioteca de conectores.
Escolha o conector da Pipefy e selecione a conexão criada.
Adicione o gatilho (ex.: Card movido) e configure suas ações subsequentes.
Teste o fluxo e verifique o log de execução dentro do iPaaS.
Pronto!
Agora você já pode criar e gerenciar integrações seguras, reutilizando conexões e mantendo total controle sobre acessos, permissões e Pipes.