Ficha do cliente: o que tem em cada parte e como usar - Ajuda

A ficha do cliente é o ponto de entrada para tudo o que diz respeito a um paciente já cadastrado. É nela que você confere o histórico, lança um crédito, abre o WhatsApp, vê as fotos de evolução, ajusta o bloqueio e acompanha o status.

Este guia mostra o que tem em cada parte da ficha e como cada uma te ajuda no dia a dia.

Como abrir a ficha

A ficha fica na rota /app/clientes/:id. Os caminhos mais comuns:

Pela lista de clientes — em Clientes → Lista de Clientes, clique no nome do cliente.
Pela busca global — campo de busca no topo do CRM.
Pela conversa do WhatsApp — no painel do lead, clique em Abrir ficha.
Pelo funil — ao mover um lead para “Ganho”, o card redireciona para a ficha do novo cliente.
Pela venda finalizada — depois de lançar uma venda no PDV, o sistema abre a ficha do cliente.

As duas partes da ficha

A ficha tem um cabeçalho (sempre visível no topo) e um conjunto de abas (abaixo). Em mobile, o cabeçalho se adapta; em desktop, ele ocupa a largura toda.

Cabeçalho (sempre visível)

Foto do cliente — clique para abrir o modal de upload/troca. A foto é vinculada ao lead, então sincroniza com WhatsApp se o cliente trocar.
Nome — pode ser editado inline (clique no ícone de lápis). Salva com Enter ou no ✓.
Status — badge colorido que mostra a situação atual do cliente (veja “Os 6 status do cliente” abaixo).
Membro desde — quando o lead virou cliente (data da primeira venda ou marcação de “Comprou”).
Tags — gestor de etiquetas, alimentado pelo que a clínica configurou em Cadastros → Tags. Útil para segmentar (ex.: “VIP”, “Pós-cirúrgico”, “Acima do peso”).
Interesses — gestor de interesses, alimentado pelos procedimentos/serviços que o lead demonstrou querer. Alimenta o funil e o relatório de “Interesses” da clínica.
Ações rápidas:
- WhatsApp — abre o WhatsApp do cliente em nova aba (usa o telefone do cadastro; se não tiver, usa o remote_jid).
- Conversa — abre a conversa do WhatsApp direto no CRM (em /app/conversas?lead_id=...).
- Menu de ações (ClientActionsMenu) — opções administrativas, incluindo bloquear/desbloquear o cliente (veja “Bloqueio de cliente” abaixo).

Abas de conteúdo (clicáveis)

A ficha tem até 8 abas (algumas dependem de permissão):

Aba	O que mostra	Quem vê
Resumo	Visão geral do cliente: dados de contato, status, próximo agendamento, créditos, financeiro resumido, atividade recente	Todos
Cadastro	Dados completos: pessoais (CPF, data nasc, sexo, profissão), contato (telefones, e-mail), endereço (CEP, rua, número, complemento, bairro, cidade, estado), foto	Todos
Agendamentos	Histórico de agendamentos (passados e futuros) e lista de espera	Permissão `clientes.ver_agendamentos`
Clínico	Anamnese, prontuário, fotos de comparação, evolução nutricional, aplicações faciais (módulo facial)	Profissionais de saúde
Comercial	Vendas, propostas, sessões (sessões agendadas, realizadas, faltou), crédito disponível	Recepção, gestores
Arquivos	Anexos, fotos de antes/depois, exames enviados	Permissão `clientes.anexos.visualizar`
Documentos	Termos de consentimento (assinados e pendentes), recibos, contratos	Recepção, gestores
Histórico	Timeline unificada: cada interação registrada (mensagem WhatsApp, agendamento, venda, mudança de status, nota da equipe)	Todos

A ordem das abas segue o fluxo natural: olhe o Resumo para ter o contexto, abra o Comercial para vender, o Clínico para atender, o Histórico para investigar.

Os 6 status do cliente

O status do cliente é calculado pelo sistema a partir de regras automáticas — você não precisa setar manualmente (exceto o bloqueio, que é manual). Os 6 status são:

Status	Cor	Quando acontece
Ativo	Verde	Cliente compareceu nos últimos 30 dias
Inativo	Amarelo	Sem comparecimento há 30+ dias (threshold configurável)
Finalizado	Azul	Plano/tratamento concluído (todos os créditos realizados)
Abandonado	Amarelo	Cliente com créditos restantes que parou de vir há muito tempo
Negativado	Vermelho	Cliente com pendência financeira ativa (boleto/compra em atraso)
Cancelado	Cinza	Cliente cancelou o plano/contrato

O threshold de 30 dias é a referência padrão — a clínica pode ter um valor diferente configurado internamente. O status é calculado, não digitado: muda automaticamente conforme o comparecimento e o financeiro do cliente.

Como o status muda automaticamente

Cliente compareceu hoje → continua/sai do status atual
30 dias sem comparecimento → vira Inativo
Plano concluído (todos os créditos realizados) → vira Finalizado
Plano cancelado (formalmente) → vira Cancelado
Cliente com pendência financeira → vira Negativado
Voltei a ter comparecimento recente → volta para Ativo

Use o status para segmentar campanhas: cliente inativo há 60+ dias é o público ideal de uma campanha de reativação (cupom de “sentimos sua falta”). Cliente negativado é melhor contatar pelo financeiro, não pelo marketing.

Bloqueio de cliente

O bloqueio é diferente do status — é uma marcação manual que impede o cliente de fazer novas ações no sistema até ser desbloqueado. Use para casos extremos (inadimplência grave, comportamento inadequado, suspeita de fraude).

Como bloquear: no menu de ações do cabeçalho, escolha Bloquear e informe o motivo (texto obrigatório). Salva com o usuário e a data.
O que muda quando bloqueado:
- A ficha mostra um badge Bloqueado no cabeçalho.
- A venda no PDV é bloqueada (não dá pra lançar).
- O cliente não consegue ser agendado pela agenda.
- Mensagens automáticas param de sair.
- A conversa do WhatsApp fica visível (você continua podendo atender), mas ações de venda/agendamento travam.
Como desbloquear: mesmo menu, escolha Desbloquear. O motivo do bloqueio anterior fica registrado no histórico.
Quem pode bloquear: permissão administrativa (gerentes/diretoria). O bloqueio fica registrado na auditoria.

Não use o bloqueio para “lembrar de cobrar amanhã” — pra isso existe o status Negativado, que é automático e não impede o cliente de comprar.

Permissões

Ver ficha: leitura de clientes.
Editar dados pessoais (cadastro): permissão clientes.editar.
Editar nome (inline): mesma permissão.
Bloquear/desbloquear: permissão administrativa.
Ver aba Agendamentos: clientes.ver_agendamentos.
Ver aba Arquivos: clientes.anexos.visualizar.

Perguntas rápidas

Não acho a ficha do cliente pela lista. Use a busca por nome ou telefone. A lista tem busca fuzzy: 3+ caracteres já filtra.

O status está como “Inativo” mas o cliente veio semana passada. Pode ser que o atendimento não foi marcado como Atendido ainda (ainda está como “Compareceu” sem finalizar). Finalize a sessão na agenda e o status atualiza.

O cliente está bloqueado e não consigo lançar a venda. Desbloqueie antes (gerentes podem). Se o bloqueio é para cobrar dívida, combine o pagamento com o cliente e desbloqueie — o histórico registra tudo.

Posso mudar o status manualmente? O status é automático, não editável. O que você pode fazer é bloquear (manualmente) ou garantir que as ações (atendimento finalizado, plano concluído) aconteçam para o sistema recalcular.

Como sei se o cliente tem crédito? Olhe o Resumo — a seção “Créditos e Procedimentos” mostra o saldo, com cores diferentes para disponível/agendado/realizado. Detalhes em Créditos do paciente.

Quero ver o que o cliente fez por WhatsApp. Clique em Conversa no cabeçalho (ou na aba Histórico se preferir o feed unificado).

Dúvidas sobre como configurar tags, interesses ou regras de status? Chame o suporte pelo WhatsApp — a gente configura junto com você.