Erros comuns do WhatsApp e o que fazer
Os problemas que mais aparecem na conexão e no envio — e a causa real de cada um.
Cada item traz o sintoma que você vê e a causa real.
#As mensagens de reengajamento não são entregues, e ninguém reclama
Sintoma: você clica em Reengajar, o portal não acusa erro, mas o cliente nunca recebe. O mesmo acontece com o Primeiro contato dos leads de portal.
Causa: a conta de WhatsApp Business (WABA) está sem forma de pagamento. A Meta aceita a chamada e recusa a entrega depois — por isso o silêncio.
Solução: abra o WhatsApp Manager da Meta → sua WABA → Faturamento, e cadastre um cartão. Depois disso, o envio funciona sem precisar refazer nada no BFlow.
Este é, disparado, o erro mais comum em conta nova.
#O número ficou em "Pendente" e não conecta
Causa: a autorização chegou, mas do lado da Meta falta concluir alguma coisa — verificação do negócio, confirmação do número, ou aceite de termos.
Solução: abra o WhatsApp Manager e resolva o que estiver pendente lá. O portal atualiza o estado sozinho no próximo carregamento da tela de Configurações.
#"O número já está em uso"
Causa: o número ainda está ativo no WhatsApp comum ou no aplicativo WhatsApp Business.
Solução: desinstale/desconecte o número naquele aparelho e refaça a conexão. Se o número precisa continuar no celular da equipe, use outro para o Theo.
#Erro ao criar mensagem modelo — categoria
Sintoma: o portal recusa a criação com erro de categoria.
Causa: a Meta classificou o texto como Marketing, e não como utilidade.
Solução: reenvie aceitando a categoria sugerida. O efeito prático é o custo por mensagem, não a aprovação.
#Erro ao criar mensagem modelo — nome já usado
Causa: já existiu um modelo com esse nome. A Meta reserva o nome por até algumas semanas depois da exclusão.
Solução: crie com um nome ligeiramente diferente (por exemplo, acrescentando um número de versão).
#O Theo respondeu com atraso enorme
Causa provável: o WhatsApp entrega em lotes quando a rede do cliente oscila, e o Theo agrupa mensagens em rajada de propósito (para não responder três vezes a uma frase quebrada em três balões).
Quando é problema: atraso constante de minutos em toda conversa. Nesse caso, registre horário e número, e fale com o suporte.
#Mensagens enviadas pelo portal não aparecem para o cliente
Verifique nesta ordem:
- O canal está Conectado em Configurações (e não Pendente).
- A janela de 24 horas está aberta — se fechou, o campo de texto some e vira o botão Reengajar.
- O cliente não bloqueou o número.
#O cliente disse que recebeu de outro número
Causa: existe mais de um número conectado, ou o número foi trocado recentemente. Confira em Configurações qual está ativo.