HTTP Request · http

Referência do nó

Kind:httpCategoria:Dados

Para que serve

Imagina que você precisa consultar o rastreamento de um pedido num site de transportadora. Você abre o site, digita o código e recebe o resultado. O nó HTTP faz exatamente isso — só que de forma automática, dentro do fluxo, consultando qualquer serviço que tenha uma API na internet.

Quando usar

• Buscar dados de um sistema externo (ERP, CRM, plataforma de e-commerce)
• Enviar informações para um webhook de outro serviço
• Consultar preços, status de pedidos ou dados cadastrais em tempo real
• Acionar uma automação em outra ferramenta (Zapier, Make, n8n, etc.)
• Criar, atualizar ou deletar registros em sistemas externos

---

Passo a passo

1. ·
   Arraste o nó **HTTP Request** para o canvas e conecte-o ao bloco anterior.
   

   

   CAPTURAR: nó HTTP Request no canvas com conexão chegando de um nó anterior

2. ·
   Escolha o **Método**: GET, POST, PUT, PATCH, DELETE ou HEAD.
3. ·
   Informe a **URL** do endpoint. Pode usar variáveis do fluxo: https://api.meu-sistema.com/clientes/{{contact.id}}
4. ·
   Se precisar de autenticação, adicione os **Headers** necessários (ex.: Authorization: Bearer {{token}}).
   

   

   CAPTURAR: painel do nó HTTP com URL preenchida, método POST selecionado e um header de autorização configurado

5. ·
   Para POST/PUT/PATCH, preencha o **Body** com o JSON que quer enviar.
6. ·
   Salve e conecte a saída ao próximo nó. Os dados retornados ficam disponíveis como {{http.body}} (ou o nome que você der ao nó).

---

Campos

Campo	O que faz
Método	Tipo de requisição: GET (buscar), POST (criar), PUT (substituir), PATCH (atualizar parcialmente), DELETE (remover), HEAD (verificar)
URL	Endereço do endpoint — suporta expressões {{ }}
Headers	Cabeçalhos HTTP (autenticação, tipo de conteúdo, etc.)
Params (Query String)	Parâmetros que vão na URL após ? — ex.: ?page=1&limit=10
Body	Corpo da requisição (JSON, formulário ou texto) — disponível nos métodos POST, PUT, PATCH
Timeout	Tempo máximo de espera pela resposta (em segundos)

---

Exemplo

Cenário: buscar o nome do plano que o cliente tem num sistema externo.

Configuração:

• Método: GET
• URL: https://api.meu-crm.com/clientes/{{contact.external_id}}/plano
• Header: Authorization: Bearer {{config.api_token}}

Uso da resposta: No nó seguinte, acesse {{http.body.plano.nome}} para usar o nome do plano na mensagem.

CAPTURAR: resultado do nó HTTP sendo usado num nó de enviar mensagem, com a expressão <span v-pre>{{http.body.plano.nome}}</span> no campo de texto

Dica

Nos métodos GET e DELETE, você não precisa preencher o Body. Use Query Params para filtrar resultados.

Atenção

Se a API exigir autenticação por OAuth2 ou certificado, verifique se o sistema suporta esse formato antes de configurar. Para APIs com autenticação complexa, considere usar um servidor MCP (veja Ferramenta MCP).