Skip to main content

​
Como Funciona

O nó Requisição HTTP conecta o workflow a qualquer serviço externo que exponha uma API REST. A execução é síncrona: o fluxo aguarda a resposta antes de avançar para o próximo nó. O que o nó suporta:
  • Cinco métodos HTTP: GET, POST, PUT, PATCH e DELETE
  • Headers customizados com atalhos para os padrões mais comuns (Content-Type, Authorization, Accept, X-API-Key)
  • Corpo da requisição em JSON, Form Data ou texto livre — disponível apenas para POST, PUT e PATCH
  • Timeout configurável de até 30000ms (30 segundos)
  • Retry automático de 0 a 3 tentativas com intervalo configurável entre elas
  • Templates {{ }} em todos os campos — URL, headers e corpo aceitam referências dinâmicas a dados do fluxo

​
Opções de Configuração

Aba Requisição:
  • Método e URL — escolha o verbo HTTP e insira a URL completa; templates como {{ $trigger.body.id }} funcionam diretamente na URL
  • Tipo de corpo — json (editor textarea com highlight), form (pares chave/valor codificados como application/x-www-form-urlencoded), text (livre) ou none
  • Corpo — editor com suporte a templates {{ }} — resolução ocorre em tempo de execução antes do envio
Aba Headers:
  • Adicione headers via atalhos de presets ou como campos customizados
  • Para valores sensíveis, use {{ $vars.token }} em vez de strings fixas
Aba Avançado:
  • Timeout — mínimo 1000ms, máximo 30000ms
  • Retry — 0, 1, 2 ou 3 tentativas; intervalo entre retries de 100ms a 10000ms
Evite inserir tokens e senhas diretamente na URL ou no corpo. Prefira variáveis de workflow definidas em um nó Definir Variável anterior ou recuperadas de integrações seguras configuradas no workspace.

​
Casos de Uso Comuns

O nó HTTP é versátil o suficiente para cobrir a maioria das integrações sem código:
  • Buscar dados antes de agir — faça um GET na API do ERP com o ID do pedido recebido via webhook e use o retorno nos nós seguintes via {{ $json.body.campo }}
  • Registrar eventos em sistemas externos — envie um POST para um CRM de terceiros com dados do contato coletados durante a conversa, usando {{ $trigger.parameters.email }} no corpo
  • Encadear chamadas dependentes — primeiro GET para buscar dados de autenticação, depois POST para a API principal usando o token retornado pelo primeiro nó via {{ node_auth.body.access_token }}