# Pipefy

{% embed url="<https://drive.google.com/file/d/1tmwvE5HZD-ZiFB7atiwsvgqOsa9YJGCL/preview>" %}

A partir do momento em que a plataforma é integrada com o Pipefy, é possível realizar ações quando os cards são atualizados no Pipefy e também quando no fluxo da Cosmobots é acionada a etapa de integração com o Pipefy.

Vou te  mostrar o passo a passo, vamos lá!

## Realizando integração:

1- Dentro do seu Pipefy, acesse  essa url <https://app.pipefy.com/tokens>, dê um nome para o seu Token, clique em Gerar novo Token, defina uma descrição e clique em salvar:

![](/files/-MHSDjSDJOzoIHlFL57I)

2- Copie o token que foi gerado, no bot que você quer realizar a integração, vá em Integrações, Pipefy e no campo Access Token, cole o token que você copiou:

![](/files/-MHSEFXcKXEJvfYTFyiF)

3- Volte no Pipefy, e acesse [seus Pipes](https://app.pipefy.com/), selecione o Pipe que você quer integrar e na url da página, copie  seu id:

![](/files/-MHSEInWY-GjniHHp2Tv)

{% hint style="info" %}
OBS#: Na URL o id fica localizado após pipes/, por exemplo, <https://app.pipefy.com/pipes/(aqui> estará seu id).
{% endhint %}

4- Na plataforma Cosmobots, no campo ID do Pipe, cole seu id e selecione seu canal de comunicação com o Pipefy:

![](/files/-MHSEmFTrGGj4FKa-lt5)

## Configurando Ações de Webhook

Aqui nós vamos configurar as ações que serão refletidas do Pipefy para a Cosmobots

{% hint style="info" %}
OBS#: É possível configurar ações para serem realizadas quando os cartões atingirem os seguintes status:&#x20;

Cartão Movido: Quando o cartão é movimentado dentro do pipe

&#x20;Cartão Criado: Quando ocorre a criação de um novo cartão dentro do pipe

&#x20;Cartão Atrasado: Quando ocorre um atraso na data de um cartão dentro do pipe

&#x20;Cartão Expirado: Quando o cartão expira dentro do pipe

&#x20;Cartão Concluído: Quando um catão é marcado como concluído dentro do pipe

&#x20;Cartão com Campo Atualizado: Quando ocorre atualização em um ou mais campos do cartão dentro do pipe

Cartão Vencido: Quando o cartão é vencido dentro do pipe.
{% endhint %}

{% hint style="info" %}
Para mais informações sobre os cartões no Pipefy, acesse:<https://api-docs.pipefy.com/reference/overview/Card/?_ga=2.258558658.996679396.1600285788-417078098.1600285788>
{% endhint %}

1- Para configurar o webhook, Pipefy, selecione as ações que devem ser realizadas no Pipefy para ser acionado o webhook na Cosmobots:

![](/files/-MHSN1wHN-urMzYZQnyP)

{% hint style="info" %}
Por exemplo, na opção Cartão Movido, escolhemos a opção todas as fases, em Fase de destino também escolhemos todas as fases, ou seja, se o catão for movimentado de qualquer fase para qualquer outra frase, o Webhook deve ser disparado, e em Campo com WhatsApp do Contato, colocamos o campo em que o WhtasApp do cliente está inserido no pipe.
{% endhint %}

2- Em Cosmobots, selecione qual fluxo e etapa devem ser acionados quando as atividades configuradas em Pipefy forem realizadas, e salve:

![](/files/-MHSN5X0wbhUE30aOCkD)

Pronto! Toda vez que um card do Pipefy for atualizado com as ações que você configurou será automaticamente ativado na Cosmobots o fluxo e etapa que você definiu.

## Configurando etapa Pipefy

Aqui nós vamos configurar as ações que devem refletir da Cosmobots para o Pipefy.

1- Em fluxos de conversa, durante a criação das etapas, você terá uma opção chamada integrações>Pipefy:

![](/files/-MHSPxwPk98NYJoMmbBx)

2- Ao criar essa etapa, você terá a opção de definir qual ação deve refletir no Pipefy quando  o usuário atingir essa etapa no fluxo, podendo ser criar um novo cartão ou criar um comentário em um cartão existente:

![](/files/-MHSPu40gvK2_RZr51qy)

Desse modo, toda vez que o usuário atingir a etapa do fluxo, automaticamente será criado no Pipefy um novo cartão ou comentário para esse usuário.

{% hint style="info" %}
OBS#: Lembrando que a chave primária dessa integração é o whatsapp, logo, os cartões serão criados e atualizados com o número de whatsapp que o usuário se cadastrou na Cosmobots ou na Pipefy.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.cosmobots.io/help/bot-builder/integracoes/pipefy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.