Glossário · Erros da Meta
Erro 131051 no WhatsApp Business API
Tipo de mensagem não suportado
- Mensagem da Meta
- Unsupported message type
- Resposta HTTP
- 400
- Família
- Entrega da mensagem
O erro 131051 (unsupported message type) é devolvido quando a chamada pede um tipo de mensagem que a Cloud API não aceita naquele contexto. Acontece com formatos de mídia fora da lista suportada, recursos disponíveis só no aplicativo e campos de tipo escritos errado na requisição.
Por que este erro acontece
- O campo `type` da requisição traz um valor que a API não conhece.
- A mídia está em formato fora da lista suportada, como um vídeo em codec não aceito.
- O recurso existe no aplicativo do WhatsApp, mas não na API: enquete, figurinha animada enviada pela empresa, mensagem de status.
- O tipo é válido, mas não naquele fluxo: botão interativo dentro de template que não declara botões, por exemplo.
Como resolver
- Confira o campo `type` contra a referência de mensagens da Cloud API.
- Converta a mídia para um formato aceito: JPEG e PNG para imagem, MP4 com H.264 e AAC para vídeo, OGG com codec Opus para áudio, PDF para documento.
- Se o recurso só existe no aplicativo, troque por um equivalente suportado, como uma lista interativa no lugar de enquete.
O que não adianta tentar
Repetir a chamada igual. O erro é do formato pedido, e ele não muda sozinho.
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: "Este tipo de mensagem não é aceito pela API do WhatsApp. Use um dos formatos suportados: texto, imagem, documento, áudio, vídeo, localização ou modelo aprovado." 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 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 131009 — Valor de parâmetro inválido
Um dos valores enviados não é aceito pelo campo correspondente.
Perguntas frequentes
Quais tipos a API aceita?
O áudio gravado pelo cliente também pode dar esse erro?
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.