> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/configuracoes/geral/integracoes/whatsapp/kcs-erro-whatsapp-131008-required-parameter-is-missing-na-whatsapp-cloud-api.md).

# 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<br>

***

### ❓ 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.<br>

***

### 🔎 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:<br>

* 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.<br>
* 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.<br>
* 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.<br>

***

### ✅ Solução / Passo a Passo de Correção

Para corrigir a estrutura da mensagem e restabelecer os envios via WhatsApp Cloud API:<br>

1. Acesse as Configurações do Modelo: Vá até o menu de modelos de mensagens (HSM) do WhatsApp e selecione o modelo afetado.<br>
2. 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.<br>
3. 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.<br>
4. Revise o Texto e Espaçamentos: Remova espaços em branco desnecessários antes, dentro ou depois dos marcadores de variáveis dinâmicas.<br>

> 💡 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

```
erro 131008 whatsapp cloud api,
required parameter is missing whatsapp,
falha envio hsm whatsapp meta,
variavel em branco modelo mensagem whatsapp,
erro parametro obrigatorio ausente whatsapp,
mapeamento variaveis solicitante cliente hsm,
meta cloud api error 131008
```