> 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 Olá Cosmonauta 🚀! Nesse artigo vamos falar sobre a integração da plataforma Cosmobots com o Pipefy. {% embed url="" %} 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 , dê um nome para o seu Token, clique em Gerar novo Token, defina uma descrição e clique em salvar: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSDjSDJOzoIHlFL57I%2Fde%20um%20nome%2C%20clique%20em%20gerar%20novo%20token%20de%20uma%20descri%C3%A7%C2%BAoa%20e%20clique%20em%20salvar.gif?alt=media\&token=06f64ce5-7543-4e3a-9f70-f563be055844) 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: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSEFXcKXEJvfYTFyiF%2Fcole%20o%20seu%20token.gif?alt=media\&token=05fd4ee7-021c-476a-aec3-9b300db57df8) 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: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSEInWY-GjniHHp2Tv%2Furl.gif?alt=media\&token=81fa653d-4852-4f9e-8c94-829fd89724d1) {% hint style="info" %} OBS#: Na URL o id fica localizado após pipes/, por exemplo, 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: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSEmFTrGGj4FKa-lt5%2Fcole%20seu%20id%20e%20selecione%20seu%20canal.gif?alt=media\&token=ce919039-38a8-4538-bedd-58fbc9c804fa) ## 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: Cartão Movido: Quando o cartão é movimentado dentro do pipe Cartão Criado: Quando ocorre a criação de um novo cartão dentro do pipe Cartão Atrasado: Quando ocorre um atraso na data de um cartão dentro do pipe Cartão Expirado: Quando o cartão expira dentro do pipe Cartão Concluído: Quando um catão é marcado como concluído dentro do pipe 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: {% endhint %} 1- Para configurar o webhook, Pipefy, selecione as ações que devem ser realizadas no Pipefy para ser acionado o webhook na Cosmobots: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSN1wHN-urMzYZQnyP%2Fa%C3%A7%C3%B5es%20pipefy.gif?alt=media\&token=96b9b5f1-a8a2-4274-aff6-f870b03274c3) {% 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: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSN5X0wbhUE30aOCkD%2Fcosmobots.gif?alt=media\&token=d8b1d874-b143-4d3c-961d-9ed09460694a) 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: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSPxwPk98NYJoMmbBx%2Fdentro%20de%20fluxos%20de%20conversa.gif?alt=media\&token=0584ee05-c323-4978-9ac0-c64e84746644) 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: ![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MHRnXLcmh_D7GazX9GJ%2F-MHSPu40gvK2_RZr51qy%2Fpipefy.gif?alt=media\&token=fa342426-109f-44d3-877d-779c4da0a6a2) 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 %}