Visão geral O WhatsApp Business API possui limites específicos para cada tipo de mídia que você pode enviar ou receber. Conhecer essas limitações evita falhas no envio e garante que seus clientes recebam o conteúdo corretamente.
A maioria das falhas no envio de mídia ocorre por tamanho excedido ou formato não suportado . Consulte as tabelas abaixo antes de enviar arquivos.
Limites por tipo de mídia Resumo rápido Tipo Tamanho máximo Formatos principais Imagens 5 MB JPEG, PNG Áudio 16 MB AAC, MP3, OGG, AMR, M4A Vídeo 16 MB MP4 (H.264 + AAC) Documentos 100 MB PDF, Word, Excel, PowerPoint Stickers 100 KB (estático) / 500 KB (animado) WebP
Os limites de tamanho se aplicam ao arquivo após criptografia . Na prática, mantenha seus arquivos ligeiramente abaixo do limite para garantir o envio.
Imagens Especificações técnicas Atributo Valor Tamanho máximo 5 MB Formatos suportados JPEG, PNG MIME types image/jpeg, image/pngFormato de cor RGB ou RGBA (8-bit)
Boas práticas
Use JPEG para fotos (melhor compressão)
Use PNG apenas quando precisar de transparência
Verifique se as tags EXIF estão configuradas corretamente
Comprima imagens grandes antes do envio
Para catálogos de produtos, prefira JPEG com qualidade 80-85% para equilibrar qualidade e tamanho.
Áudio Especificações técnicas Atributo Valor Tamanho máximo 16 MB Formatos suportados AAC, MP3, AMR, OGG, M4A MIME types audio/aac, audio/mpeg, audio/amr, audio/ogg (apenas codec Opus), audio/mp4
Notas importantes
OGG : Apenas com codec Opus (formato padrão do WhatsApp para mensagens de voz)MP3 : Amplamente compatível, boa opção para áudios pré-gravadosAAC/M4A : Recomendado para músicas e áudios de alta qualidade
Mensagens de voz gravadas no WhatsApp usam o formato OGG com codec Opus automaticamente.
Vídeo Especificações técnicas Atributo Valor Tamanho máximo 16 MB Formatos suportados MP4, 3GP MIME types video/mp4, video/3gpCodec de vídeo H.264 Codec de áudio AAC
Requisitos de codificação Vídeos devem usar obrigatoriamente :
Codec de vídeo: H.264
Codec de áudio: AAC
Vídeos com outros codecs (como H.265/HEVC ou VP9) não serão aceitos . Dicas para vídeos
Limite de 16 MB significa aproximadamente 1-2 minutos em qualidade HD
Para vídeos mais longos, reduza a resolução ou qualidade
Vídeos podem ter uma única faixa de áudio ou nenhuma (mudo)
3GP é suportado mas MP4 é mais compatível
Exemplo de conversão (FFmpeg) Para converter um vídeo para o formato correto:
ffmpeg -i entrada.mov -c:v libx264 -c:a aac -b:a 128k saida.mp4
Documentos Especificações técnicas Atributo Valor Tamanho máximo 100 MB Formatos suportados PDF, Word, Excel, PowerPoint, texto
MIME types suportados Formato MIME type PDF application/pdfTexto text/plainWord (.doc) application/mswordWord (.docx) application/vnd.openxmlformats-officedocument.wordprocessingml.documentExcel (.xls) application/vnd.ms-excelExcel (.xlsx) application/vnd.openxmlformats-officedocument.spreadsheetml.sheetPowerPoint (.ppt) application/vnd.ms-powerpointPowerPoint (.pptx) application/vnd.openxmlformats-officedocument.presentationml.presentation
Boas práticas
PDF é o formato mais confiável para documentosCertifique-se de que o nome do arquivo tenha a extensão correta
Documentos muito grandes podem demorar para o cliente baixar
Para contratos e documentos importantes, sempre use PDF para garantir que a formatação seja preservada.
Stickers Especificações técnicas Tipo Tamanho máximo Estático 100 KB Animado 500 KB
Atributo Valor Formato WebP MIME type image/webpDimensões recomendadas 512x512 pixels
Restrições gerais Limite de mídia por mensagem O WhatsApp permite apenas um arquivo de mídia por mensagem . Se precisar enviar múltiplos arquivos, envie cada um em uma mensagem separada.
Armazenamento de mídia
Arquivos de mídia são criptografados e armazenados por 30 dias após o último uso
Após esse período, os arquivos são excluídos automaticamente
Não é possível recuperar arquivos após a exclusão
Limites de taxa (Rate limits) Operação Limite Upload de mídia 25 requisições/segundo por número Falhas consecutivas 5+ falhas em 1 hora = bloqueio de 60 minutos
Se você tiver 5 ou mais falhas de upload dentro de uma hora, o acesso será bloqueado por 60 minutos . Verifique seus arquivos antes de enviar em massa.
Erros comuns e soluções 1. Arquivo muito grande Erro: Mensagem não enviada / timeoutSolução:
Comprima o arquivo usando ferramentas online ou software
Reduza a resolução de imagens e vídeos
Para documentos, remova imagens embutidas desnecessárias
Erro: Arquivo rejeitado / não processadoSolução:
Converta para um formato suportado (veja tabelas acima)
Para vídeos, use H.264 + AAC obrigatoriamente
Verifique se a extensão do arquivo corresponde ao conteúdo
3. Codec de vídeo incorreto Erro: Vídeo não reproduz / falha no envioSolução:
Recodifique o vídeo usando H.264 para vídeo e AAC para áudio
Use ferramentas como HandBrake, FFmpeg ou conversores online
4. Nome do arquivo sem extensão Erro: Arquivo não reconhecidoSolução:
Certifique-se de que o arquivo tenha a extensão correta (.pdf, .mp4, .jpg, etc.)
Mensagens de texto Além de mídia, é importante conhecer os limites de texto:
Atributo Valor Tamanho máximo 4.096 caracteres Codificação UTF-8
Mensagens que excedem 4.096 caracteres serão truncadas ou rejeitadas.
Referências oficiais Para informações sempre atualizadas, consulte a documentação oficial:
Próximos passos
Templates e janela de 24h Aprenda sobre templates e a janela de atendimento.
Modelo de cobrança da API Entenda como funciona a cobrança por mensagem.
Campanhas em massa Saiba como disparar campanhas com segurança.
Caixas de entrada Crie e configure seus canais de atendimento.
