---
title: "Quais são os limites de tamanho de arquivos de mídia da API do WhatsApp?"
description: "Limites de mídia da WhatsApp Cloud API: imagens 5 MB, vídeo e áudio 16 MB, documentos 100 MB, figurinhas de 100 a 500 KB, além de formatos e validade do ID."
canonical: "https://omnichannels.ai/pt/answers/whatsapp-media-file-size-limits/"
language: "pt"
updated: "2026-11-08"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Quais são os limites de tamanho de arquivos de mídia da API do WhatsApp?

Canonical: https://omnichannels.ai/pt/answers/whatsapp-media-file-size-limits/
Language: pt
Publisher: OmniChannels.ai by BroadNet Technologies

**Resposta curta:** A documentação da Meta lista estes tamanhos máximos de mídia da WhatsApp Cloud API na data de redação: imagens 5 MB (JPEG, PNG, WebP estático), vídeo 16 MB (MP4 ou 3GPP com H.264 e AAC), áudio 16 MB, documentos 100 MB, figurinhas animadas 500 KB e estáticas 100 KB. Envie o arquivo por upload e use o ID da mídia em vez de um link, e confira se o tipo MIME corresponde ao arquivo.

## Limites de tamanho por tipo de mídia

O teto da Cloud API para qualquer mídia é de 100 MB. Um arquivo pode respeitar o limite de tamanho e mesmo assim ser rejeitado pelo formato, por exemplo vídeo que não seja H.264 com áudio AAC ou imagem que não seja RGB ou RGBA de 8 bits.

| Tipo de mídia | Tamanho máximo | Observações |
|---|---|---|
| Imagem | 5 MB | Somente RGB ou RGBA de 8 bits |
| Vídeo | 16 MB | Vídeo H.264, áudio AAC |
| Áudio | 16 MB | AAC, AMR, MP3, M4A, OGG com codec Opus |
| Documento | 100 MB | Arquivos Office, PDF e texto |
| Figurinha (animada) | 500 KB | Somente WebP |
| Figurinha (estática) | 100 KB | Somente WebP |

## Upload ou link, e quanto tempo os IDs duram

A Meta recomenda fazer o upload do arquivo e enviar o ID da mídia para ter melhor desempenho. IDs retornados por um upload valem por 30 dias, e IDs recebidos em webhooks de entrada, por 7 dias, então baixe os arquivos dos clientes logo. Uma URL de download expira em 5 minutos.

Legendas de imagem, vídeo e documento podem ter até 1.024 caracteres. Mensagens de áudio e de figurinha não têm legenda.

## Erros comuns

- Julgar só pelo tamanho e ignorar o codec ou o formato de cor.
- Entregar um arquivo com tipo MIME que não corresponde a ele, causa habitual do erro 131053.
- Contar com um ID de mídia com mais de 30 dias.
- Enviar WebP animado como imagem, o que é rejeitado.

## Fontes oficiais

- [Media — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media)
- [Image messages — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/image-messages)
- [Video messages — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages)
- [Document messages — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages)
- [Error codes — WhatsApp Business Platform, Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)

## Guias completos

- [Mídia na API do WhatsApp: formatos aceitos e limites de tamanho](https://omnichannels.ai/pt/blog/whatsapp-media-messages-file-types-size-limits/)
- [Códigos de erro da Cloud API do WhatsApp: significado e solução](https://omnichannels.ai/pt/blog/whatsapp-api-error-codes-troubleshooting/)

## Perguntas relacionadas

- https://omnichannels.ai/pt/answers/send-whatsapp-message-api/
- https://omnichannels.ai/pt/answers/whatsapp-api-rate-limits/
- https://omnichannels.ai/pt/answers/whatsapp-24-hour-window/

Atualizado em: 2026-11-08