Principal Construindo Fluxos Como enviar arquivos pelo bloco HTTP request

Como enviar arquivos pelo bloco HTTP request

Última atualização em Oct 06, 2026

Quando usar

  • A ClaudIA precisa mandar um documento do cliente (PDF, imagem, planilha) para outro sistema, como Pipefy, CRM ou ERP.

  • O sistema de destino aceita só o arquivo, não o link.

Pré-requisitos

  • A ferramenta recebe o link do arquivo numa variável (ex.: url_documento).

Para a ClaudIA repassar o link do anexo do cliente para a ferramenta, o envio da URL do arquivo precisa estar ativo no seu projeto. Se não tiver certeza, fale com o time da Cloud Humans.

Passo a passo

Etapa 1 — Abrir o bloco HTTP request

Em ClaudIA → Ferramentas, abra a ferramenta e clique no bloco HTTP request (ou arraste um novo da barra lateral).

Etapa 2 — Montar o body como sempre

Em Advanced configuration → Body, ligue Custom body e escreva o body normalmente, usando a variável do arquivo onde iria o link:

{"cliente": "{{nome_cliente}}", "documento": "{{url_documento}}"}

Etapa 3 — Ligar "Enviar arquivos"

Logo abaixo do body, ligue Enviar arquivos e escolha a variável que guarda o link do arquivo. Pode adicionar mais de uma. Na hora do envio, no lugar do link vai o arquivo.

Etapa 4 — Montar no formato que o sistema espera

O sistema pede Como montar
Arquivo puro (upload em URL pré-assinada, ex.: Pipefy) Body só com a variável: {{url_documento}}
Formulário (multipart) Header Content-Type: multipart/form-data e body em JSON. Cada chave vira um campo do formulário
JSON com o arquivo em base64 Body em JSON normal. O arquivo vai em base64 no lugar da variável

Etapa 5 — Testar

Em Variable values for test, coloque um link de arquivo de teste na variável e clique em Test the request. Se o sistema responder 2xx, está funcionando.

Observações

  • Mais de um arquivo: adicione outras variáveis, ou use uma variável com vários links (uma lista).

  • Limite: até 100 MB por envio, somando todos os arquivos.

  • Tempo limite: com o timeout padrão do bloco, o envio de arquivo espera até 2 minutos. Se você mudar o timeout no bloco, vale o que colocar.

  • Se der erro no link do arquivo (expirado, sem acesso), o bloco devolve 502 com o motivo. Se o sistema de destino recusar, volta o status dele.

  • Dica: no Tool Output, devolva algo claro, como {"enviado": true}, em vez da resposta crua do sistema. Assim a ClaudIA sabe o que responder ao cliente.

  • Com Enviar arquivos desligado, o bloco funciona igual antes: o link vai como texto.

  • Não funciona com GET. Use POST, PUT ou PATCH.