Todas as coleções
Funcionalidades | Usuários Admin
Integrações
Pipefy Connector
Pipefy Connector: como configurar gatilhos e ações para pipes
Pipefy Connector: como configurar gatilhos e ações para pipes

Crie integrações customizadas para seus pipes pelo Pipefy Connector. Disponível apenas para o plano Enterprise.

Grazi Sabatini avatar
Escrito por Grazi Sabatini
Atualizado há mais de uma semana

Tempo de leitura estimado: 15 minutos

Nossos clientes Enterprise contam com integrações customizadas para otimizar seus fluxos de trabalho. Nesse caso, utilizamos o Workato para conectar seu Pipefy a outras plataformas, como DocuSign, Google Sheets ou Salesforce, por exemplo.

Neste artigo, você vai aprender a definir gatilhos e ações para pipes no Workato.

Use o menu abaixo para encontrar rapidamente a configuração você precisa:

Configurando um gatilho para cards

Para começar, selecione o gatilho desejado na lista de gatilhos (triggers) do Pipefy Connector.

No exemplo abaixo, temos a configuração de um gatilho de Novo Card, que será ativado em tempo real sempre que um novo card for criado em um pipe.

Depois de selecionar o gatilho, precisamos criar uma conexão entre o Workato e o Pipefy para que a plataforma possa verificar os eventos de criação de cards.

Nós podemos fazer essa conexão usando dois tipos diferentes de autorização:

  • Pipefy Login

  • Token API

Se você optar pelo Pipefy Login, precisa fornecer:

  • Nome da conexão: Dê a esta conexão um nome único para identificar a conta do Pipefy

  • Tipo de autorização: Selecione o Login Pipefy como o tipo de Autorização e clique no botão Conectar.

O conector vai mostrar a página de login do Pipefy para permitir que você selecione a conta a qual deseja estabelecer a conexão.

Se você está usando o login SSO da sua empresa, pode optar pelo Token API.

Neste caso, você precisa fornecer:

  • Nome da conexão: Dê a esta conexão um nome único para identificar a conta Pipefy.

  • Tipo de autorização: Selecione o Token API como o tipo de Autorização.

  • Token API: Insira o Pipefy API token, que pode ser obtido nas preferências da sua conta no Pipefy.

  • URL do domínio Pipefy: A URL para o domínio da sua organização no Pipefy.

Em configurações (setup) você deve conectar a sua Organização no Pipefy e o Pipe em que você é membro para começar a gerar os eventos de criação de novos cards.

Salve sua "receita"(recipe) e, a partir de agora, ela será ativada toda vez que um novo card for criado no Pipe selecionado.

📌 No exemplo abaixo, usamos o gatilho de New Card (novo card). Se quiser configurar outros gatilhos, o processo é o mesmo. Basta selecionar a opção desejada na lista de gatilhos.

Configurando a ação para criar cards

Esta ação cria um novo card no Pipe selecionado com os valores de campo fornecidos. Primeiro, precisamos escolher a ação Create Card (Criar Card) na lista de ações disponíveis no Pipefy Connector.

Ao selecionar esta opção, o Workato mostra a ação em uso com uma marca verde.

Em configurações (setup), selecione sua organização no Pipefy e um Pipe para criar um novo card.

Com isso, o Pipefy Connector vai exibir os campos do Formulário de Início, onde você vai poder informar os valores de cada um deles, ou usar datapills de outros gatilhos/ações.

📌 Datapills (pílulas de dados) são os dados retornados das etapas anteriores (triggers/actions), que podem ser utilizados como entrada (input) nos campos do formulário público.

Configurando a ação Atualizar Card

Esta ação atualiza um card no pipe selecionado com os valores de campo fornecidos.

Primeiro, precisamos escolher a ação Update Card (atualizar card) na lista de ações do Pipefy Connector.

Com isso, o Workato vai mostrar a ação em uso com uma marca verde.

Na etapa de configuração (setup), selecione a organização e o Pipe onde você quer atualizar os cards. Selecione também qual fase eles serão atualizados, já que, no Pipefy, podemos ter diferentes campos por fase.

Quando um pipe e uma fase são selecionados, o conector mostra os campos onde você poderá digitar os valores para que sejam atualizados.

📌 Lembre-se: Para a ação Atualizar Card, a ID do Card é um campo obrigatório. Portanto, se você não tiver a ID dele, precisa recuperá-la primeiro usando uma das ações Get Card (obter card) disponíveis. (Confira o passo a passo).

Configurando a ação Deletar card

Esta ação exclui um card no pipe selecionado. O primeiro passo é selecionar a ação Delete Card (deletar card) da lista de ações disponíveis no Pipefy Connector.

Com isso, o Workato vai mostrar a ação em uso com uma marca verde.

Em configurações (setup), você precisa digitar o ID do card ou usar valores do datapill de gatilhos ou ações anteriores para apagar o card.

📌 Lembre-se: Para a ação Deletar Card, a ID do Card é um campo obrigatório. Portanto, se você não tiver a ID dele, precisa recuperá-la primeiro usando uma das ações Get Card (obter card) disponíveis. (Confira o passo a passo).

Configurando a ação Mover cards

Esta ação move um card no Pipe selecionado para outra fase.

Selecione a ação Move Cards (mover cards) na lista de ações disponíveis do Pipefy Connector.

A ação selecionada vai ficar com uma marca verde.

Em configurações (setup), selecione a organização e o Pipe para onde deseja mover os cards.

Depois, escolha para qual fase do Pipe você deseja mover o cards, pois um Pipe pode conter várias fases.

Com isso, o conector vai mostrar a ID do card, onde você pode digitar um valor para ele ou usar o valor do datapill para mover cards.

📌 A ID do card é um campo obrigatório para a ação Mover cards. Portanto, se você ainda não tiver a ID deles, precisará recuperá-la primeiro, usando uma das ações Get Cards (Obter cards) disponíveis.

Configurando a ação Obter Cards por Campo

Esta ação gera uma lista de cards no Pipe que contém o valor do campo selecionado.

Selecione a ação Get cards by field (Obter cards por campo) na lista de ações do Pipefy Connector.

O Workato vai mostrar a ação em uso com uma marca verde.

Em configurações (setup), selecione a organização e o Pipe de onde você deseja obter os cards.

Selecione também qual campo do pipe você deseja usar como filtro para puxar os cards.

Depois, você pode fornecer um valor para campo para ser usado na pesquisa, digitando um valor ou usando um valor do datapill de gatilhos/ações anteriores.

📌 Vale lembrar que, atualmente, a API do Pipefy retorna até 50 cards.

Configurando a ação Obter cards por Fase

Esta ação gera uma lista de cards de uma fase específica do Pipe selecionado. Primeiro, precisamos selecionar a ação Get cards by Phase (Obter cards por fase) na lista de ações do Pipefy Connector.

O Workato vai mostrar a ação em uso com uma marca verde.

Em configurações (setup), selecione a organização e o Pipe de onde você deseja obter os cards.

Informe também qual é a fase do pipe que você quer puxar os cards.

O Conector vai usar a API do Pipefy para retornar uma lista dos cards com base em sua seleção.

📌 Atualmente, a API retorna até 50 cards.

Configurando a ação Obter cards por Título

Esta ação obtém uma lista de cards que contém determinado título e que estão em determinado Pipe.

Primeiro, precisamos escolher a ação Get Cards by Title (obter cards por título) na lista de ações disponíveis do Pipefy Connector.

A ação selecionada vai ficar destacada com uma marca verde.

Em configurações (setup), selecione a organização e o Pipe de onde você deseja obter os cards.

Informe o título dos cards que você quer obter digitando um valor ou usando o datapill.

O conector vai usar a API do Pipefy para retornar uma lista dos cards com base em sua seleção.

📌 Esta ação não requer o título completo do cards, portanto, você pode pesquisar cards usando apenas palavras-chave. Por exemplo: um card com o título "compra de materiais de escritório", pode ser encontrado usando somente as palavras "materiais de escritório"

📌 Uma vez que o título de um card não é um identificador único no Pipefy, nesta ação o conector pode retornar uma lista de cards em vez de apenas um card.

Se você não encontrar nenhum card pelo título fornecido, pode criar um novo. Nesse caso, você deve selecionar a opção Yes (Sim) no campo Create card if no cards were found (criar cards se nenhum card for encontrado).

Em seguida,o Workato vai mostrar os campos do Formulário Inicial, onde você pode digitar os valores de cada Campo ou usar os valores do datapill.

Configurando a ação Obter card por ID

Esta ação obtém cards de um determinado Pipe com base na ID dos cards.

O primeiro passo é selecionar a ação Get Card by ID (obter card por ID) na lista de ações disponíveis para o Pipefy Connector.

Em seguida, o Workato mostrará a ação em uso com uma marca verde.

A próxima etapa é selecionar a organização e o Pipe de onde você quer obter o card.

Digite a ID do card ou use os valores de datapill de gatilhos/ações anteriores dos cards que deseja obter.

📌 A ID do card é um campo obrigatório para esta ação. Portanto, se você não tiver a ID do cards, precisará recuperá-la primeiro usando uma das ações Get Cards (obter cards) disponíveis.

Além disso, quando você fornece um valor para o campo ID do card, o datapill mostrará a lista de campos que poderão ser utilizados com entradas (inputs) nas próximas ações do processo.

Saiba mais sobre o Pipefy Connector:

Respondeu à sua pergunta?