A tela /clientes é o CRM da Kontato — todo cliente que já interagiu com seu negócio (via bot ou cadastrado por você) aparece aqui.
O que aparece
Cada linha da lista mostra:
- Avatar com inicial do nome
- Nome do cliente
- Telefone (formatado
(11) 99928-5362) - Tags (chips coloridos, até 3 inline)
- Total de visitas (badge ao lado do nome)
- Última visita ("hoje", "ontem", "há 5 dias", "há 2 meses")
- Indicador de cliente novo (estrela ou cor diferente se nunca visitou)
Buscar cliente
Campo de busca no topo. Funciona em:
- Nome (substring case-insensitive — "mar" acha "Maria", "Mariana", "Marcos")
- Telefone (últimos 8 dígitos via
ilike— você digita99928, encontra(11) 99928-5362)
Busca dispara em tempo real conforme você digita (debounce 250ms).
Filtrar por tag
Botão de filtro abre popover com todas as tags do negócio. Você marca quais quer e a lista filtra. Lógica OR — marcando "VIP" e "Inadimplente", aparece quem tem qualquer uma das duas.
Ordenação
A lista é ordenada por Nome A-Z (alfabética). Toggle multi-modo (última visita, total visitas, cadastrado em) está em roadmap, não disponível ainda.
Wizard "primeiro cliente"
Se a lista está vazia (negócio acabou de criar), a Kontato mostra um wizard amigável com:
- Botão "Adicionar cliente manualmente"
- Botão "Importar contatos do WhatsApp"
- Dica: "Ou espere o bot atender o primeiro cliente — ele vira cadastro automático 🤖"
Click num cliente
Vai pra /clientes/[id] — perfil completo com:
- Dados pessoais (nome, telefone, CPF, aniversário, endereço)
- Tags
- Histórico de agendamentos (passados + futuros)
- Histórico de conversas
- Cartão fidelidade ativo
- Notas internas