Glossário · Erros da Meta

Erro 131052 no WhatsApp Business API

Falha ao baixar a mídia do cliente

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

O erro 131052 (media download error) é devolvido quando a plataforma tenta baixar da Meta um arquivo enviado pelo cliente e o download falha. O arquivo existe na conversa do usuário, mas o identificador temporário da Graph API expirou, foi revogado ou apresentou falha momentânea.

Por que este erro acontece

O identificador da mídia expirou. A Meta mantém o arquivo disponível por tempo limitado depois do recebimento.
Instabilidade momentânea na Graph API no instante do download.
A mensagem foi apagada pelo remetente antes do download.

Como resolver

Peça ao cliente que reenvie o arquivo.
Se o arquivo for essencial e antigo, ofereça outro caminho: e-mail, link de upload, envio pelo chat do site.
Baixe a mídia assim que o webhook chega, em vez de deixar para depois — é a diferença entre um identificador válido e um expirado.

O que não adianta tentar

Repetir o download horas depois com o mesmo identificador. Uma vez expirado, ele não volta.

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: "Não foi possível baixar o arquivo enviado pelo cliente. Peça que ele reenvie ou solicite o arquivo por outro caminho." Código desconhecido cai no texto original com o número na frente, porque traduzir nunca pode engolir a informação.

Erros relacionados

Erro 131053 — Falha ao enviar a mídia

A Meta recusou o arquivo que a empresa tentou enviar: formato, tamanho ou URL inacessível.

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.

Perguntas frequentes

O cliente vê algum erro?

Não. Do lado dele a mensagem foi enviada normalmente. O erro é do lado de quem tenta baixar o arquivo.

Isso é diferente do 131053?

Sim, e são lados opostos. O 131052 é falha ao BAIXAR o que o cliente mandou; o 131053 é falha ao SUBIR o que a empresa quer enviar.

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.