EntrarTeste grátis

Builder · Atualizado em 06/10/2026

Como adicionar mídia a um bloco no Builder

Envie imagem, vídeo, áudio, documento ou figurinha por link, com legenda opcional, e conheça formatos e limites de tamanho.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Passo a passo
  4. Campos da tela
  5. Formatos e limites
  6. Exemplo na Loja Girassol
  7. Resultado esperado
  8. Boas práticas
  9. Limitações
  10. Problemas comuns
  11. Próximos passos
  12. Perguntas frequentes

Mídias deixam a conversa mais clara: uma foto do produto, um PDF com o catálogo, um vídeo de demonstração. No Builder, cada tipo de mídia é um cartão próprio dentro do bloco, e todos funcionam do mesmo jeito: você informa um link e, se quiser, uma legenda.

Quando usar

  • Imagem: foto de produto, mapa, comprovante ilustrativo.
  • Vídeo: demonstração curta.
  • Áudio: mensagem de voz ou instrução falada.
  • Documento: catálogo, manual, tabela de medidas.
  • Figurinha: reação visual leve, quando faz sentido para a marca.

Pré-requisitos

  • Acesso de edição a um fluxo no Builder.
  • O arquivo hospedado em um endereço https acessível pela internet.
  • O formato do arquivo na lista aceita (tabela abaixo).

Passo a passo

  1. No canvas, clique no bloco que vai enviar a mídia e abra a aba Conteúdo.
  2. Clique em + Adicionar conteúdo.
  3. Escolha o tipo: Figurinha, Áudio, Imagem, Vídeo ou Documento.
  4. No cartão aberto, cole o endereço no campo Link do arquivo (o campo mostra https://... como exemplo).
  5. Se quiser uma legenda, preencha Legenda (opcional).
  6. Observe o cartão: se houver problema, ele ganha borda vermelha e uma etiqueta de alerta com o motivo.
  7. Para mudar a ordem entre os conteúdos do bloco, clique em Subir ou Descer.
  8. Abra o painel de teste do Builder e confira o envio.
Cartão Imagem com os campos Link do arquivo e Legenda

Campos da tela

CampoO que fazer
Link do arquivoEndereço https do arquivo. Obrigatório
Legenda (opcional)Texto que acompanha a mídia. Se ficar vazio, nenhuma legenda é enviada
Subir, Descer, ExcluirReordenam ou removem o cartão

Formatos e limites

TipoFormatos aceitosLimite de tamanho
Imagem e FigurinhaGIF, JPEG, JFIF, PNG, SVG, TIFF, DWG, WebPSem limite aplicado pelo Pipe
ÁudioAAC, MIDI, MP3, MP4, MPEG, WAV, OGG, WMA, WebM, Opus, AMR16 MB
Vídeo3GPP, AVI, MPEG, MP4, MOV, M4V, WMV, WebM16 MB
DocumentoPDF, Word, Excel, PowerPoint, Outlook, ZIP, RAR, CSV, HTML e texto simples100 MB

Exemplo na Loja Girassol

Quando alguém pergunta sobre trocas, a Loja Girassol envia um Texto ("Veja a política de trocas em PDF:") e, em seguida, um cartão Documento com o link https://exemplo.girassol.test/trocas.pdf e a legenda "Política de trocas". O contato recebe o texto e depois o arquivo.

Resultado esperado

O contato recebe a mídia na posição definida na sequência do bloco, com a legenda quando houver.

Boas práticas

  • Hospede os arquivos em um endereço estável. Se o link mudar, o envio quebra.
  • Use arquivos leves: abrem mais rápido no celular.
  • Prefira um Texto antes do arquivo para explicar o que ele é, principalmente no áudio.
  • Teste cada mídia no canal real, não só no painel.

Limitações

  • Não há envio de arquivo pelo editor: só por link.
  • Cada cartão registra um tipo de arquivo padrão (WebP para figurinha, MP3 para áudio, PNG para imagem, MP4 para vídeo, PDF para documento); a escolha do cartão define a categoria da mídia.
  • No WhatsApp, a figurinha segue como imagem e o áudio não leva legenda.
  • Links http, localhost e endereços de rede privada são recusados.

Problemas comuns

  • Aparece "O campo 'uri' é obrigatório no conteúdo de mídia": o Link do arquivo está vazio.
  • O arquivo não chega ao contato: confira se o link abre sem login e se começa com https.
  • O painel diz que o formato não é aceito: isso aparece em fluxos importados cujo tipo de arquivo declarado fica fora da tabela de formatos. Confira a tabela e ajuste o cartão.
  • A legenda do áudio sumiu: o WhatsApp não aceita legenda em áudio.

Próximos passos

Perguntas frequentes

Posso enviar um arquivo do meu computador?

Não. O cartão de mídia pede o Link do arquivo, ou seja, um endereço https que leve ao arquivo. Hospede o arquivo em um endereço seguro e cole o link.

O áudio aceita legenda?

O campo existe, mas o WhatsApp não aceita legenda em áudio, então ela não é enviada. Para explicar o áudio, envie antes um conteúdo Texto.

Qual o tamanho máximo do arquivo?

Áudio e vídeo: 16 MB. Documento: 100 MB. Para imagem, o Pipe não aplica limite de tamanho, só confere o formato.

Por que meu link foi recusado?

Links precisam usar https e não podem apontar para localhost nem para endereços de rede privada. O campo Link do arquivo também não pode ficar vazio.