Todas as categorias > Flow > Entendendo a ação "Enviar requisição" presente no Flow

Entendendo a ação "Enviar requisição" presente no Flow

CRIADO por Helison Zurc

Esse artigo é sobre uma ação presente no recurso Flow. Clique aqui para conhecer mais sobre ele.

Através dessa ação é possível enviar requisições baseadas no contexto atual/configurado para um sistema externo. Dessa maneira você pode efetuar consultas a dados externos para utilizá-las no Flow, bem como alterar, atualizar e enviar informações para outras aplicações.

Essa ação possui as seguintes opções:

Método e URL: Defina o método e a URL utilizada no envio das requisições

Métodos: Aqui você seleciona dentre os métodos disponíveis. São eles: GET, POST, DELETE, PUT, PATCH
URL: Aqui será inserido o Endpoint da sua aplicação.

Cabeçalho (Header): É uma forma de especificar a requisição que será feita. A inserção dos dados é realizado no formato chave-valor, com possibilidade da adição de novos parâmetros.

Corpo (Body): Aqui serão inseridas as informações dos conteúdos que serão enviados. Você pode escolher entre os Layouts intitulados Chave-valor e Raw:

Tipo de Layout:

Chave-valor: Insira o corpo da requisição no formato Chave e Valor, com possibilidade de adicionar novos parâmetros. Sendo “Chave” o nome para identificação do dado que será informado no campo “Valor”; e “Valor” a variável de contexto ou o conteúdo do dado que será requisitado.
Raw: Nesse método o corpo da requisição é inserido em um formato de texto (JSON) que possa ser facilmente compreendida por sua aplicação.

Processar resposta: Com esta funcionalidade, durante a execução do Flow, será possível alterar o contexto a partir da resposta da requisição para o endpoint configurado na ação. Esse retorno poderá alterar ou criar variáveis no contexto do Flow. Para isso o endpoint deve retornar um JSON no formato adequado, contendo um array de variáveis no formato chave: valor. Caso no array retornado, exista uma chave que não conste no Flow atual, uma variável correspondente será criada, com o mesmo nome da chave recebida.

Formato do JSON na linguagem JS:

{
   "variable_name1": "variable_value1",
   "variable_name2": "variable_value2",
   "variable_name3": "variable_value3",
   "variable_name4": "variable_value4",
   "variable_name5": "variable_value5",
"variable_name6": "variable_value6",
   "variable_name7": "variable_value7"
}

Todos os campos no primeiro nível do JSON (raiz) serão transformados em variáveis do contexto. Caso o JSON possua um campo "variables", os termos deste terão prioridades. Ou seja, caso possua o mesmo campo dentro de “variables” e fora, o valor configurado dentro de “variables” é que será atribuído à variável de contexto.

Exemplo aplicado: foi enviada uma requisição através da Huggy contendo o CEP do cliente para o endpoint configurado. Na API desse endpoint, foi configurado para que, com esse CEP, sejam retornados dados como nome da rua, bairro, cidade e estado. Através do processar resposta, variáveis com essas informações, caso não constem no Flow atual, poderão serão criadas automaticamente e as mesmas poderão ser exibidas para o cliente.

Gostaria de ver na prática o funcionamento do envio de requisição? Preparamos um material com modelos prontos para você baixar e testar as vantagens dessa ação. Clique aqui e conheça.