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/png |
| Formato 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é-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
| Atributo | Valor |
|---|
| Tamanho máximo | 16 MB |
| Formatos suportados | MP4, 3GP |
| MIME types | video/mp4, video/3gp |
| Codec 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/pdf |
| Texto | text/plain |
| Word (.doc) | application/msword |
| Word (.docx) | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
| Excel (.xls) | application/vnd.ms-excel |
| Excel (.xlsx) | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| PowerPoint (.ppt) | application/vnd.ms-powerpoint |
| PowerPoint (.pptx) | application/vnd.openxmlformats-officedocument.presentationml.presentation |
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
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/webp |
| Dimensõ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 / 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
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:
| 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
