Lista de clientes: filtros, exportação e visões salvas

A Lista de Clientes é a tela onde você vê todos os clientes cadastrados da clínica de uma vez, com filtros, busca, exportação e atalhos para a ficha de cada um. Use para conferir a base, segmentar campanhas, conferir inadimplência ou simplesmente achar um cliente específico.

Este guia cobre os filtros, a exportação, as visões salvas e os atalhos do dia a dia.

Como abrir a lista

Clientes → Lista de Clientes (rota /app/lista-clientes).

A lista abre por padrão mostrando todos os clientes, com paginação (50 por página). Use os filtros para refinar.

Os filtros

A barra de filtros fica no topo da lista. Você pode combinar vários ao mesmo tempo — todos são salvos na URL, então dá pra favoritar uma combinação específica (veja “Visões salvas” abaixo).

Busca livre

O campo buscar (lupa) filtra por nome, telefone, e-mail ou CPF, com busca fuzzy (3+ caracteres já filtra). É o jeito mais rápido de achar um cliente específico.

Filtros estruturados

• Status do cliente — ativo, inativo, finalizado, abandonado, negativado, cancelado. Use para ver só os inativos (campanha de reativação) ou só os negativados (cobrança).
• Funil + Etapa — clientes de um funil específico e em uma etapa específica. Útil se sua clínica tem funis diferentes para segmentos diferentes (ex.: emagrecimento vs. estética).
• Cidade — filtro geográfico.
• Profissional (se disponível) — clientes vinculados a um profissional.
• Origem — canal de aquisição (Meta Ads, Google, indicação, WhatsApp).
• Período — clientes que entraram na base em um período (mês passado, trimestre, ano).

Filtros vazios = “qualquer valor”. Para limpar todos os filtros de uma vez, use o × Limpar filtros (quando disponível) ou recarregue a página sem parâmetros na URL.

As visões salvas

Depois de configurar uma combinação de filtros que você usa com frequência, salve como visão. Da próxima vez, é só clicar e abrir a mesma lista instantaneamente.

Como salvar:

1. Configure os filtros (busca, status, cidade, funil…).
2. Clique em Salvar visão (no menu Visões salvas da barra de filtros).
3. Dê um nome (ex.: “Inadimplentes — SP”, “Aniversariantes ativos”, “VIPs ativos”).
4. Salve.

A visão aparece no menu Visões salvas e pode ser marcada como padrão (abre direto quando você entra na lista). Outras pessoas da equipe podem ter as próprias — cada visão é por usuário.

A URL da lista com os filtros aplicados é compartilhável: cole o link no chat interno e o colega abre exatamente a mesma lista.

O que cada linha mostra

Cada linha da lista tem:

• Avatar (foto do cliente) + nome.
• Telefone / WhatsApp (com máscara).
• Status (badge colorido — veja Ficha do cliente para o significado de cada cor).
• Funil e etapa (se o cliente está em algum funil).
• Cidade.
• Membro desde (data de cadastro).
• Ações — clique no nome para abrir a ficha, ou use o menu de ações da linha para abrir WhatsApp, bloquear, etc.

Clique no nome (não no telefone nem no status) para abrir a ficha do cliente.

Exportação CSV

Para análises externas (planilha, mailing em outra ferramenta, controle fiscal), use o botão Exportar CSV no topo da lista. O arquivo vem com 14 colunas:

1. Nome Completo
2. CPF (formatado)
3. Data de Nascimento
4. Sexo (Masculino / Feminino / vazio)
5. Profissão
6. WhatsApp / Telefone (formatado)
7. E-mail
8. CEP
9. Rua
10. Número
11. Complemento
12. Bairro
13. Cidade
14. Estado (UF)

A exportação respeita os filtros ativos — se você filtrou por “Inadimplentes em SP”, o CSV vem só com esses. Para exportar tudo, limpe os filtros antes de exportar.

Linhas sem valor em um campo (ex.: cliente sem CPF) ficam em branco no CSV. Abra na planilha e formate como quiser.

Ações em lote (futuro)

A versão atual não tem ações em lote (selecionar 10 clientes e aplicar a mesma tag, por exemplo). Se a sua operação precisa disso, peça ao suporte — está no roadmap.

Atalhos úteis

• Clicar no nome — abre a ficha.
• Clicar no telefone — abre o WhatsApp do cliente.
• Clicar no status — não tem ação; só mostra info.
• Busca com Enter — força o filtro.
• Esc no campo de busca — limpa.

Permissões

• Ver lista: leitura de clientes.
• Exportar CSV: mesma permissão de ver.
• Salvar/editar visões: por usuário; cada um vê só as próprias.
• Ações da linha (bloquear, etc.): dependem da permissão específica (geralmente gerenciais).

Quando usar a lista vs. a página de status

• Lista de Clientes = visão geral, com filtros e exportação. Bom para achar um cliente, conferir cadastros, segmentar.
• Status dos Clientes (/app/clientes-status) = visão executiva por status, com cards de contagem e exportação PDF. Bom para reportar para a gerência.

As duas telas têm dados parecidos, mas a página de Status é otimizada para digerir métricas, não para operar cliente a cliente.

Boas práticas

• Salve visões para o que você olha toda semana. “Inativos há 60+ dias” e “Negativados ativos” são as duas visões que mais destravam campanha e cobrança.
• Não exporte a base inteira sem filtro. O CSV tem 14 colunas e, com 5.000 clientes, vira um arquivo complicado de abrir. Filtre antes.
• Use a busca fuzzy. Digite parte do nome — o sistema encontra mesmo com erro de digitação.
• URL compartilhável = bom para alinhar com a equipe. Cole o link no chat interno: “Olha a lista de inativos que eu filtrei”.

Perguntas rápidas

A lista está vazia mesmo tendo clientes cadastrados. Os filtros estão restringindo demais. Limpe todos os filtros (URL sem parâmetros) e veja se aparecem.

O cliente está na lista, mas o telefone está em branco. O cadastro foi feito só com nome (mínimo obrigatório). Peça o telefone e atualize pela aba Cadastro da ficha.

Posso ver clientes de outras clínicas da rede? Não. O sistema é multi-clínica e cada operador vê só a base da clínica ativa. Se você administra várias, troque de clínica no seletor do topo.

A exportação não trouxe todos os clientes. Provavelmente tem filtro ativo. Limpe e exporte de novo — ou use o botão Exportar (sem filtro) se disponível.

Como saber quantos clientes tenho no total? No rodapé da lista (ao lado da paginação) tem o total de registros. Ou use a página Status dos Clientes, que mostra contadores por status.

Precisa de ajuda para configurar visões, segmentar campanhas ou treinar a equipe a usar a lista? Chame o suporte pelo WhatsApp — a gente ajuda.