Solução de problemas

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.

WhatsApp 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.

Cliente 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.

Login 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.

Cobranç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.

Bot 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.

App 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.

Push 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%.

Agenda 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.

Cartã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.

Cliente 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.

Bot 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.