> For the complete documentation index, see [llms.txt](https://help.cosmobots.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cosmobots.io/help/bot-builder/integracoes/pipefy.md).

# 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 %}