Glossário · Erros da Meta

Erro 131053 no WhatsApp Business API

Falha ao enviar a mídia

Mensagem da Meta: Media upload error
Resposta HTTP: 400
Família: Entrega da mensagem

O erro 131053 (media upload error) é devolvido quando a Meta não consegue processar o arquivo que a empresa tenta enviar. As causas típicas são formato fora da lista suportada, arquivo acima do limite de tamanho e link de mídia que a Meta não conseguiu acessar.

Por que este erro acontece

O tipo do arquivo declarado não corresponde ao conteúdo real: um PDF renomeado para .jpg, por exemplo.
O arquivo passa do limite de tamanho da categoria: 5 MB para imagem, 16 MB para áudio e vídeo, 100 MB para documento.
O envio foi por link e a URL exige autenticação, responde lento ou devolve erro para o servidor da Meta.
O formato não está na lista suportada para aquele tipo de mensagem.

Como resolver

Confira a extensão e o tipo MIME reais do arquivo, não só o nome.
Comprima a imagem ou o vídeo para ficar abaixo do limite da categoria.
Se enviar por link, teste a URL em uma janela anônima: ela precisa responder o arquivo direto, sem login e sem redirecionamento para página.
Prefira subir a mídia para a Meta e enviar pelo identificador devolvido — é mais estável do que depender de uma URL externa em cada envio.

O que não adianta tentar

Reenviar o mesmo arquivo do mesmo jeito. Se o formato ou o tamanho é o problema, a resposta continuará idêntica.

O que a Skynet.Talk mostra na tela

A Meta devolve o código cru em inglês. A plataforma traduz para uma frase que diz a causa e a ação: "A Meta não conseguiu processar o arquivo enviado. Confira o formato e o tamanho, e garanta que o link do arquivo esteja acessível publicamente." Código desconhecido cai no texto original com o número na frente, porque traduzir nunca pode engolir a informação.

Erros relacionados

Erro 131052 — Falha ao baixar a mídia do cliente

A Meta não conseguiu entregar o arquivo que o cliente mandou. O download da mídia falhou do lado dela.

Erro 131051 — Tipo de mensagem não suportado

O tipo de mensagem enviado não é aceito pela API naquele contexto: formato, mídia ou recurso indisponível.

Erro 132012 — Variável no formato errado

Os valores enviados nas variáveis estão fora do formato que o template declara.

Perguntas frequentes

Quais são os limites de tamanho?

Imagem até 5 MB, áudio e vídeo até 16 MB, documento até 100 MB e figurinha até 500 KB para estática. Passar do limite devolve 131053.

Por que o mesmo arquivo funciona no aplicativo e falha na API?

Porque o aplicativo comprime a mídia no aparelho antes de enviar. A API envia o arquivo como ele é, e é ele que precisa caber no limite.

Por que ele aparece sempre no mesmo fluxo?

Porque o problema é do arquivo, não do envio. Quando um fluxo manda sempre o mesmo tipo de mídia, ou ele passa sempre, ou falha sempre. Erro que aparece concentrado em um único ponto costuma ser formato ou tamanho fixo daquela geração de arquivo.

Este erro aparece no meio de um atendimento e some no log de quem integra direto com a Meta. Na Skynet.Talk ele vira uma frase em português na tela de quem atende. Veja o catálogo completo dos códigos ou entenda como a Meta cobra por mensagem.

Publicado por Skynet.Talk · catálogo revisado em 18 de agosto de 2026 · código conferido na documentação oficial da Meta.