Erros Comuns
Use este guia para diagnosticar rapido: sintoma, causa provavel e correcao.
JSONLogic com caminho de variavel incorreto
Sintoma: condicao retorna falso mesmo com dado presente.
Causa provavel: caminho da variavel nao existe no contexto real.
Como corrigir:
- Inspecione o payload de entrada da simulacao.
- Ajuste o caminho usado na regra.
- Valide novamente com o mesmo payload.
Node sem conexao de saida
Sintoma: fluxo para no meio sem continuar para o proximo passo.
Causa provavel: node sem aresta de saida configurada.
Como corrigir:
- Revise o canvas e identifique nodes isolados.
- Conecte todas as saidas obrigatorias.
- Rode validacao antes da simulacao.
Credencial ausente ou invalida em integracao
Sintoma: erro de autenticacao em node externo.
Causa provavel: secret nao configurado, expirado ou referenciado com chave errada.
Como corrigir:
- Revise credenciais no ambiente.
- Confirme o nome da chave usada no node.
- Refaça teste com timeout e log habilitados.
Payload invalido para provedor externo
Sintoma: API responde com erro 4xx.
Causa provavel: formato de campo fora do esperado pelo provedor.
Como corrigir:
- Compare payload enviado com o contrato da API.
- Corrija tipos, campos obrigatorios e formato de dados.
- Rode simulacao com payload final.
Timeout em chamada externa
Sintoma: node fica lento e flow encerra com falha de tempo.
Causa provavel: dependencia externa lenta sem estrategia de fallback.
Como corrigir:
- Defina timeout explicito no node.
- Configure retry com limite.
- Crie caminho alternativo para nao interromper operacao critica.
Proximo passo
Depois de corrigir o erro, use Debug e Simulacao para validar cenarios de borda antes de publicar.
Erros da conta Meta (nao sao falha da plataforma)
Quando o Cloud API recusa um envio por problema na SUA conta Meta, o erro aparece na tela de execucoes/simulador com o prefixo "⚠️ Problema na sua conta Meta" e o codigo original entre colchetes. Verifique tambem o checklist Saude da conta (painel Secrets → grupo whatsapp) — ele aponta a pendencia com link direto para resolver.
| Codigo | Significado | Como resolver |
|---|---|---|
131042 | Problema de pagamento (cartao ausente/expirado, limite de credito) | Configuracoes de pagamento do WhatsApp no Gerenciador de Negocios |
133010 | Numero nao registrado no Cloud API | Conclua o registro no WhatsApp Manager ou reconecte pelo Embedded Signup |
131047 | Janela de 24h expirou | Fora da janela, so mensagens de template aprovado (node WA Send Template) |
131048 | Limites por queda de qualidade | Reduza volume, revise templates; acompanhe a qualidade no WhatsApp Manager |
131049 / 131056 | Meta limitou a entrega (frequencia de marketing / muitos envios ao mesmo destinatario) | Aguarde e espace os envios |
131031 | Conta bloqueada/restrita pela Meta | Qualidade da Conta no Gerenciador de Negocios; abra contestacao |
131026 | Destinatario nao pode receber (sem WhatsApp, bloqueou seu numero) | Nao ha acao no seu lado |
80007 | Rate limit da conta atingido | Aguarde alguns minutos e reduza o volume |
Voce tambem recebe avisos automaticos: sino da plataforma em tempo real (eventos de conta via webhook) e e-mail quando a verificacao diaria encontra bloqueios (no maximo um lembrete por semana enquanto persistir).