Glossário · Erros da Meta

Erro 131009 no WhatsApp Business API

Valor de parâmetro inválido

Mensagem da Meta: Parameter value is not valid
Resposta HTTP: 400
Família: Requisição e indisponibilidade

O erro 131009 é devolvido quando um valor enviado não é aceito pelo campo correspondente. O nome do parâmetro está certo e o formato geral da chamada também: o que a Meta recusa é o conteúdo daquele valor específico.

Por que este erro acontece

Número de destino fora do formato internacional esperado.
Código de idioma inexistente no template.
Valor fora da lista permitida em um campo de opções.
Na API de marketing, anúncio ainda não sincronizado no momento da chamada.

Como resolver

Normalize os números para o formato internacional apenas com dígitos antes do envio.
Use exatamente os códigos de idioma listados na documentação, como pt_BR.
Confira o domínio de valores aceitos do campo citado na resposta.

O que não adianta tentar

Reenviar sem corrigir o valor.

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: "Um dos valores enviados não é válido. Confira os dados do envio, principalmente número de destino e campos do modelo." Código desconhecido cai no texto original com o número na frente, porque traduzir nunca pode engolir a informação.

Erros relacionados

Erro 100 — Parâmetro inválido na chamada

A requisição tem um parâmetro fora do formato ou acima do limite aceito.

Erro 131026 — Mensagem não entregue

O número de destino não recebe mensagens: não tem WhatsApp, está digitado errado ou nunca aceitou os termos.

Erro 132012 — Variável no formato errado

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

Perguntas frequentes

Como diferencio do erro 100?

O 100 costuma apontar o parâmetro errado ou ausente; o 131009 aponta um valor que existe mas não é aceito. Na prática, a resposta da Meta nomeia o campo nos dois casos.

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.