Solução de problemas
WhatsApp desconectou, cliente não recebe, login, etc
Solução de problemas — visão geral
Index dos problemas mais comuns: WhatsApp desconectou, cliente não recebe mensagem, login falha, cobrança não confirma, agenda não atualiza. Cada um tem artigo dedicado com diagnóstico passo a passo.
3 minWhatsApp desconectou
Badge WhatsApp vermelho ou cinza. Causas: celular sem internet, servidor reiniciou, sessão expirou. Diagnóstico em 3 passos. Reconectar via QR code ou pairing code. v0.26.6+ tem retry exponencial — não assume desconectado em latência.
4 minCliente não recebe mensagem
Cliente fala 'não recebi'. Causas mais comuns: WhatsApp do cliente bloqueou seu número, número formatado errado, cliente sem WhatsApp ativo, ou evento simplesmente não disparou. Diagnóstico passo a passo verificando direto na conversa + checks do WhatsApp.
4 minLogin não funciona
Erros comuns: senha errada, email não confirmado (recém-cadastrou), conta bloqueada (dunning 15+ dias), magic link expirado. Recuperação por email é o caminho default. Suporte resolve casos extremos.
3 minCobrança não confirma
Cliente jura que pagou, mas cobrança continua 'pendente' na Kontato. Causas: webhook Asaas perdido, latência banco, polling Pix expirou. Diagnóstico: confere no Asaas direto, marca manualmente se necessário.
4 minBot não agenda
Cliente pediu agendamento e bot respondeu 'vou anotar' em vez de criar. 5 causas comuns: agenda não configurada, sem serviço associado, fora do horário, conversa pausada ou KB sem horário. Diagnóstico passo a passo.
4 minApp travando ou lento
Causas comuns: cache PWA antigo (após nova versão), conexão fraca, navegador velho, conta com 1000+ conversas. Fix do cache: hard refresh ou desinstalar PWA. Problema persistente em desktop = limpa cookies.
3 minPush notification não chega
Push usa AG Push (FCM + Web Push). Causas mais comuns: permissão negada no navegador, iOS exige PWA instalado (não funciona em Safari aba), bateria ou foco silencioso, dispositivo não registrado. Re-registrar resolve 80%.
4 minAgenda não sincroniza com Google Calendar
Eventos do Google não aparecem na Kontato (ou vice-versa). Diagnóstico em 4 níveis: status OAuth, toggle por agenda, sync_token válido, webhook ativo. Forçar sync manual e reconexão completa quando nada resolve.
5 minCartão da minha assinatura foi recusado
Banner 'Regularize seu pagamento' apareceu no app — significa que a cobrança automática da sua mensalidade Kontato falhou. Você tem 15 dias antes do bloqueio. Diagnóstico, troca de cartão e desbloqueio automático.
4 minCliente trocou de número
Cliente avisou que trocou de WhatsApp ou já mandou mensagem do número novo (e bot criou perfil duplicado). Como atualizar mantendo histórico, com workaround manual já que F89 (merge) foi removido.
4 minBot respondeu mensagem de grupo, canal ou status?
O bot da Kontato responde apenas conversas privadas individuais. Mensagens em grupos, canais/newsletters, status do contato e listas de transmissão são ignoradas — não viram conversa, não criam cliente, não recebem resposta.
2 min