Pipefy
Olá Cosmonauta 🚀! Nesse artigo vamos falar sobre a integração da plataforma Cosmobots com o Pipefy.
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:
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:
3- Volte no Pipefy, e acesse seus Pipes, selecione o Pipe que você quer integrar e na url da página, copie seu id:
OBS#: Na URL o id fica localizado após pipes/, por exemplo, https://app.pipefy.com/pipes/(aqui estará seu id).
4- Na plataforma Cosmobots, no campo ID do Pipe, cole seu id e selecione seu canal de comunicação com o Pipefy:
Configurando Ações de Webhook
Aqui nós vamos configurar as ações que serão refletidas do Pipefy para a Cosmobots
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.
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
1- Para configurar o webhook, Pipefy, selecione as ações que devem ser realizadas no Pipefy para ser acionado o webhook na Cosmobots:
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.
2- Em Cosmobots, selecione qual fluxo e etapa devem ser acionados quando as atividades configuradas em Pipefy forem realizadas, e salve:
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:
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:
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.
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.
Last updated