Requisição REST
O módulo Requisição REST permite chamar qualquer sistema externo através de uma requisição HTTP, enviando dados e recebendo a resposta diretamente no fluxo. É o módulo mais flexível para integrar o Hyperflow Integrações com sistemas que não têm um módulo específico já pronto.
🧭 Como acessar
No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Integração (identificada pela cor azul).
Arraste o módulo Requisição REST para a área de trabalho do fluxo.
Evite usar diretamente na URL de destino uma variável que vem de algo digitado pelo cliente na conversa, sem validação — isso pode fazer a requisição ser enviada para um endereço não previsto.
🔍 Conhecendo o módulo
Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.
🔗 URL e método
No campo URL, informe o endereço do sistema externo que será chamado (aceita variáveis do fluxo). No campo Método, escolha entre GET, POST, PUT, PATCH ou DELETE.
Você pode clicar em Importar cURL para colar um comando cURL copiado de outra ferramenta e preencher automaticamente a URL, o método, os cabeçalhos e o corpo da requisição.
📋 Cabeçalhos e corpo
Cabeçalhos — informações extras enviadas junto da requisição, em formato JSON (ex.:
{"Authorization": "Bearer {{env.token}}"}).Corpo — os dados enviados na requisição, em formato JSON. Só é considerado nos métodos que enviam dados (POST, PUT, PATCH).
⚙️ Opções avançadas
Tempo limite
Tempo máximo, em milissegundos, que o módulo espera pela resposta antes de considerar a chamada como falha.
Permitir conexões inseguras
Ignora a verificação do certificado de segurança do site chamado. Use apenas em casos específicos, como testes internos — evite ativar para sistemas públicos.
Ativar novas tentativas
No momento, essa opção não tem efeito: se a requisição falhar, ela não é repetida automaticamente, mesmo com a chave ativada.
🔀 Saídas do módulo
O módulo tem duas saídas:
Sucesso — a chamada teve uma resposta de sucesso (código de status HTTP na faixa 200-299).
Erro — qualquer outra situação: erro do sistema chamado (4xx, 5xx), tempo limite esgotado, ou falha de conexão.
💡 Caso de uso
Cenário: uma empresa quer consultar o endereço de um cliente automaticamente a partir do CEP informado na conversa, usando um serviço externo de consulta de CEP.
Configuração:
Adicione o módulo Requisição REST ao fluxo.
No campo URL, informe o endereço do serviço de consulta, incluindo o CEP:
https://exemplo-cep.com/{{input.cep}}.No campo Método, selecione GET.
Conecte a saída Sucesso a um módulo que use o endereço retornado na conversa.
Conecte a saída Erro a uma mensagem informando que não foi possível localizar o CEP.
Resultado: o fluxo consulta automaticamente o endereço a partir do CEP informado, sem necessidade de um módulo específico para esse serviço.
📌 Dicas úteis
Use o campo Cabeçalhos para enviar tokens de autenticação ou outras informações exigidas pelo sistema externo.
Sempre conecte a saída Erro a algum tratamento, já que chamadas a sistemas externos podem falhar por diversos motivos (indisponibilidade, tempo limite, dados inválidos).
Ajuste o Tempo limite conforme a velocidade esperada de resposta do sistema chamado, evitando que o fluxo fique travado por muito tempo.
Evite usar diretamente valores digitados pelo cliente na URL de destino sem alguma validação prévia.
📝 Resumo
O módulo Requisição REST chama qualquer sistema externo por HTTP, enviando e recebendo dados no fluxo.
Os campos principais são URL, Método, Cabeçalhos e Corpo.
É possível importar a configuração a partir de um comando cURL.
A saída Sucesso é ativada para respostas na faixa 200-299; qualquer outra situação segue pela saída Erro.
Last updated