Solução de Problemas (WhatsApp)
Este guia reúne os erros mais comuns da API do WhatsApp Business e como resolvê-los. Use esta referência quando mensagens não forem entregues ou quando houver falhas na integração com o Agente da Patagon AI.
Erros Comuns e Soluções
100
Invalid parameter
Tentativa de enviar mensagem fora da janela de 24h sem usar um template aprovado
Use um template aprovado ou aguarde o cliente responder para reabrir a janela
131009
Parameter value is not valid
Parâmetro inválido ou template recém-aprovado ainda não sincronizado
Verifique os parâmetros do template. Aguarde até 10 minutos após a aprovação
131026
Message Undeliverable
Número de destino inválido, usuário bloqueou a empresa ou não está no WhatsApp
Verifique se o número é válido. Se persistir, o usuário pode ter bloqueado sua empresa
131030
Payment Required
Método de pagamento não configurado ou falha na cobrança
Configure um cartão de crédito válido no Meta Business Suite
131047
Rate limit hit
Excesso de chamadas de API em curto período
Reduza a frequência de envios. Implemente retry com intervalo progressivo
131051
Phone number is not registered
Número foi desregistrado ou há problema com verificação de dois fatores
Verifique o status do número na WABA. Reconfigure a verificação se necessário
Como Identificar o Erro
Na plataforma da Patagon AI, você pode verificar o status de entrega das mensagens na página de Conversas. Mensagens com falha exibirão o código de erro correspondente.
Se precisar de mais detalhes, acesse o Gerenciador do WhatsApp no Meta Business Suite para verificar logs e status do número.
Problemas Frequentes
Mensagens não estão sendo enviadas
Verifique se há um método de pagamento válido configurado (erro 131030)
Confirme que está usando um template aprovado para mensagens fora da janela de 24h (erro 100)
Cheque se o número da empresa está ativo na WABA (erro 131051)
Template foi rejeitado pela Meta
Revise se há identificação clara da empresa
Verifique ortografia e gramática
Confirme que as variáveis estão bem estruturadas
Consulte o guia Crie templates de mensagens
Qualidade do número caiu
Pause os envios por 1-2 dias
Revise os templates recentes
Limpe a base de contatos
Consulte o guia Monitore a saúde do seu número
Quando Contatar o Suporte?
Se o problema persistir após seguir as orientações acima, entre em contato com o time da Patagon AI informando:
O código de erro exibido
O número de telefone afetado
A data e hora aproximada do problema
O template utilizado (se aplicável)
Nossa equipe acompanha você durante todo o processo de resolução.
Atualizado