API oficial

Erros que parecem banimento mas não são: o diagnóstico de cinco minutos

Por VeyloCRM · · 3 min de leitura

A mensagem não sai, o erro aparece na tela e a conclusão vem rápida: fomos banidos. Em boa parte dos casos, não foi — é configuração, janela fechada, template pausado ou fatura vencida. Problemas de minutos que viram crise por falta de diagnóstico.

Nem todo envio parado é banimento

A mensagem não sai, o erro aparece na tela e a conclusão vem rápida: fomos banidos. Em boa parte dos casos, não foi. É configuração, é janela fechada, é template não aprovado, é forma de pagamento vencida — problemas de minutos que viram crise por falta de diagnóstico.

O custo de confundir os dois é alto nos dois sentidos: quem trata erro de configuração como banimento cria número novo à toa, e quem trata banimento como erro técnico perde dias insistindo.

Leitura liberada

Continue lendo de graça

Preencha uma vez e libere este e todos os outros artigos do blog. Não cobramos nada — só queremos saber para quem estamos escrevendo.

Leva 20 segundos. Prefere falar direto no WhatsApp?

Janela de atendimento fechada

O erro mais comum de todos. Passadas as horas desde a última mensagem do cliente, só é possível retomar com template aprovado. A mensagem escrita na hora simplesmente não sai — e isso não tem nada a ver com a saúde do número.

Template não aprovado ou pausado

Modelo em análise, reprovado ou pausado não envia. O erro costuma apontar para o template, não para o número, mas a equipe lê "falha no envio" e presume o pior.

Cobrança em aberto ou limite de gasto

Fatura pendente ou teto de gasto atingido interrompem o envio mesmo com o número perfeitamente saudável. É o caso que mais engana, porque o disparo começa bem e trava no meio.

Webhook mal configurado

Aqui o sintoma é o inverso: o envio funciona e as respostas não chegam. A equipe conclui que os clientes pararam de responder, quando na verdade a plataforma está entregando os eventos em um endereço que não existe mais.

Permissão e token

Token expirado, permissão revogada, número desvinculado do aplicativo. Todos produzem falha de envio com mensagem de não autorizado — que é muito diferente de conta restrita.

E existe o simples: o número do cliente

Telefone digitado errado, sem WhatsApp, ou que bloqueou a sua empresa. Falha individual não é problema de conta, e ver dez falhas seguidas numa lista ruim não significa restrição nenhuma.

Como diferenciar em um minuto

Abra o painel e olhe o status do número e da conta. Se estiver tudo normal, o problema é de configuração ou de conteúdo, não de banimento. Depois leia o código do erro: ele separa janela, template, permissão, pagamento e restrição — e cada um tem tratamento diferente.

Por onde começar

Antes de concluir qualquer coisa, confira nesta ordem: status da conta, status do número, situação de cobrança, status do template e o código do erro. Cinco conferências de um minuto que evitam criar número novo por um problema que se resolvia em dez.

Perguntas frequentes

Como saber se o envio parou por banimento ou por erro de configuração?

Confira nesta ordem: status da conta, status do número, situação de cobrança, status do template e o código do erro. Se conta e número estiverem normais, não foi banimento. Os cinco motivos mais comuns são janela de atendimento fechada (só template retoma), template reprovado ou pausado, fatura em aberto ou teto de gasto atingido, webhook apontando para um endereço que não existe mais (o envio funciona, a resposta não chega) e token expirado ou permissão revogada. Cada um tem tratamento próprio, e nenhum se resolve criando número novo.

Erro de configuração e restrição de conta se parecem na tela e não se parecem em nada na prática.

O VeyloCRM mostra o status da conta, do número e do template na mesma tela, e traduz o código do erro em português — o diagnóstico sai antes do pânico.