A fidelidade da Kontato registra estado atual de cada cartão (progresso, completo, resgatado) — não há histórico transacional de cada selo individual. Este artigo cobre onde consultar o progresso pelo dono e pelo cliente.
Onde o dono vê
1. Página /fidelidade — resumo geral
Acesso: menu lateral → Cartão Fidelidade.
Mostra:
- Status badge: Ativo / Inativo (toggle F33)
- 3 cards numéricos:
- 🟢 Ativos — cartões em andamento (progresso < meta)
- 🏆 Completos — bateu a meta, aguardando resgate
- 📊 Total — total cumulativo de cartões abertos
- Configurações retráteis (regra + bônus + validade)
Visão executiva — não lista clientes individualmente.
2. Página do cliente — /clientes/[id]
Bloco "Cartão fidelidade" (aparece se fidelidade_config.ativa = true):
- Progresso visual: barra com N segmentos (ex: 10), preenchidos em accent dourado conforme
cartao.progresso - Texto:
"7 de 10 selos"ou"10 de 10 selos — Completo! Resgate disponível." - Se cliente nunca teve selo, mostra cartão vazio ("0 de 10 selos")
Útil pra conferir individualmente antes de uma visita ou aplicar resgate.
Esse bloco mostra apenas o estado atual. Não há lista de "quando cada selo foi dado" nem histórico de ciclos passados.
3. Relatório /relatorios/fidelidade
Slug fidelidade da rota dinâmica /relatorios/[slug].
4 métricas agregadas:
- Em aberto — cartões com progresso < meta
- Completos — bateram a meta
- Resgatados — bônus já aplicado, cartão resetou
- Taxa de conversão — % de cartões abertos que viraram resgate
Útil pra entender saúde do programa e ajustar regra (ex: meta muito alta vê taxa de conversão baixa).
Onde o cliente vê
Bot WhatsApp (F37) — único canal
Cliente envia mensagem do tipo:
- "quantos selos eu tenho?"
- "qual meu progresso na fidelidade?"
- "quanto falta pro próximo grátis?"
Bot consulta fidelidade_cartoes via tool dedicada e responde com texto + visual de estrelas. Exemplo:
"Maria, você tem 7 de 10 selos ⭐⭐⭐⭐⭐⭐⭐☆☆☆ no cartão atual. Faltam só 3 cortes pra ganhar 1 corte grátis!"
Não há link público pra cliente. Hoje (v0.28.x) cliente só consulta via WhatsApp. Não existe
/c/[telefone]/fidelidadeou similar.
O que NÃO existe (limitações reais)
Pra evitar confusão, lista das coisas que algumas pessoas esperam mas a Kontato não tem:
| Esperado | Realidade |
|---|---|
| Histórico transacional ("selo dado em DD/MM, selo dado em DD/MM…") | ❌ Só estado atual |
| Lista de resgates passados do cliente | ❌ Cartão reseta, ciclos antigos somem |
| Botão "Ajustar selos" manual | ❌ Selo só vem de presença confirmada em agendamento |
| Filtro "Pronto pra resgate" na lista de clientes | ❌ Tem que abrir cliente individual ou usar relatório |
| Export CSV dos cartões | ❌ Sem export nativo (workaround: print de tela) |
| Link público pro cliente ver fidelidade no celular | ❌ Só via bot WhatsApp |
| "Total de selos vitalícios" do cliente | ❌ Só ciclo atual |
| Notificação automática quando cliente bate a meta | Push P08 envia "Maria resgatou benefício" — mas só no resgate, não no completar do cartão |
Decisão de design: simplicidade > histórico denso. Ciclos antigos somem porque na prática raramente são consultados.
Selo é manual (regra crítica)
Selo é registrado MANUALMENTE pelo dono (cliente pode não comparecer no horário marcado). Dono vê botão "Registrar presença" no card do agendamento do dia.
Sem confirmação de presença → sem selo. Isso é intencional — protege o dono de "auto-fidelidade" (cliente marca, não vai, ganharia selo automático).
Ver configurar regras pra detalhes do fluxo.
Edge cases
Cliente diz que tinha mais selos
Não há ferramenta de auditoria detalhada. Caminhos possíveis:
- Conferir histórico de agendamentos do cliente (lista de visitas confirmadas)
- Se faltou marcar presença em algum, abrir o agendamento e confirmar retroativamente — incrementa selo
- Se o cartão zerou recentemente (resgate aplicado), cliente está confundindo ciclo atual com anterior
Validade do cartão expirou
Se você setou validade_meses (F40) e cliente não completou no prazo:
- Selos ficam zerados ao expirar
- Histórico de quantos eram não é preservado
- Comunicar ao cliente antes da expiração é boa prática (notificação manual via WhatsApp)
Reativar fidelidade desativada
Se você desativou via F33 e reativa depois:
- Selos congelados continuam (não zeram)
- Cliente segue do ponto que parou
Migração de cartão de papel
Cliente tinha 7 selos no cartão físico antigo? Sem ferramenta nativa pra setar manualmente. Workaround:
- Marcar presença retroativa em 7 agendamentos passados (se ainda existem no histórico)
- OU comunicar cliente que o programa novo começa do zero
Próximos artigos
- Visão geral da fidelidade — modelo + exemplos
- Configurar regras — qtd selos + bônus + validade
- Resgate de bônus — como aplicar quando cliente bate meta