Atualizado em Sep 17, 2026

Requisição HTTP

Use esta ação quando precisar chamar uma API ou webhook externo a partir de um workflow ou ação de agente.

Melhor para

• Enviar dados para sistemas externos
• Buscar informações antes que passos posteriores continuem
• Buscar cargas pequenas (as respostas são limitadas a 5 MB — para downloads maiores para armazenamento use a ação Baixar para Armazenamento, actions/network/http/download-to-storage, que transmite arquivos de até 500 MB)

Campos principais

Campo	O que faz
Método HTTP	Escolhe o método HTTP, como GET ou POST
URL HTTP	O endpoint alvo
Propósito	Rótulo opcional do que a requisição faz, exibido nos logs
Cabeçalhos HTTP	Adiciona headers de requisição personalizados
Corpo da Solicitação HTTP	Envia dados para métodos como POST ou PATCH (oculto para GET)
Retornar como buffer	Retorna dados brutos do arquivo em vez de texto ou JSON
Ativar cache	Reutiliza respostas idênticas (mesmo método, URL, cabeçalhos e corpo). O cache é compartilhado entre execuções separadas para a mesma empresa + agente, e as entradas vivem por cerca de 10 minutos — uma requisição idêntica em uma execução posterior pode retornar uma resposta em cache

Restrições de URL

Apenas URLs http:// e https:// públicas são permitidas. Requisições para localhost, endereços de rede privados ou internos, e endpoints de metadados de nuvem são bloqueados, então a ação não consegue alcançar serviços em uma intranet ou VPN. As requisições expiram após 2 minutos.

O que passos posteriores podem usar

Resultados da requisição estão disponíveis em:

• step(N).status
• step(N).data
• step(N).headers

Dicas

• Armazene chaves de API e outros valores sensíveis de header como segredos em vez de texto simples.
• Use o modo buffer quando a resposta for um arquivo, imagem ou PDF pequeno (até 5 MB); para downloads maiores para armazenamento use a ação Baixar para Armazenamento (actions/network/http/download-to-storage, até 500 MB).
• Verifique o código de status antes de assumir que a requisição foi bem-sucedida.