Ações automáticas - Webhook - Enviar oportunidade para URL
No CRM de vendas PipeRun, você pode automatizar processos que serão realizados sempre que um gatilho for acionado, dando agilidade e economizando seu tempo gasto com execução de processos dentro da plataforma.
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 13.0px 'Helvetica Neue'} li.li1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 13.0px 'Helvetica Neue'} span.s1 {font: 9.0px Menlo} ul.ul1 {list-style-type: disc}
Através da ação automática de webhook - envio de oportunidade para URL, é possível enviar informações sobre oportunidades, empresas, pessoas e propostas para outros sistemas, utilizando o webhook do PipeRun. Os webhooks possibilitam o envio de dados de todos os eventos que ocorrem dentro do CRM. Para saber mais sobre possíveis falhas na execução de ações automáticas, como identificá-las e os meios de saná-las, acesse este artigo.Atenção! Apenas usuários com nível de acesso de gestor tem acesso ao menu de ações automáticas. Para saber mais sobre níveis de acesso, acesse este artigo.Ações automáticas não são ativadas por importações ou ações em massa. Para que estes eventos desencadeiem a execução da ação, você precisará utilizar de forma conjunta uma cadência de funil que irá transferir as oportunidades para a etapa com a ação automática. Para saber mais, acesse este artigo.Confira o passo a passo para criar uma ação automática de webhook - envio de oportunidade para URL.VÍDEO TUTORIALTÓPICOS DO ARTIGODados enviados via ação automáticaConfigurando a ação automáticaConfigurando a formatação de saída do envio de dadosTestando a ação automática via BeeceptorDADOS ENVIADOS VIA AÇÃO AUTOMÁTICACom este recurso, é possível enviar os seguintes dados:Dados da oportunidade: título da oportunidade, valor de produto e serviço (P&S), valor de recorrências (MRR), data de previsão de fechamento, data de criação e de fechamento, observação, status e situação, origem, temperatura, tags, motivos de perda, funil e etapa de funil, dados do usuário, dono da oportunidade, valores dos campos customizados vinculados, formulários customizados, etc.;Dados da empresa vinculada à oportunidade: nome da empresa, CNPJ, CNAE, número de telefone, endereço, situação da empresa, tamanho, segmento, tags, links do website e das páginas do Facebook e LinkedIn, valores dos campos customizados vinculados, etc.;Dados da pessoa vinculada à oportunidade: nome da pessoa, CPF, número de telefone, endereço, dados da empresa de trabalho, cargo, tags, data de nascimento, gênero, observações, links do website e das páginas do Facebook e Linkedin, valores dos campos customizados vinculados, etc.;Dados da proposta da oportunidade: valor da proposta em produtos e serviços (P&S), valor da proposta em recorrências (MRR), parcelas de pagamento, método de pagamento, status, data de validade e de vencimento, data de primeiro pagamento de parcela de recorrência (MRR), dados de transportadora e local de entrega triangular, marcas, valores dos campos customizados vinculados, etc.;Dados da ação automática: data de disparo, nome do funil e etapa onde a ação automática foi executada, tipo de gatilho de acionamento da ação automática, usuário que disparou a ação automática (caso tenha sido realizada manualmente).CONFIGURANDO A AÇÃO AUTOMÁTICA1. Posicione o mouse sobre o avatar da conta, localizado no canto superior direito da tela. Clique em "Ajustes e configurações".2. A seguir, clique em "Ações automáticas", na coluna Ferramentas.3. Nesta tela, aparecerão listadas todas as ações automáticas cadastradas na conta. Para configurar uma nova ação automática, clique em "+ Adicionar ação".Confira também nossos artigos sobre como editar ações automáticas e como habilitar ou desabilitar ações automáticas.4. Nesta primeira será configurada a ação automática, bem como o gatilho que será responsável por executá-la.Na primeira etapa, preencha os campos disponíveis com os seguintes dados: 1.1. Um nome, para que seja fácil identificar esta ação automática na listagem;1.2. Selecione o gatilho para que a ação automática seja executada;1.3. Tipo de ação automática a ser realizada. Escolha a opção "Webhook - Envio de oportunidade para URL";1.4. Defina a prioridade que a ação automática terá para ser enviada para a fila de execução;1.5. Informe se deseja ou não personalizar um dia e horário para que a ação seja executada.Na segunda etapa, preencha os campos a seguir:2.1. Funil onde a ação automática poderá ser realizada;2.2. Etapa onde será acionado o gatilho para realizar a ação;2.3. Selecione o status e situação que a oportunidade poderá estar para executar essa ação.2.4. Informe se deseja ou não personalizar um dia e horário para que o gatilho seja executado.Para mais detalhes sobre a primeira parte de configuração das ações automáticas, acesse este artigo.Para saber mais sobre a personalização de dia e horário para a execução de ações automáticas, acesse este artigo.A prioridade se aplica somente à ações automáticas configuradas para serem disparadas na mesma etapa e com o mesmo gatilho. Para saber mais, acesse este artigo.Clique em "Próximo".5. A partir deste ponto, será configurada a segunda parte da ação automática. Informe os seguintes campos: Header: informação referente à chave que estará contida no cabeçalho, a depender da integração de destino;Valor: valor referente à chave do header;Dica: é possível informar mais de um header. Para isto, clique em "+ Adicionar header e valor".URL: campo de preenchimento obrigatório. Trata-se do endereço que receberá os dados enviados via webhook do CRM de vendas PipeRun;Tipo de envio: é possível selecionar entre as opções "padrão" e "avançado", conforme abaixo:Padrão: utiliza as chaves padrões do sistema da PipeRun, sem possibilidade de customização;Avançado: possibilita customizar a formatação do JSON de saída dos dados enviados via ação automática. Para saber como customizar as chaves, continue a leitura no próximo tópico ou clique aqui.Após preencher os campos necessários, clique em "Salvar".Pronto! Após seguir os passos acima, sua ação automática de enviar para webhook estará configurada. CONFIGURANDO A FORMATAÇÃO DE SAÍDA DOS DADOSAtenção! Para realizar a configuração de formatação de saída dos dados, é necessário ter conhecimentos técnicos prévios em troca de dados entre sistemas.Para customizar a formatação do JSON de saída dos dados enviados via ação automática, siga o passo a passo abaixo:1. Em "Tipo de envio", na tela de edição da ação automática, selecione a opção "Avançado".2. Em "Formatação de saída", selecione a opção "JSON". Em breve estaremos disponibilizando outros tipos de formatação de saída. Para sugerir novas funcionalidades utilize nossa plataforma de sugestões.3. Na área "JSON Disponível" você poderá visualizar a estrutura padrão do JSON enviado via ação automática.Dica: confira no final do artigo o comentário em código com a descrição das chaves disponíveis no CRM de vendas PipeRun.4. Já na área central da tela, configure a expressão de saída desejada, seguindo esta estrutura:{
"":""
}Caso de uso: a chave padrão do PipeRun referente ao nome fantasia do registro do contato da empresa é "company" e a chave padrão no sistema que receberá os dados via ação automática é "empresa". Para que a expressão seja recebida da forma correta no sistema de destino, basta configurar a expressão da seguinte forma:{
"empresa": "company"
}  Desta forma, a formatação do JSON enviado pelo PipeRun terá como chave "empresa", ao invés de "company".5. Agora, confira a pré-visualização da formatação do JSON de saída, na área direita da tela.6. Para realizar um teste de envio de dados, basta clicar no botão "Envio de teste", localizado no canto inferior esquerdo da tela. Dica: o envio de teste será realizado para a URL definida na ação automática.7. Por fim, após finalizar as configurações de saída da ação automática, não esqueça de clicar no botão "Salvar", localizado no canto inferior direito da tela, para registrar a ação.Dica: é possível ativar os logs temporários da ação automática. Para isto, clique nos logs na listagem de ações automáticas e, após em "Logs temporários". Os logs serão mantidos por 24 horas (após esse período, serão excluídos).TESTANDO A AÇÃO AUTOMÁTICA VIA BEECEPTORCaso necessário, depois de criar a ação automática webhook - enviar oportunidade para URL é possível testar o seu funcionamento.Neste exemplo, utilizamos o site beeceptor para gerar uma URL gratuita para testar o envio de dados da ação automática.1. No Beeceptor, digite no campo "Endpoint name" um nome para a URL a ser criada. Neste exemplo utilizamos o nome "piperun1". Logo após, clique em "Create Endpoint".2. Agora, clique no ícone conforme indicado no print abaixo, para copiar a URL. Mantenha o site do Beeceptor aberto. Será necessário retornar à esta tela após a execução da ação automática.A URL criada seguirá o padrão https://endpointname.free.beeceptor.com. Sendo o endpointname o que valor que você informou conforme o passo 1. Neste  exemplo, a URL gerada foi https://piperun1.free.beeceptor.com.3. Informe a URL obtida no beeceptor (link do endpoint criado) no campo "URL" das configurações da ação automática. Para saber mais sobre os campos da ação automática, acesse o passo 5 do segundo tópico ou clique aqui. 4. Acesse o pipeline e execute a ação automática, conforme etapa e gatilho configurados. Neste exemplo, a oportunidade será movida de uma etapa para outra.5. Após a execução da ação automática, será necessário acessar o site do Beeceptor, onde poderá ser visualizada a requisição recebida. Clique em "POST" para abrir os detalhes da requisição e visualizar seu payload.O método POST é um tipo de requisição de envio. Isto significa que a URL criada recebeu uma requisição de envio após o acionamento da ação automática.6. Em "Request body" será exibido o corpo da requisição. Nela, poderemos ver as informações que foram enviadas da oportunidade via ação automática. Observe também que há a informação "200" dentro de uma caixa verde. Isso significa que a requisição possuiu um status 200, ou seja, foi bem sucedida.7. Teremos um resultado com todas as informações disponíveis da oportunidade, como empresa vinculada à oportunidade, segmento, usuário, telefones, etc. Portanto, pode-se concluir que a ação automática está funcionando corretamente. Dica:  é possível visualizar todos os registros (logs) de ações automáticas realizadas, em andamento ou que apresentaram falha. Para saber mais, acesse este artigo.Em caso de dúvidas, chame nossa equipe no chat.