Builder · Atualizado em 06/10/2026
Como adicionar conteúdo HTTP no Builder
Entenda o que o Conteúdo HTTP faz, preencha URL, MIME type, cabeçalhos e timeout, e conheça as regras de https e o limite de 1 MB.
O Conteúdo HTTP busca, no momento do envio, o conteúdo de uma mensagem em um endereço seu. Em vez de escrever o texto no Builder, você aponta para uma URL que devolve o texto, o link de mídia ou outro conteúdo, e o Pipe entrega ao contato o que ela responder.
Quando usar
- Quando a mensagem muda com frequência e vem de um sistema seu, como um cardápio do dia ou um aviso de campanha.
- Quando o conteúdo é grande ou controlado por outra equipe, e você não quer reeditar o fluxo a cada mudança.
Para conteúdo que já está em uma variável do fluxo, use o Conteúdo dinâmico.
Pré-requisitos
- Acesso de edição a um fluxo no Builder.
- Um endereço
httpspúblico que responda a uma consulta GET com o conteúdo. - Saber o tipo (MIME type) do que o endereço devolve.
Passo a passo
- No canvas, clique no bloco e abra a aba Conteúdo.
- Clique em + Adicionar conteúdo e escolha Conteúdo HTTP.
- No cartão aberto, preencha o campo URL com o endereço completo, começando com
https://. - Em MIME type, informe o tipo do conteúdo devolvido. O valor inicial é
text/plain. - Em Cabeçalhos (JSON), informe os cabeçalhos da consulta como um objeto JSON, se o seu endereço exigir algum. O valor inicial é
{}. - Em Timeout (segundos), ajuste o tempo máximo de espera, se necessário. O valor inicial é 60.
- Confira se o cartão não ficou com borda vermelha.
- Teste o bloco no painel de teste e depois no canal.
Campos da tela
| Campo | O que faz |
|---|---|
| URL | Endereço consultado no envio. Obrigatório |
| MIME type | Tipo do conteúdo que a resposta representa. Obrigatório |
| Cabeçalhos (JSON) | Pares nome e valor enviados na consulta. Precisa ser JSON válido, com valores em texto |
| Timeout (segundos) | Tempo máximo de espera pela resposta. Padrão: 60 |
MIME types que o canal envia
O tipo informado precisa ser um dos que o canal do Pipe sabe enviar:
| MIME type | Conteúdo |
|---|---|
| text/plain | Texto |
| application/vnd.lime.select+json | Menu ou Quick reply |
| application/vnd.lime.media-link+json | Mídia por link |
| application/vnd.lime.input+json | Pedido de localização |
| application/vnd.lime.location+json | Ponto no mapa |
| application/vnd.lime.web-link+json | Link |
| application/vnd.lime.chatstate+json | Indicador de digitação |
Como funciona o envio
- O fluxo chega no cartão e o Pipe faz uma consulta GET ao endereço, com os cabeçalhos informados.
- Se a resposta for bem-sucedida e tiver até 1 MB, o corpo vira o conteúdo da mensagem, no tipo informado.
- O Pipe entrega essa mensagem ao contato.
Se o endereço falhar, demorar além do timeout ou devolver algo grande demais, o envio falha com a mensagem "Conteúdo HTTP não pôde ser resolvido" seguida do motivo.
Exemplo na Loja Girassol
A Loja Girassol tem um endereço próprio, fictício, https://exemplo.girassol.test/aviso-do-dia, que devolve um texto curto. O cartão usa MIME type text/plain, e o contato recebe o aviso atualizado a cada conversa, sem que ninguém precise editar o fluxo.
Resultado esperado
O contato recebe o conteúdo que o endereço devolveu no momento do envio.
Boas práticas
- Mantenha o endereço rápido: o contato espera pela resposta.
- Ajuste o timeout para um valor próximo do que seu serviço leva para responder.
- Teste com o conteúdo real que o endereço devolve, não só com um exemplo.
- Não coloque chaves ou senhas na URL.
Limitações
- Apenas consulta GET.
- Apenas endereços https; localhost e redes privadas são recusados.
- Resposta de até 1 MB.
- O MIME type precisa estar na lista de tipos que o canal envia.
Problemas comuns
- "Conteúdo HTTP: URL obrigatória.": preencha o campo URL.
- "Conteúdo HTTP: cabeçalhos devem ser JSON válido.": revise aspas e vírgulas. O valor padrão é
{}. - "O Conteúdo HTTP resolveu um tipo que o canal não envia": o MIME type informado não está na tabela acima.
- "A resposta ultrapassa o limite de 1 MB.": o endereço devolve conteúdo demais. Devolva um conteúdo menor.
- "A URL precisa usar HTTPS.": troque o endereço por um que use https.
Próximos passos
Perguntas frequentes
O Conteúdo HTTP faz POST?
Não. Ele faz uma consulta GET ao endereço informado, no momento do envio, e entrega a resposta ao contato.
Que MIME type devo informar?
O tipo do conteúdo que o endereço devolve e que o canal sabe enviar: por exemplo text/plain para texto. O valor inicial é text/plain.
Qual o limite de tempo?
O campo Timeout (segundos) vem com 60. Se você deixar em branco ou colocar um valor inválido, o Pipe usa 60 segundos.
Qual o tamanho máximo da resposta?
1 MB. Respostas maiores fazem o envio falhar.
Posso chamar um endereço da minha rede interna?
Não. O endereço precisa ser https e não pode apontar para localhost nem para rede privada.
Esse artigo foi útil?
Obrigado pelo retorno!