Gestão de Clientes

O módulo de Clientes permite cadastrar e gerenciar toda a sua base com suporte a pessoas físicas (CPF) e pessoas jurídicas (CNPJ), múltiplos endereços, tags gerenciadas com cores e alertas de aniversário.

Cadastrando um Cliente#

1. Acesse o módulo Clientes e abra o submódulo Clientes
2. Toque em Novo Cliente
3. Selecione o Tipo de Pessoa: Pessoa Física ou Pessoa Jurídica
4. Preencha os campos desejados
5. Toque em Salvar

Campos — Pessoa Física#

Campos — Pessoa Jurídica#

Adicionando Endereços#

Após salvar o cliente, acesse a tela de detalhe e abra a seção Endereços:

1. Toque em Novo Endereço
2. Selecione o Tipo de Endereço: Residencial, Comercial ou Cobrança
3. Informe o Nome (apelido do endereço, ex: "Casa", "Trabalho")
4. Marque Definir como endereço padrão se aplicável (disponível ao criar)
5. Preencha o CEP, Logradouro, Número, Complemento, Bairro, Estado e Cidade
6. Toque em Salvar

Cada cliente pode ter múltiplos endereços. O endereço padrão é sugerido automaticamente em operações de venda e entrega.

Preenchimento Automático por CEP#

Ao digitar um CEP com 8 dígitos, o sistema consulta a base de endereços (ViaCEP) e preenche automaticamente os campos de Logradouro, Bairro, Complemento, Estado e Cidade. A busca é acionada de forma inteligente (com um pequeno atraso após você terminar de digitar), evitando consultas a cada tecla.

Você só precisa completar o Número. Caso a base não reconheça o CEP (mensagem "CEP não encontrado") ou o serviço esteja indisponível, os campos permanecem editáveis para preenchimento manual — nada é bloqueado.

Tags de Clientes#

Tags são entidades gerenciadas por tenant — cada tag tem um nome único, uma cor personalizada e uma descrição opcional. Isso garante consistência (sem duplicatas por erro de digitação) e permite ver a contagem de clientes por tag.

Gerenciando o Catálogo de Tags#

1. No módulo Clientes, abra o submódulo Tags
2. Toque em Nova Tag
3. Defina o Nome (ex: "VIP", "Recorrente", "Revendedor")
4. Adicione uma Descrição opcional para orientar a equipe
5. Escolha uma Cor na paleta ou crie uma cor personalizada
6. Toque em Salvar

Para editar, inativar ou excluir uma tag, abra-a na lista de tags e use as opções disponíveis.

Atribuindo Tags a Clientes#

No formulário de criação ou edição do cliente, a seção Tags exibe as tags ativas do tenant divididas em Selecionadas e Disponíveis:

• Toque em uma tag Disponível para adicioná-la — ela passa para Selecionadas
• Toque na tag selecionada (ou no ícone de remover) para tirá-la
• Um cliente pode ter múltiplas tags simultaneamente
• Use Nova Tag no topo da seção para criar uma tag sem sair do formulário

Filtrando por Tag#

Na lista de clientes, o painel de filtros oferece dois controles complementares de tags:

• Marcação — restringe o resultado por presença de tags:
  • Todos — não filtra por presença de tags
  • Com tag — apenas clientes que possuem ao menos uma tag
  • Sem tag — apenas clientes sem nenhuma tag
• Tags — selecione uma ou mais tags específicas. Apenas clientes com todas as tags selecionadas serão exibidos (lógica E).

Aniversariantes#

Clientes com Data de Nascimento cadastrada aparecem no widget Aniversariantes, disponível na aba de insights do módulo Clientes e no dashboard:

• Hoje — clientes que fazem aniversário no dia atual
• Próximos 7 dias — clientes com aniversário em breve

Clientes que fazem aniversário no dia ganham um selo Aniversário hoje na lista de clientes.

Atividades e Acompanhamento#

Cada cliente possui um histórico de atividades (Ligação, E-mail, WhatsApp, Reunião, Visita e Nota), com status Planejada ou Concluída. Acesse a seção Atividades na tela de detalhe do cliente para registrar e acompanhar o relacionamento. Ao criar uma atividade Planejada você informa a data Agendada para; ao marcar como Concluída, a data Concluída em.

Linha do Tempo de Atividades#

No módulo Clientes, abra o submódulo Atividades para ver a linha do tempo consolidada de todo o tenant. A lista pode ser filtrada por:

• Status — Planejada ou Concluída
• Tipo de Atividade — Ligação, E-mail, WhatsApp, Reunião, Visita ou Nota
• Período — intervalo de datas

Painel de Atividades (Dashboard)#

O insight Atividades no dashboard resume, em um cartão, as métricas-chave de engajamento:

• Planejadas — atividades agendadas
• Hoje — atividades planejadas com vencimento no dia
• Atrasadas — atividades planejadas em atraso
• Feitas mês — atividades concluídas no mês corrente

Cada métrica leva direto à linha do tempo de atividades já filtrada pelo recorte correspondente.

Filtros da Lista#

A lista de clientes suporta filtros combinados:

Dicas#

• Use tags para segmentar sua base por perfil: "VIP", "Recorrente", "Revendedor", "Inadimplente"
• Adicione descrição às tags para que toda a equipe entenda o critério de uso
• Inative tags obsoletas em vez de excluir — clientes existentes mantêm o vínculo
• Cadastre a Data de Nascimento para aproveitar o widget de aniversariantes
• Inative clientes inativos em vez de excluí-los para preservar o histórico
• Na tela de detalhe, os contatos de Email, Telefone e WhatsApp abrem o aplicativo correspondente ao toque
• CPF e CNPJ são exibidos com formatação automática