> ## Documentation Index > Fetch the complete documentation index at: https://docs.maketalk.ai/llms.txt > Use this file to discover all available pages before exploring further. # Limites de mídia do WhatsApp > Tipos de arquivos suportados, tamanhos máximos e requisitos técnicos para envio de mídia via WhatsApp Business API ## 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: ```bash theme={null} 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 ### 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: | 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: * [Meta Developers - WhatsApp Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media) * [WhatsApp Business Platform - Policies](https://business.whatsapp.com/policy) *** ## Próximos passos Aprenda sobre templates e a janela de atendimento. Entenda como funciona a cobrança por mensagem. Saiba como disparar campanhas com segurança. Crie e configure seus canais de atendimento.