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.
Nova tentativa automática
Quando a Meta recusa uma mensagem por um motivo que passa em poucos minutos, como o limite de envios por segundo da Meta ou uma instabilidade, a mensagem é enviada de novo uma vez, 15 minutos depois. Isso vale para as automações e para as mensagens do WooCommerce. Campanhas e mensagens disparadas pelo webhook genérico não têm nova tentativa.
Nas automações, a régua espera esse reenvio. Se ele der certo, a automação segue de onde parou, e as esperas seguintes contam a partir do envio que funcionou. No detalhe da execução, o passo mostra o horário da nova tentativa e, depois, se ela foi enviada ou também falhou.
Nas mensagens do WooCommerce, a recusa original continua no histórico e o reenvio aparece como um registro novo. Enquanto a nova tentativa não acontece, o log mostra Nova tentativa às HH:MM e o botão Reprocessar fica indisponível, para o cliente não receber a mensagem duas vezes.
Se a nova tentativa também falhar, vale a opção Se o envio falhar, seguir para o próximo passo do bloco da mensagem: com ela ligada, a automação continua; desligada, a automação termina.
Quando uma recusa não vai ganhar nova tentativa, o log do WooCommerce e o detalhe da execução da automação mostram Sem nova tentativa automática e o motivo.
Não há nova tentativa quando o erro não passa em minutos: cliente que atingiu o limite de mensagens de marketing (131049), número sem WhatsApp, com termos pendentes ou app desatualizado (131026), número em um experimento da Meta (130472), cliente que pediu para não receber marketing (131050), janela de 24 horas fechada (131047), erros de template (132xxx) e erros de configuração ou de conta. Reenvios feitos pelo botão Reprocessar também não ganham nova tentativa. Também não há quando a Meta avisa a falha mais de uma hora depois do envio, ou quando a automação já fez, depois da mensagem, algo que não pode se repetir, como gerar um cupom ou aplicar uma tag.
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, ou a conta foi removida ou desativada;
- O número está incorreto, incompleto ou fora do formato internacional;
- O destinatário ainda não aceitou os Termos de Serviço e a Política de Privacidade mais recentes do WhatsApp;
- O destinatário usa uma versão muito antiga do WhatsApp;
- O contato pode ter bloqueado o número da empresa. A Meta não informa esse motivo, por privacidade, mas provedores da API citam essa causa.
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
Se o número estiver certo, peça ao cliente, por outro canal, que atualize o WhatsApp e aceite os termos pendentes (em Configurações → Ajuda) e confirme que consegue mandar mensagem para o número da empresa.
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.
Esse erro não ganha nova tentativa automática: a causa está no número do cliente e não se resolve em minutos. Reprocesse depois de corrigir o número ou de o cliente atualizar o WhatsApp.
Erro 131047: Re-engagement message
O que significa
A Meta devolve este erro com a mensagem:
More than 24 hours have passed since the recipient last replied to the sender number.
Ou seja: foi enviada uma mensagem livre (texto, mídia ou mensagem interativa, sem template) depois de fechada a janela de atendimento de 24 horas.
A janela abre quando o cliente manda uma mensagem para a empresa e reinicia a cada nova mensagem dele. Com a janela fechada, só é possível enviar templates aprovados.
Causas comuns
- Uma automação ou integração enviando texto livre em vez de template;
- Uma resposta manual enviada mais de 24 horas depois da última mensagem do cliente.
Como resolver
- Envie um template aprovado para retomar a conversa. Quando o cliente responder, a janela de 24 horas abre de novo e as mensagens livres voltam a funcionar.
- Se você usa integração própria, confira se algum envio está saindo como texto (
type: text) em vez detemplate.
Erro 131049: This message was not delivered to maintain healthy ecosystem engagement
O que significa
O WhatsApp limita quantas mensagens de marketing cada pessoa recebe, somando todas as empresas que falam com ela. Quando o limite daquela pessoa é atingido, a Meta não entrega o template e devolve o erro 131049.
O limite é calculado pela própria Meta para cada pessoa (leva em conta, por exemplo, se ela costuma ler as mensagens que recebe) e muda com o tempo. Ele vale para o Brasil.
Dois detalhes importantes:
- Só templates da categoria Marketing contam. Mensagens de Utilidade, como confirmação de pedido e código de rastreio, não entram nesse limite.
- Se o cliente responder, abre a janela de 24 horas, e o marketing enviado dentro dela não conta para o limite.
Causas comuns
- O cliente já recebe muita mensagem de marketing, da sua loja e de outras empresas;
- Reenvios seguidos da mesma mensagem. Tentar de novo várias vezes em 24 horas pode bloquear novas tentativas para aquele cliente por até 24 horas;
- Lembretes de carrinho abandonado e ofertas: para a Meta, são Marketing.
Como resolver
- Não reenvie em sequência. Esse erro não ganha nova tentativa automática, porque a Meta não informa quando o limite do cliente libera e reenviar minutos depois só repete a recusa. Se quiser tentar de novo, espere pelo menos 24 horas.
- Mantenha as notificações de pedido na categoria Utilidade, sem oferta ou cupom no texto. Se a Meta mudar um template para Marketing, veja Meta mudou minha mensagem para Marketing. E agora?.
- Para entender o custo e as regras de cada categoria, veja Utilidade ou Marketing: quanto custa cada mensagem.
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
"name_placeholder should represent a valid URL" ao criar um template
O que significa
Esse erro aparece ao criar ou enviar um template com botão de URL. Ele indica que o campo que deveria ser uma URL recebeu algo que a Meta não reconhece como URL válida. A Meta não documenta essa frase, mas ela segue as regras dos botões de URL.
Regras do botão de URL na Meta
- Cada template aceita no máximo 2 botões de URL;
- A URL pode ter até 2.000 caracteres;
- O botão aceita só 1 variável, e ela fica no final da URL. Exemplo:
https://sualoja.com.br/pedido/{{1}}; - Quando há variável, a Meta pede um exemplo de URL na criação do template.
Causas comuns
- A URL inteira foi colocada como variável (
{{1}}); - A variável está no meio da URL, e não no final;
- Falta
https://no começo; - A URL tem espaços ou caracteres especiais sem codificação;
- O exemplo informado não é uma URL completa.
Como resolver
Use um domínio fixo com a variável só no final (https://sualoja.com.br/pedido/{{1}}) e informe um exemplo com a URL completa. No envio, mande na variável apenas a parte final da URL. Veja mais em Botões de URL e o modificador relative_url e Usando botões em vez de links no template.
"Integrity requirements not met"
O que significa
Essa mensagem indica que a Meta identificou um problema de integridade na conta, ou seja, uma possível violação das políticas do WhatsApp ou do Meta Business. Com isso, algumas ações ficam bloqueadas, como criar recursos ou cadastrar números. A Meta documenta o erro de integridade (139000, "Blocked By Integrity") e as restrições de conta, mas não detalha o motivo de cada caso.
Como resolver
- Acesse o Business Support Home (Suporte para Empresas) da Meta, abra a visão geral da conta e veja se há violações ou restrições.
- Se houver, peça a revisão por lá. A resposta costuma levar de 24 a 48 horas.
- Confira se a empresa está verificada no Gerenciador de Negócios.
- Se nada aparecer, abra um chamado no suporte da Meta.
Esse bloqueio é aplicado pela Meta, não pelo Rishi Chat.
"Unexpected null value WhatsAppBizXPlatformPhoneCreationContainer.react"
O que significa
Esse erro aparece na tela da Meta ao adicionar um número ao WhatsApp Business. A Meta não documenta essa mensagem: ela indica que a própria tela falhou ao processar o cadastro, sem dizer o motivo.
O que conferir
As causas documentadas pela Meta para falhas ao adicionar um número são:
- O número ainda está ativo no WhatsApp ou no WhatsApp Business App. Apague a conta do app nesse número e espere alguns minutos antes de tentar de novo;
- O número está bloqueado. Veja se há aviso no WhatsApp Manager;
- O portfólio atingiu o limite de números. Contas novas podem registrar só 2 números até a empresa ser verificada;
- A conta tem alguma restrição. Veja a seção anterior;
- A pessoa que está cadastrando não tem permissão de administrador na conta.
Também vale tentar em uma aba anônima, com as extensões do navegador desativadas ou em outro navegador. Se o erro continuar, procure o suporte da Meta.
"A conexão com api.whatsapp.com foi recusada"
O que significa
Essa mensagem é do navegador (no Chrome, o erro ERR_CONNECTION_REFUSED), e não da Meta. Ela aparece quando alguém clica em um link do WhatsApp, como wa.me/… ou api.whatsapp.com/send?phone=…, e o computador não consegue se conectar ao site do WhatsApp.
Links wa.me também passam por api.whatsapp.com, então são afetados da mesma forma.
Causas comuns
O problema quase sempre está na rede ou no aparelho de quem clicou, e não no link da loja:
- Rede de empresa ou escola que bloqueia o WhatsApp;
- Firewall ou antivírus;
- VPN ou proxy;
- Extensão bloqueadora no navegador.
Como resolver
Peça para quem viu o erro tentar em outra rede (por exemplo, no 4G do celular), em uma aba anônima, sem VPN ou com as extensões desativadas. Na loja, vale mostrar também o número escrito ou um QR code como alternativa ao link.
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.
Quer enviar as notificações de pedido da sua loja WooCommerce pelo WhatsApp Oficial sem montar a integração do zero? Conheça o WhatsApp Oficial da Rishi.