Faça uma solicitação HTTP no Power Automate

Nesta postagem de blog, aprenderemos como criar uma solicitação HTTP com o Power Automate. As solicitações HTTP são usadas para transferir dados, mas não devem ser sua primeira solução. Sua primeira solução deve ser sempre procurar um conector para seu aplicativo. Você pode assistir ao vídeo completo deste tutorial na parte inferior deste blog.

Índice

• Power Automate e conectores
• Fazendo e recebendo uma solicitação HTTP
• Fluxos de Área de Trabalho
• Como funciona um fluxo de trabalho de solicitação HTTP
• Iniciando um fluxo em uma solicitação HTTP
• Analisando o arquivo JASON
• Usando o Aplicar a cada conector
• Implementando o fluxo de trabalho
• Conclusão

Power Automate e conectores

Um conector é a maneira do Power Automate se comunicar com outro aplicativo. O Power Automate já tem milhares de conectores disponíveis para você. Por exemplo, se você precisa automatizar algo relacionado a um aplicativo da Microsoft (Teams, SharePoint, OneDrive) ou outros aplicativos que possuem conectores (Dropbox, SAP), você deve sempre usar a abordagem do conector, e não a abordagem de solicitação HTTP .

Fazendo e recebendo uma solicitação HTTP

Se não houver um conector para ele, você poderá usar o HTTP. As solicitações HTTP são usadas pelo Power Automate para se comunicar com outro aplicativo que não possui um conector, mas pode ter o que chamamos de API REST .

Então, basicamente, o desenvolvedor do aplicativo expôs o aplicativo para que as pessoas possam fazer solicitações a ele e retornar dados de acordo com essas solicitações. Um exemplo é um software de CRM desenvolvido internamente para um cliente. Eles definitivamente não querem fazer um conector para o Power Automate, então permitem solicitações HTTP de várias fontes que podem executar ping no software CRM para uma lista de clientes. Essa lista de clientes será retornada por essa solicitação HTTP.

Fluxos de Área de Trabalho

Se não houver solicitações HTTP, você precisará usar algo chamado fluxos de área de trabalho . Os fluxos de desktop são muito poderosos porque permitem que você automatize quase tudo. Eles são muito semelhantes a uma macro do Excel onde você pode gravar, executar alguma ação e depois repeti-la. Eles são usados ​​se as pessoas desejam automatizar coisas que estão apenas na área de trabalho, como mover arquivos na área de trabalho ou abrir um aplicativo.

Como funciona um fluxo de trabalho de solicitação HTTP

Vamos entrar em um fluxo de trabalho HTTP e ver como ele funciona. Eu tenho meu Power Automate aberto, bem como o tutorial real para a API REST.

Como exemplo de solicitação HTTP, usarei um site que possui uma API onde posso dizer à API para me fornecer uma lista de usuários. Abaixo está a lista de e-mails ou clientes que temos em nossa empresa.

Novamente, esta é uma API à qual este desenvolvedor de aplicativos realmente me deu acesso. Eu fiz uma solicitação HTTP aqui e ela voltou para mim o JSON real. Posso copiar esse JSON para o que é chamado de Pretty Print .

Acabei de clicar em Make Pretty para que possamos ver como ele realmente se parece.

Podemos ver no lado direito que recebemos página por página, quantos clientes existem, total, total de páginas, bem como cada ID.

Para cada ID, obtemos seu e-mail, nome, sobrenome e avatar. São muitas informações para seis clientes dessa API que criamos.

Iniciando um fluxo em uma solicitação HTTP

Queremos ter um fluxo que funcione todas as manhãs. Este fluxo deve ser capaz de nos enviar esta lista de clientes na primeira página.

Primeiro, começo fazendo um gatilho manual para o fluxo. Esse fluxo só será executado quando eu clicar em um botão, mas também podemos alterá-lo para que o fluxo seja recorrente e seja executado todas as manhãs.

Temos então o conector HTTP onde implementamos o método. Existem dois métodos aplicáveis ​​às APIs: GET e POST . Há também PATCH e DELETE , mas raramente são usados.

Se você deseja obter informações de uma API, geralmente é por meio de GET ou POST . Se você estiver interessado em saber qual é a diferença entre GET e POST , eu realmente recomendo que você pesquise online sobre APIs RESTful .

Neste ponto, nosso desenvolvedor de aplicativos nos disse que fará APIs que aceitam solicitações GET. É por isso que usaremos GET como método e, em seguida, o URI na página um.

Também temos a opção de dar um corpo a essa API. Podemos dizer à API, por exemplo, que queremos apenas clientes que comecem com a letra F. Podemos adicionar argumentos ou parâmetros à nossa solicitação HTTP e, em seguida, a API aceita. Por enquanto, porém, estamos mantendo as coisas simples e não teremos nenhuma consulta corporal.

Depois de fazer essa solicitação, podemos produzi-la. Criei um chat para Brad Pitt, que é o gerente da minha empresa com o título de Test porque estamos apenas testando isso. Em seguida, postaremos o corpo (a saída dessa solicitação HTTP) para essa conversa.

Observe que este é um conteúdo dinâmico. Podemos ver o conector no conteúdo dinâmico, que nos devolve o corpo.

Isso retornará um monte de mumbo jumbo - é basicamente um arquivo JSON que não é realmente legível. É ótimo que Brad Pitt tenha conseguido, mas ele não será capaz de entendê-lo ou saber o que significa.

Analisando o arquivo JASON

A próxima etapa é analisar esse arquivo JSON. O conector Parse JSON retorna um objeto JSON, que é uma maneira de percorrer esses clientes com muito mais facilidade. Dei a esse conector o corpo (que é a saída da solicitação HTTP) e, em seguida, esse conector me dará acesso a coisas como ID, e-mail, nome e sobrenome.

Então, em vez de termos que passar pelo código e analisá-lo, o Power Automate faz esse processo para nós com esse conector muito legal.

Usando o Aplicar a cada conector

Usaremos Aplicar a cada conector porque, para cada cliente que recebermos nesse corpo, queremos enviar o nome, sobrenome e e-mail. Na imagem abaixo, temos um apply para cada conector de controle onde postamos uma mensagem para Brad Pitt. Postamos como bot de fluxo e o destinatário é Brad Pitt. Também temos acesso ao nome, sobrenome, avatar, texto técnico da URL e e-mail.

Não teríamos acesso a esses elementos reais se não ativássemos essa conexão Parse JSON . Esse conector é muito importante porque podemos realmente exibir o nome, o sobrenome e assim por diante.

Na parte da mensagem, mostraremos o nome, o sobrenome e o e-mail.

Esse é todo o nosso fluxo. Novamente, é principalmente uma solicitação HTTP acionada onde temos uma solicitação GET para a URL. O retorno que obtivermos será enviado para o bate-papo de uma equipe. Em seguida, analisamos esse arquivo JSON e enviamos uma mensagem para cada cliente contendo seu nome, sobrenome e e-mail.

Implementando o fluxo de trabalho

Vamos observar esse fluxo de trabalho em ação clicando em Salvar e depois em Testar . Neste ponto, todo o processo consiste em fazer a solicitação HTTP, retornar essa solicitação e enviá-la para o Teams.

Podemos ver que uma mensagem foi enviada agora há pouco contendo a lista real de clientes. Em seguida, podemos ver para cada cliente, obtemos seu primeiro nome, sobrenome e também seu e-mail.

Recebemos seis clientes e isso corresponde exatamente ao que temos em nosso JSON.

E, obviamente, também recebemos a mensagem JSON completa, mas esta é difícil de ler.

Vejo muitas pessoas fazendo solicitações HTTP o tempo todo e recebendo os dados de volta para elas. Vale a pena analisar os dados, especialmente se o recebimento dos dados estiver no formato JSON, para que você possa entendê-los e transformá-los em algo que possa usar.

Gatilho HTTP do Microsoft Flow | Um Tutorial do Power Automate
Configuração e teste do fluxo de trabalho de aprovação no Power Automate

Conclusão

Este é um exemplo de como fazer uma solicitação HTTP , enviar uma solicitação e receber os dados . Mas uma coisa que quero especificar é que você também pode fazer solicitações HTTP fazerem qualquer coisa.

Por exemplo, como desenvolvedor de aplicativos, podemos criar um endpoint HTTP que crie um novo cliente no software CRM. Podemos criar um fluxo para que, sempre que alguém adicionar um cliente ao SharePoint, o fluxo seja acionado. Em seguida, as informações são passadas para uma solicitação HTTP com as propriedades. É assim que você pode transferir informações do SharePoint para seu aplicativo de terceiros que aceita solicitações de API.

Se você gostou do conteúdo abordado neste tutorial específico, assine o canal de TV LuckyTemplates. Temos uma grande quantidade de conteúdo sendo publicado o tempo todo, meu e de vários criadores de conteúdo, todos dedicados a melhorar a maneira como você usa o LuckyTemplates e a Power Platform.

henrique