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.Limites por tipo de mídia
Resumo rápido
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
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
Áudio
Especificações técnicas
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é-gravados
- AAC/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
Requisitos de codificação
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:Documentos
Especificações técnicas
MIME types suportados
Boas práticas
- PDF é o formato mais confiável para documentos
- Certifique-se de que o nome do arquivo tenha a extensão correta
- Documentos muito grandes podem demorar para o cliente baixar
Stickers
Especificações técnicas
Restrições gerais
Limite de mídia por mensagem
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)
Erros comuns e soluções
1. Arquivo muito grande
Erro: Mensagem não enviada / timeout Soluçã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
2. Formato não suportado
Erro: Arquivo rejeitado / não processado Soluçã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 envio Soluçã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 reconhecido Soluçã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: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.