HTTP Request
O bloco HTTP Request faz o fluxo conversar com outro sistema sem escrever código: ele chama o endereço de uma API, envia os dados do atendimento e guarda a resposta em variáveis para os próximos blocos usarem. É o caminho para consultar um pedido no seu sistema, cadastrar um lead no CRM externo ou avisar uma automação.
Tudo é configurado em três abas: Requisição, Autenticação e Resposta.
Categoria: Dados - Integração
Ideal para:
Consulta de pedido: busca o status no sistema da loja e responde ao cliente com ele.
Cadastro externo: envia nome e telefone do cliente para um CRM ou planilha.
Aviso para automação: dispara um fluxo do n8n, Make ou outra ferramenta.
Resumo Prático
Acesse o menu FlowBuilder Nativo e abra o fluxo no editor.
Clique no + e escolha HTTP Request.
Preencha Requisição, Autenticação e Resposta, use Testar Requisição e clique em Adicionar.
A aba Requisição
Acesse o menu FlowBuilder Nativo → editar fluxo → + → HTTP Request
Método: GET, POST, PUT, PATCH ou DELETE, conforme a API pede.
URL: o endereço chamado. Ex.: https://api.exemplo.com/endpoint.
Headers: pares de nome e valor enviados junto, como Content-Type e application/json.
Corpo da Requisição: aparece nos métodos que enviam dados. O Tipo do Corpo pode ser JSON, Form URL-Encoded, Form-Data (multipart), Texto Raw ou Sem corpo.
Use {{variavel}} ou %variavel% para mandar dados do atendimento, na URL ou no corpo. Ex.: https://api.com/users/%number% ou {"name": "{{name}}"}.
A aba Autenticação
Tipo de Autenticação: Sem Autenticação, Bearer Token, Basic Auth (Usuário/Senha) ou API Key. Escolha o que a API exige; sem autenticação, a requisição vai sem credenciais.
A aba Resposta
Formato da Resposta: como o retorno da API é guardado.
Variável Única (resposta inteira): a resposta completa vai para uma variável só, informada em Nome da Variável. O nome sugerido é httpResponse, e nos blocos seguintes o valor é usado com {{httpResponse}}.
Objeto (mapear para N variáveis): cada campo da resposta vai para uma variável própria. Em Mapeamentos, informe o JSON Path do campo e o Nome da Variável. Use ponto para campos dentro de campos, como data.user.name.
Testar antes de adicionar
O painel Testar Requisição, no rodapé da janela, executa a chamada com o que foi preenchido. Use antes de clicar em Adicionar, para conferir se a API responde e o que ela devolve.
Para finalizar, clique em Adicionar.
Dúvidas Comuns
Qual a diferença entre o bloco HTTP Request e o bloco Execução de Código JS? O HTTP Request monta a chamada pelos campos, sem código. O Execução de Código JS é para quem prefere escrever a chamada, ou outro tratamento, em JavaScript.
Como uso a resposta do HTTP Request num bloco de mensagem? Pelo nome da variável escolhida na aba Resposta. Com Variável Única, use {{httpResponse}}; com Objeto, use o nome de cada variável mapeada.
Posso mandar o telefone do cliente para a API no HTTP Request? Pode. Use as variáveis do atendimento na URL ou no corpo, como %number%.
Erros Comuns
Esquecer o Content-Type: a API recusa o corpo em JSON. Solução: em Headers, informe Content-Type com o valor application/json.
Mapear o caminho errado: a variável fica vazia porque o JSON Path não existe na resposta. Solução: use Testar Requisição, veja a resposta real e copie o caminho dela.