Clientes

A base de clientes concentra o histórico e os contatos de quem já agendou. Todo agendamento é vinculado a um cliente — isso permite acompanhamento, histórico e disparos automáticos.

Como o cliente entra na base

Cadastro manual — você adiciona pelo painel.
Agendamento público — quando alguém marca via /book/[slug], se o telefone informado não existir ainda, vira cliente novo na hora.
Bot WhatsApp — primeira vez que alguém conversa pelo bot e completa um agendamento, o cliente é criado com o número de WhatsApp como telefone.
Importação por CSV — pelo botão Importar no topo da tela, você traz a base de outra planilha ou sistema sem cadastrar um a um.

Importação por CSV

O importador aceita arquivos com pelo menos as colunas nome e telefone. Campos como email, nascimento, tags e observacoes são opcionais.

Se um telefone já existir na sua base, você escolhe o comportamento da importação: pular o registro existente ou atualizar os dados dele.

Busca e filtro por tag

No topo da lista tem um campo de busca que filtra por nome ou telefone (aceita formatado ou só dígitos). Logo abaixo aparece uma linha de chips com todas as tags ativas no tenant — clicar filtra para só quem tem aquela tag. Busca + tag combinam.

Cada tag dentro da linha também é clicável — vira atalho para filtrar por ela.

Ficha do cliente

Clique em um nome na lista para ver:

Dados de contato (telefone, e-mail, aniversário), tags livres e observações editáveis direto na página.
Botão Abrir WhatsApp para abrir a conversa com 1 clique e Ficha PDF para gerar o relatório completo.
Cards de métricas: visitas concluídas, total gasto, ticket médio, frequência, última visita, próximos agendamentos e serviço preferido.
Badge de aniversariante quando o nascimento está a menos de 30 dias.
Badge VIP (top 10% por receita em 12 meses) e Risco de falta (≥30% de no-show no histórico, mín. 3 atendimentos) — ambos persistidos por crons diários, aparecem também na agenda e no header da conversa do WhatsApp. Quem tem Risco de falta é forçado a pagar sinal no agendamento público mesmo quando o serviço não exige (mín. 30%).
Botão Bloquear no header da ficha — bloqueio manual que impede o cliente de agendar pelo link público e pelo bot do WhatsApp (mensagem genérica sem expor motivo). Atendimento via painel continua possível — bloquear é decisão de não receber agendamento espontâneo, não de banir do estabelecimento. Motivo é opcional e fica só pro registro interno. Quando bloqueado, badge cinza Bloqueado aparece na ficha e o botão vira Desbloquear.
Fidelidade (quando ativo nas configurações) — mostra progresso e marca quando o cliente fica elegível à recompensa.
Lista dos últimos 12 atendimentos com serviço e valor.
Pacotes — sessões pré-pagas que o cliente comprou, com saldo restante e botão para debitar uma sessão.
Extras por ramo: Pets (petshop), Veículos (lava-jato), Prontuário (clínica), Projetos (tatuagem), Odontograma (odonto) — cada um com CRUD inline.
Ficha clínica (odonto, clínica humana, estética): card de Anamnese com link público via WhatsApp pro paciente preencher antes da consulta, e card de Receituário com emissão de PDF. Detalhes na seção Ficha clínica.

Indicação entre clientes (referral)

Tanto no cadastro novo do painel quanto no agendamento público /book/[slug] tem o campo opcional “Quem te indicou?” — o cliente novo digita o telefone de quem o indicou. Se bater com algum cliente seu, a indicação fica registrada (one-shot — não muda depois, mesmo se o cliente editar a ficha).

Na ficha do cliente, aparecem dois links no topo: “Indicado por X” e “Indicou Y clientes”. O segundo abre a lista completa de quem aquele cliente trouxe pra base + receita gerada por cada um.

Em Relatórios > Indicações você vê o ranking dos top 20 indicadores, com total de indicações e LTV (receita de atendimentos concluídos). Boa base pra um programa de recompensa ou só pra agradecer.

Portal do cliente final

Cada ficha tem um card “Portal do cliente” com botão de enviar via WhatsApp ou copiar link. É um link mágico (válido 30 dias) onde o cliente vê:

Próximos agendamentos com botão de cancelar (até 2h antes).
Saldo de pacotes ativos.
Últimos 5 atendimentos concluídos.
Botão “Reagendar via WhatsApp” que abre a conversa com você.

Não exige cadastro nem senha — o link em si autentica. Ideal pra anexar nos lembretes 24h/1h: cliente já chega no portal pronto pra confirmar ou cancelar sem ligar pra recepção.

Em Configurações > Portal do cliente você decide: (1) permitir cancelamento pelo portal (off = todo cancelamento passa pela recepção), (2) antecedência mínima em horas (0 a 168 — 0 permite cancelar até último minuto, 24h é típico em clínicas) e (3) um aviso opcionalque aparece na confirmação antes de cancelar (ex.: “Cancelamentos com menos de 24h são cobrados em 50%”). Se o cliente tentar cancelar fora da janela, o botão some e ele vê uma orientação pra falar com você.

Telefone como chave

O telefone (E.164 sem +, ex.: 5511987654321) é a chave única do cliente dentro do tenant. É por ele que o bot identifica o cliente quando ele manda mensagem.