Node HTTP request no n8n: guia completo passo a passo

Node HTTP request do n8n: guia completo node http request do n8n guia completo

Para fazer requisições HTTP com Node.js dentro do n8n, basta usar o node “HTTP Request”. Ele aceita URL, método, cabeçalhos e corpo, tudo configurável via expressões. Assim você consome APIs externas sem sair da interface visual. Este guia completo mostra como usar o node HTTP request do n8n de forma prática.

O fluxo fica mais rápido porque o n8n executa o código Node.js nativamente, sem precisar de plugins adicionais. Você controla timeout, retries e tratamento de erros direto no node.

Com esse guia passo a passo você monta a chamada, adiciona autenticação e depura problemas como quem programa em código puro.

Node HTTP request do n8n: guia completo passo a passo

O node HTTP Request permite que você envie chamadas REST usando o runtime Node.js do n8n. Use‑o quando precisar de flexibilidade de cabeçalhos ou de manipular o payload antes de enviar.

Node.js traz suporte a streams e a bibliotecas nativas como https, garantindo performance igual a scripts locais. Instale o n8n gratuitamente e comece a testar.

Para detalhes de cada campo, consulte a documentação oficial do n8n.

Curiosidade: o node HTTP Request reutiliza conexões TCP por até 5 min, reduzindo latência em chamadas frequentes.

Configurando o node HTTP Request: primeiros passos

Crie um novo node “HTTP Request” e preencha os campos essenciais: URL, método, headers e body. Use expressões como {{ $json["id"] }} para inserir valores dinâmicos.

Arraste o node para o canvas e clique em “Add Node”.
Em “URL”, cole o endpoint da API (ex.: https://api.exemplo.com/v1/resource).
Selecione o método (GET, POST, PUT, DELETE).
Em “Headers”, adicione pares chave‑valor; use Content-Type: application/json para JSON.
Se precisar enviar corpo, escolha “JSON” em “Body Parameters” e preencha os campos.

Parâmetros mais usados:

queryString – parâmetros na URL.
json – objeto JSON no corpo.
binaryData – arquivos binários.
options – timeout, followRedirects.

Curiosidade: ao usar “{{ $now }} em um header, o n8n injeta a data/hora atual no formato ISO 8601.

Autenticação e segurança nas requisições

Você pode proteger a chamada adicionando Bearer Token, Basic Auth ou API Key diretamente nos headers ou usando credenciais armazenadas no n8n.

Para credenciais, crie um “Credential” do tipo “HTTP Basic Auth” ou “OAuth2” e selecione‑lo no campo “Authentication” do node.

Tipo	Como aplicar	Onde armazenar
Bearer Token	Header `Authorization: Bearer {{ $credentials.token }}`	Credential “OAuth2 Access Token”
Basic Auth	Campo “Authentication” → “Basic Auth”	Credential “HTTP Basic Auth”
API Key	Header ou queryString definido manualmente	Credential “API Key” (custom)

Exemplo: Authorization: Bearer {{ $credentials.openaiApiKey }} usando a credencial “OpenAI API Key”.

Curiosidade: o n8n criptografa credenciais em repouso, mas recomenda‑se usar variáveis de ambiente para chaves sensíveis.

Tratamento de erros e debug

Capture códigos de status usando a expressão {{$node["HTTP Request"].json["statusCode"]}} e configure “Continue on Fail” para evitar interrupções.

Para timeout, ajuste “Options → Timeout (ms)” e use “Retry On Fail” para tentativas automáticas. Adicione um node “Error Trigger” após o HTTP Request para centralizar falhas.

Para depurar, insira um node “Set” com console.log($json) ou use o painel “Execution” para visualizar logs detalhados.

Veja mais sobre erros comuns em nosso artigo de erros no n8n.

Curiosidade: ao habilitar “Response Format → Full Response”, o n8n devolve cabeçalhos, status e body em um único objeto, facilitando inspeções avançadas.

Integração ChatGPT com node HTTP Request no n8n

Você pode chamar a API ChatGPT usando o node “HTTP Request” e receber a resposta em JSON. Basta montar o payload, inserir a chave da OpenAI nos headers e tratar o retorno no fluxo.

Crie um node “Set” chamado Prompt e defina prompt com {{ $json["texto"] }} ou texto fixo.
Adicione o node “HTTP Request”:
- URL: https://api.openai.com/v1/chat/completions
- Método: POST
- Headers:
  
  Header Valor
  
  Content-Type application/json
  
  Authorization Bearer {{ $credentials.openaiApiKey }}
- Body (JSON):
```
{
  "model": "gpt-3.5-turbo",
  "messages": [
    { "role": "user", "content": "{{ $node[\"Prompt\"].json[\"prompt\"] }}" }
  ],
  "temperature": 0.7
}
```
Conecte um node “Set” chamado Resposta e extraia {{$json["choices"][0]["message"]["content"]}} do output do HTTP Request.
Opcional: use “Response Format → Full Response” para debugar cabeçalhos e status.

Header	Valor
Content-Type	application/json
Authorization	Bearer {{ $credentials.openaiApiKey }}

Curiosidade: o campo model aceita “gpt-4” se sua conta tiver acesso, trazendo respostas mais detalhadas.

Boas práticas e otimizações para produção

Em produção você deve garantir segurança, performance e controle de custos. Siga estas recomendações para evitar gargalos.

Limpeza de dados: valide o prompt antes de enviar; remova caracteres inesperados.
Credenciais reutilizáveis: armazene a API Key em um “Credential” do tipo “OAuth2 Access Token” e referencie‑a nos headers.
Limites de taxa: respeite o rate‑limit da OpenAI (120 req/min). Use “Retry On Fail” com back‑off exponencial.
Caching opcional: guarde respostas em um node “Cache” (Redis) quando o prompt for repetido.
Hospedagem: em self‑hosted ajuste maxSockets no http.globalAgent para 50 conexões simultâneas; na cloud, habilite autoscaling para picos de carga.

Curiosidade: o n8n permite definir “Rate Limit” no node “HTTP Request” para throttling automático, evitando bloqueios da OpenAI.

Recursos avançados: combinando com outros nodes e IA

Depois de obter a resposta do ChatGPT, encadeie nodes de transformação ou chame outras APIs de IA para enriquecer o fluxo.

Node “Function”: formate a resposta em markdown ou extraia palavras‑chave.
Node “SplitInBatches”: processe múltiplos prompts em paralelo, respeitando limites de taxa.
Integração Gemini: use outro “HTTP Request” apontando para https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent e combine as respostas.
Perplexity AI: chame https://api.perplexity.ai/chat/completions para buscas contextuais.
WhatsApp automático: encadeie o node “ChatGPT” com o node “Twilio” ou artigo sobre IA no WhatsApp para enviar respostas em tempo real.

Curiosidade: ao ativar “Execute Once” em um node “Set”, você pode gerar um prompt estático que serve como “system prompt” para todas as chamadas subsequentes.

Perguntas frequentes sobre node http request do n8n guia completo

O que é o node http request no n8n?

É um node que permite enviar requisições HTTP/HTTPS usando o runtime Node.js do n8n, configurando URL, método, cabeçalhos e corpo.

Como configurar um node HTTP Request no n8n?

Arraste o node, preencha URL, método, headers e body; use expressões como {{ $json["id"] }} para inserir valores dinâmicos.

É possível usar autenticação bearer token no node HTTP Request?

Sim, basta adicionar o header Authorization: Bearer {{ $credentials.token }} ou usar credenciais OAuth2 armazenadas no n8n.

Qual a diferença entre o node HTTP Request e o node HTTP Trigger?

HTTP Request envia chamadas para APIs externas, enquanto HTTP Trigger aguarda chamadas inbound para iniciar um fluxo.

Como tratar erros de timeout nas requisições HTTP do n8n?

Configure o campo Options → Timeout (ms) e habilite Retry On Fail; use um node Error Trigger para capturar falhas.

Posso usar variáveis de ambiente no node HTTP Request?

Sim, referencie variáveis com {{ $env.VAR_NAME }} nos campos de URL, headers ou body.

Como depurar uma chamada API que falhou no n8n?

Ative “Response Format → Full Response”, adicione um node Set com console.log($json) ou use o painel Execution para ver logs detalhados.

É necessário instalar dependências adicionais para usar Node.js no n8n?

Não. O n8n já inclui o runtime Node.js e as bibliotecas padrão; basta usar o node HTTP Request.

Domine as requisições HTTP no n8n e leve sua automação ao próximo nível

Com este guia você aprendeu a criar, configurar e depurar o node HTTP Request, aplicar autenticação segura e integrar APIs avançadas como a do ChatGPT. Agora, suas automações podem conversar com qualquer serviço externo de forma confiável e escalável.

Configure URLs e métodos rapidamente.
Use credenciais e variáveis de ambiente para segurança.
Trate erros de timeout e retries de forma automática.
Combine o node com IA e outros nodes para fluxos poderosos.

Quer aprofundar ainda mais? Explore a categoria n8n e descubra tutoriais, casos de uso e dicas avançadas.

Quer mais sobre o assunto? Veja todos os artigos de n8n ou a lista completa de artigos.