Este artigo reúne os principais erros que podem ocorrer ao enviar mensagens pela API Oficial do WhatsApp usando o Rishi Chat, além de explicar as causas mais comuns e os caminhos recomendados para correção.
Erro 132000: Number of parameters does not match the expected number of params
O que significa
Esse erro acontece quando a quantidade de parâmetros enviados para um template não corresponde à quantidade de variáveis esperadas pela Meta.
Na prática, a Meta está informando que o template aprovado espera uma determinada quantidade de variáveis, mas a requisição enviada possui menos ou mais parâmetros do que o necessário.
Por exemplo, se o template aprovado possui duas variáveis:
Olá {{1}}, seu pedido {{2}} foi enviado.
A requisição precisa enviar dois valores. Caso apenas um valor seja enviado, como no exemplo abaixo, a Meta retornará o erro:
[
"Fernando"
]
Nesse caso, a variável {{2}} ficou sem valor.
Quando esse erro costuma acontecer
Esse problema geralmente ocorre quando alguma informação usada no template não existe, está vazia ou não foi recebida corretamente pela integração.
Um exemplo comum é o uso de uma variável relacionada ao método de entrega:
Método de entrega: {{3}}
Se o pedido for virtual ou digital, ele pode não possuir método de entrega. Como consequência, essa variável pode chegar vazia ou nem ser enviada, fazendo com que a quantidade de parâmetros não corresponda ao template aprovado.
O problema também pode estar no webhook recebido
Em alguns casos, o erro não está exatamente no envio da mensagem, mas sim nos dados recebidos anteriormente pelo Rishi Chat.
Isso pode acontecer quando o webhook enviado pela loja, plataforma ou integração chega com alguma informação faltando.
Exemplos comuns:
- Pedido sem endereço;
- Pedido sem transportadora;
- Pedido sem método de entrega;
- Cliente sem nome;
- Produto removido ou sem informação completa;
- Pedido virtual usando um template que espera dados de entrega.
Como resolver
Verifique se todas as variáveis do template estão sendo enviadas corretamente.
Também é importante confirmar se os dados usados no template realmente existem para aquele tipo de pedido. Quando houver diferença entre pedidos físicos e virtuais, o ideal é usar templates diferentes ou adicionar regras para impedir o envio quando alguma informação obrigatória estiver ausente.
Em resumo, revise:
- A quantidade de variáveis cadastradas no template;
- A quantidade de parâmetros enviados na requisição;
- Se algum campo está vazio;
- Se o webhook recebido possui todas as informações necessárias;
- Se o template é adequado para o tipo de pedido;
- Se existem restrições ou regras para evitar envios com dados incompletos.
Erro 131026: Message undeliverable
O que significa
Esse erro indica que a Meta não conseguiu entregar a mensagem ao destinatário.
A mensagem foi enviada para a API, mas o WhatsApp não conseguiu concluir a entrega para o contato informado.
Possíveis causas
As causas mais comuns são:
- O número informado não possui WhatsApp;
- O número está incorreto ou incompleto;
- O contato bloqueou o número da empresa;
- O WhatsApp do destinatário está temporariamente indisponível;
- A conta do destinatário foi removida, desativada ou está com alguma restrição;
- O número não está no formato internacional correto.
Como resolver
Primeiro, confirme se o telefone do contato está correto e se possui uma conta ativa no WhatsApp.
O número deve estar no formato internacional, contendo apenas números:
5511999999999
Evite enviar números com:
+55 11 99999-9999
(11) 99999-9999
55 11 99999 9999
55-11-99999-9999
Também é importante verificar se o cliente não bloqueou a empresa no WhatsApp. Caso o número esteja correto, tenha WhatsApp ativo e ainda assim o erro continue acontecendo, pode ser uma limitação ou indisponibilidade temporária do próprio WhatsApp.
Erro 131042: Business eligibility payment issue
O que significa
Esse erro indica que existe algum problema financeiro ou de elegibilidade relacionado à conta comercial da Meta.
Quando isso acontece, a Meta pode bloquear temporariamente o envio de mensagens até que a pendência seja resolvida.
Possíveis causas
As causas mais comuns são:
- Cartão de crédito expirado;
- Cartão recusado;
- Falha na cobrança;
- Saldo insuficiente;
- Pendência financeira na conta comercial;
- Restrição de pagamento no Business Manager;
- Problema de elegibilidade da empresa para envio de mensagens pagas.
Como resolver
Acesse o Meta Business Manager ou o WhatsApp Manager e verifique a área de cobrança da conta.
Revise principalmente:
- Métodos de pagamento cadastrados;
- Cartões expirados ou recusados;
- Cobranças pendentes;
- Saldo disponível;
- Limites da conta;
- Restrições financeiras ou comerciais.
Importante
Esse erro não está relacionado ao funcionamento do Rishi Chat.
O bloqueio ocorre diretamente na conta da Meta. Por isso, a correção precisa ser feita no ambiente da Meta, geralmente pelo administrador do Business Manager da empresa.
Erro 132012: Parameter format does not match format in the created template
O que significa
Esse erro acontece quando o formato de um parâmetro enviado não corresponde ao formato esperado pelo template aprovado na Meta.
Diferente do erro 132000, que está relacionado à quantidade de parâmetros, o erro 132012 está relacionado ao tipo ou formato do parâmetro enviado.
Exemplo comum
Um template pode esperar uma variável de texto:
{{1}} -> texto
Mas a requisição pode estar enviando outro tipo de parâmetro, como moeda:
{
"type": "currency"
}
Nesse caso, a Meta rejeita o envio porque o formato recebido não bate com o formato configurado no template.
Outro exemplo comum
O template pode ter sido aprovado com um cabeçalho de imagem:
header -> image
Mas a requisição envia um texto simples no lugar da imagem:
texto simples
Isso também causa incompatibilidade entre o template aprovado e os dados enviados.
Como resolver
Revise a estrutura do template aprovado na Meta e compare com a estrutura enviada na requisição.
Verifique especialmente:
- O tipo de cada variável;
- O formato esperado pela Meta;
- A estrutura do
HEADER; - A estrutura do
BODY; - A estrutura dos botões;
- Se o template espera texto, imagem, documento, moeda, data ou outro tipo específico.
Exemplos de tipos de parâmetros
Parâmetro de texto:
{
"type": "text",
"text": "Pedido #123"
}
Parâmetro de moeda:
{
"type": "currency"
}
Parâmetro de data:
{
"type": "date_time"
}
O importante é garantir que o tipo enviado seja compatível com o tipo aprovado no template.
Erro HTTP 422: Source invalid source id for whatsapp inbox
Mensagem do erro
{
"message": "Source invalid source id for whatsapp inbox. valid Regex (^\\d{1,15}$)",
"attributes": ["source_id"]
}
O que significa
Esse erro indica que o número do contato é inválido ou não está no formato aceito para uma inbox de WhatsApp.
O campo source_id precisa conter apenas números, com no máximo 15 dígitos. Quando o telefone vem com símbolos, espaços, letras ou outros caracteres, o Rishi Chat não consegue associar corretamente o contato à inbox do WhatsApp.
Formato correto
O telefone deve ser enviado apenas com números, no padrão internacional:
5511999999999
Esse formato representa:
[código do país][DDD][telefone]
Formatos inválidos
Com símbolo de +:
+55 11 99999-9999
Com espaços:
55 11 99999 9999
Com parênteses:
(11) 99999-9999
Com traços:
55-11-99999-9999
Como resolver
Normalize o telefone antes de criar ou atualizar o contato.
Remova:
- Espaços;
- Traços;
- Parênteses;
- Sinal de
+; - Qualquer caractere que não seja número.
Depois da normalização, o telefone deve ficar neste formato:
5511999999999
Boas práticas para evitar erros na API da Meta
Valide os dados antes do envio
Antes de enviar uma mensagem, valide se os dados obrigatórios estão disponíveis.
Verifique principalmente:
- Telefone do contato;
- Variáveis do template;
- Campos obrigatórios do pedido;
- Mídias usadas no template;
- Estrutura dos botões;
- Tipo correto dos parâmetros;
- Dados recebidos via webhook.
Não envie variáveis vazias
Mesmo que o template esteja aprovado, variáveis vazias podem causar falhas no envio.
Sempre que possível, adicione validações para impedir o envio de templates quando algum campo obrigatório estiver ausente.
Use templates diferentes para cenários diferentes
Pedidos físicos e pedidos virtuais podem ter informações diferentes.
Por exemplo, um pedido físico pode ter método de entrega, transportadora e endereço. Já um pedido virtual pode não ter nenhum desses dados.
Nesses casos, o ideal é usar templates diferentes para evitar que variáveis de entrega sejam chamadas em pedidos que não possuem entrega.
Padronize os telefones
Armazene e envie telefones sempre no formato internacional, usando apenas números.
Exemplo:
5511999999999
Evite armazenar telefones com símbolos, espaços ou formatações visuais.
Monitore os logs de erro
Acompanhar os logs ajuda a identificar rapidamente problemas recorrentes.
Os logs podem indicar:
- Templates configurados incorretamente;
- Integrações enviando dados incompletos;
- Webhooks inconsistentes;
- Telefones inválidos;
- Problemas de cobrança na Meta;
- Erros de formato em parâmetros;
- Campos obrigatórios ausentes.
Revise os dados recebidos pelas integrações
Quando o erro estiver relacionado a variáveis ausentes, revise também a origem dos dados.
Em muitos casos, o problema começa antes do envio da mensagem, quando a loja, plataforma ou integração envia um webhook incompleto para o Rishi Chat.
Por isso, além de revisar o template, também é importante confirmar se os dados recebidos pela integração estão completos e coerentes com o tipo de mensagem que será enviada.