Enviando imagem e vídeo
Resumo: Você sobe o arquivo para o gateway (ou aponta uma URL pública) e dispara a mensagem. O cliente recebe a mídia direto no WhatsApp, com legenda opcional.
Quando usar isso
Quando precisar enviar fotos (de produtos, exames, orientações visuais) ou vídeos curtos (instruções, apresentações) para seus contatos. É o tipo de mensagem mais comum depois do texto, e funciona em todos os canais (WhatsApp Baileys, WABA e Instagram).
Formatos e tamanhos
| Mídia | Formatos aceitos | Tamanho máximo recomendado |
|---|---|---|
| Imagem | JPG, PNG | 5 MB |
| Vídeo | MP4 (codec H.264) | 16 MB (WABA) / 100 MB (Baileys) |
💡 Dica: Para vídeos longos, prefira hospedar em outro lugar (YouTube, Vimeo) e enviar apenas o link em texto. Vídeos grandes demoram para baixar no celular do cliente, e a Meta pode falhar a entrega.
Como funciona o envio
O envio acontece em duas etapas, gerenciadas automaticamente pelo seu sistema (que usa o gateway por trás):
- Upload da mídia para o gateway (que armazena temporariamente, com validade de 7 dias).
- Envio da mensagem com referência à mídia armazenada, mais a legenda opcional.
Você (usuário final) geralmente só vê a parte de "anexar arquivo" e "escrever legenda" — o resto é invisível.
Passo a passo (interface típica)
- Abra a conversa com o contato.
- Clique no ícone de anexo (clip ou +).
- Selecione Foto ou Vídeo.
- Escolha o arquivo do seu computador.
- (Opcional) escreva uma legenda no campo abaixo do preview.
- Clique em Enviar.
Após enviar, a mensagem aparece com status QUEUED (em fila) e em segundos muda para SENT (enviada) e depois DELIVERED (entregue ao celular do cliente) e READ (lida — quando o cliente abrir).
Recomendações de qualidade
Para imagens
- Resolução entre 800x800 e 1920x1920 — boa qualidade sem peso excessivo.
- Comprima JPGs com qualidade ~85% (ferramentas como TinyPNG, Squoosh).
- Evite imagens com transparência se for JPG; use PNG para isso.
Para vídeos
- Resolução máxima recomendada: 720p.
- Duração ideal: até 30 segundos.
- Codec H.264 com áudio AAC é o mais compatível.
Dúvidas comuns
A imagem que enviei aparece girada ou cortada para o cliente. Algumas fotos de celular têm "rotação EXIF" — a foto é horizontal mas tem uma flag dizendo "girar 90 graus". Alguns clientes WhatsApp respeitam, outros não. Para evitar: antes de enviar, abra a imagem em qualquer editor (até o Paint serve) e salve novamente — isso "queima" a rotação correta.
O cliente reclamou que o vídeo está em silêncio. Confirme que o vídeo tem trilha de áudio (alguns vídeos exportados de telas não capturam o som). Verifique também se o codec de áudio é AAC.
O cliente disse que recebeu um arquivo .mp4 e não consegue abrir. Isso acontece quando o vídeo está com codec incompatível. Reencode para H.264 (ferramentas como HandBrake fazem isso de graça).
Posso enviar várias imagens de uma vez como um "álbum"? No WhatsApp normal sim (você seleciona várias no celular). Pela API, cada mídia é uma mensagem separada — o efeito visual é parecido se enviar em sequência rápida.
A mídia fica salva para sempre? Não. O gateway guarda por 7 dias. Depois desse prazo, ela é apagada. Se você quer manter histórico, salve no seu próprio sistema.