Erro 131052 do WhatsApp: falha ao baixar mídia
O erro 131052 significa que a Meta não conseguiu baixar a mídia anexada a uma mensagem. É sobre a mídia em si, não sobre sua requisição, então a resposta prática é pedir o arquivo de outro jeito em vez de mudar algo no código.
Código da Meta para falha ao baixar mídia de uma mensagem.
O código relacionado para falha ao subir mídia que você está enviando.
O que o payload de entrada carrega em vez dos bytes.
Por que acontece
Porque mídia recebida é buscada, não entregue. A mensagem carrega um media id, e os bytes são recuperados à parte com ele.
Essa recuperação pode falhar por motivos do lado de quem enviou: um upload que não completou, um arquivo que expirou antes de ser buscado, ou um formato que não sobreviveu ao que o gerou. Nada disso é visível do seu lado, e nada disso se resolve mudando a sua requisição.
O que fazer
Trate como uma mensagem recebida sem o anexo, e lide com ela como qualquer outra entrada incompleta.
- Registre a mensagem e marque a mídia como indisponível, em vez de descartar o evento inteiro.
- Busque a mídia logo: media ids não valem para sempre.
- Havendo uma pessoa no fluxo, peça ao cliente para enviar de novo, o que resolve a maioria dos casos.
- Não repita indefinidamente. Se a primeira busca e uma repetição falharem, a mídia não vem.
Erros comuns
- Descartar a mensagem inteira. O texto e o contexto continuam úteis sem o anexo.
- Buscar mídia muito depois de receber. Media ids expiram.
- Repetir em laço. Uma busca que falhou raramente funciona depois.
A EasyCoexistence encaminha eventos de mensagem direto da Meta para o seu endpoint, então a mídia é buscada pelo seu sistema com as credenciais do próprio número e nunca passa por nós.
Perguntas frequentes
A mensagem se perde?
Não. A mensagem chega; o que falhou foi recuperar o anexo.
Devo pedir ao cliente para reenviar?
Havendo uma pessoa envolvida, sim. Resolve a maioria dos casos rápido.
Por quanto tempo um media id vale?
Não indefinidamente, e é por isso que buscar logo importa.
O 131053 é a mesma coisa?
Não. Aquele é falha ao subir mídia que você está enviando.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em