KCS - Erro Whatsapp (#131008) Required Parameter Is Missing na WhatsApp Cloud API
🚨 Erro do WhatsApp (#131008) Required Parameter Is Missing na WhatsApp Cloud API
🕒 Tempo aproximado para leitura: 00:01:15 min
❓ Dúvida / Problema
Ao tentar enviar uma mensagem via WhatsApp (Cloud API), o sistema exibe a falha Erro (#131008) Required parameter is missing e impede a entrega do disparo.
🔎 Causa / Contexto
A Meta (WhatsApp) rejeita a requisição devido a uma inconformidade na estrutura da mensagem enviada. Trata-se de um erro de parâmetro obrigatório ausente ou mal formatado no payload da requisição (diferente de falhas de saldo, falta de permissão ou número inválido). As causas mais comuns incluem:
Variáveis de Template não preenchidas: O modelo HSM aprovado possui variáveis dinâmicas (ex:
{{1}},{{2}}), mas o disparo foi acionado sem mapear ou preencher algum desses valores.Incompatibilidade de Variáveis: Tentativa de vincular a variável ao campo Cliente em vez de Solicitante (ou vice-versa), gerando divergência no parâmetro esperado pela API.
Caracteres Especiais ou Espaços Indevidos: Presença de espaços em branco antes/depois das chaves ou caracteres incompatíveis no código do modelo HSM.
✅ Solução / Passo a Passo de Correção
Para corrigir a estrutura da mensagem e restabelecer os envios via WhatsApp Cloud API:
Acesse as Configurações do Modelo: Vá até o menu de modelos de mensagens (HSM) do WhatsApp e selecione o modelo afetado.
Verifique os Parâmetros e Variáveis: Certifique-se de que todas as variáveis dinâmicas do modelo (ex:
{{1}},{{2}}) possuem um campo correspondente devidamente mapeado e preenchido antes do disparo.Valide a Origem dos Dados: Confirme se os campos dinâmicos estão vinculados corretamente às variáveis do Solicitante ou do Cliente, evitando inversões de referência na configuração.
Revise o Texto e Espaçamentos: Remova espaços em branco desnecessários antes, dentro ou depois dos marcadores de variáveis dinâmicas.
💡 Dica de Especialista / Nota: Se o disparo for realizado via fluxo automatizado ou gatilho de ticket, certifique-se de que o chamado contenha todas as informações cadastradas (como nome do solicitante ou número do chamado) para que a variável não seja enviada em branco para a Meta.
🔍 Palavras-chave para busca
Atualizado