Ir para o conteúdo
OmniChannels.ai
Menu

API do WhatsApp Business

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

Atualizado em

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ídiaTamanho máximoObservações
Imagem5 MBSomente RGB ou RGBA de 8 bits
Vídeo16 MBVídeo H.264, áudio AAC
Áudio16 MBAAC, AMR, MP3, M4A, OGG com codec Opus
Documento100 MBArquivos Office, PDF e texto
Figurinha (animada)500 KBSomente WebP
Figurinha (estática)100 KBSomente 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