Clientes

Módulo Geral

O módulo de Clientes centraliza o cadastro de todas as pessoas que compram produtos ou agendam serviços na sua empresa. O cliente pode ser cadastrado por você, chegar automaticamente pelo WhatsApp ou nascer de uma venda — quando o cliente pede o CPF na nota, o cadastro dele é feito ali, com o documento que ele informou.

📍 Como Acessar

Menu lateral → Clientes (/dashboard/clientes). Nas abas ao lado da lista: Veículos, Mensalidades e Satisfação

Permissão necessária: Todos os papéis (exceto Cliente) podem visualizar. Criação e edição dependem das permissões configuradas.

Tela Principal (Lista)

A tela mostra todos os clientes da empresa. Funcionalidades:

Buscar: Digite o nome, o telefone ou o CPF/CNPJ — com ou sem pontuação
Filtrar por status: Ativos ou inativos
Ver detalhes: Clique no cliente para ver histórico completo
Editar: Atualize os dados do cliente
Gerenciar endereços: Adicione ou edite endereços de entrega
Exportar: Exporte a lista para Excel (se disponível)

O cliente do balcão: só o CPF já é cadastro

Na mercearia o cliente diz o CPF para sair na nota e não diz mais nada: sem nome, sem telefone, com a fila esperando. Esse cliente cabe no cadastro — o telefone deixou de ser obrigatório, e o nome também não é cobrado.

A única exigência: uma das duas coisas

Todo cliente precisa de telefone ou CPF/CNPJ. Qualquer um dos dois serve e você escolhe qual tem à mão. Se faltarem os dois, a tela avisa: "Informe o telefone ou o CPF/CNPJ do cliente".

A exigência existe porque sem nenhum dos dois ninguém acha essa pessoa depois — nem pela busca, nem pelo documento. Já o nome fica opcional de propósito: cadastro sem nome é melhor que um cadastro chamado "Cliente", que não é ninguém e ainda atrapalha a busca de todos os outros.

São dois caminhos, e o do balcão é o mais curto:

Com a fila esperando: em Nota avulsa, digite o CPF no campo do documento e mande pôr na nota. O sistema procura o cadastro daquele número e, se não existir, cadastra na hora — sem abrir formulário nenhum.
Com calma, aqui: em Clientes → Novo Cliente, preencha o que tiver. Deixando o nome em branco, a lista mostra o cliente pelo documento — por exemplo CPF 529.982.247-25 —, e não como uma linha vazia. Depois, quando ele der o telefone, basta abrir o cadastro e completar.

O mesmo CPF nunca vira dois cadastros. Um documento é uma pessoa: CPF repetido é a mesma pessoa, então o sistema reaproveita o cadastro que já existe e apenas o vincula à sua empresa. Assim o histórico dela continua junto, em vez de partido em dois cadastros que ninguém junta depois.

Cupom aceita só o documento; nota de mercadoria não. A NFC-e (modelo 65), que é o cupom da venda de balcão, sai com o CPF e mais nada. A NF-e (modelo 55) exige nome e endereço do cliente, porque é a nota que acompanha a mercadoria na rua. Então, para vender com nota para uma empresa, complete antes o cadastro: nome, CEP, logradouro, número e estado (UF). Sem isso a venda fecha e o dinheiro entra normalmente — só a nota fica pendente.

Clientes via WhatsApp

Quando a integração com WhatsApp está ativa, os clientes são criados automaticamente:

Cliente envia mensagem para o WhatsApp da empresa
Sistema verifica se o telefone já existe no cadastro
Se não existir, cria um novo cliente com o número
O nome é obtido do perfil do WhatsApp (se disponível)
Conversa é registrada no histórico

Clientes criados automaticamente podem ter dados incompletos. Você pode atualizar o cadastro a qualquer momento.

Endereços do Cliente

Cada cliente pode ter múltiplos endereços cadastrados para entregas:

CEP: Busca automática do endereço pelos Correios
Logradouro: Rua, avenida, etc.
Número: Número do imóvel
Complemento: Apartamento, bloco, etc.
Bairro: Nome do bairro
Cidade / UF: Cidade e estado
Ponto de Referência: Facilita a localização
Endereço Principal: Define qual é o padrão para entregas

O endereço principal fica nos campos do próprio cadastro. Os demais endereços do cliente (entrega, comercial) ficam na seção Outros endereços, logo abaixo, ao editar o cliente.

Tela de Detalhes

Ao clicar em um cliente, você vê seus dados completos e histórico:

Informações disponíveis:

Dados cadastrais completos
Lista de endereços cadastrados
Histórico de pedidos (modelo Produto/Ambos)
Histórico de agendamentos (modelo Serviço/Ambos)
Histórico de conversas pelo WhatsApp
Totais: valor gasto, número de atendimentos

Dicas e Avisos

Telefone deve ser único: Não é possível ter dois clientes com o mesmo telefone. Ele pode ficar em branco — no cliente que só informou o documento —, mas quando existe, é de uma pessoa só. Vale o mesmo para o CPF/CNPJ.

Cada empresa vê só os seus clientes. O cadastro da pessoa é único no SyncCore, mas a lista, a busca e os campos de escolher cliente (novo atendimento, comanda, venda, nota avulsa, orçamentos, agenda, mensalidades) mostram apenas os clientes da sua empresa — mesmo digitando o telefone ou o CPF/CNPJ completo. Se a busca não achou, cadastre: quando a pessoa já existe no SyncCore, o sistema reaproveita o cadastro dela (procurando pelo CPF/CNPJ, depois pelo telefone) e só a liga à sua empresa, sem duplicar. O cadastro sai igual ao de um cliente novo; nos campos que estavam vazios entra o que você digitou, e o resto você muda depois, editando. Se o telefone ou o CPF/CNPJ já é de um cliente da sua empresa, aparece "Já existe Maria Souza com esse telefone. Usar esse cadastro?" — Usar esse cadastro abre o que já existe, ou Corrigir volta ao formulário. Limite: cada usuário cadastra até 10 clientes por minuto (na importação, 500 por hora). Passou disso, aparece "Muitos cadastros de clientes em pouco tempo. Aguarde um minuto e tente de novo."

Excluir um cliente não apaga a pessoa. O que a exclusão faz é desvincular o cliente da sua empresa: ele sai da sua lista, e o cadastro dele continua existindo — com as outras empresas que o atendem, e com o histórico dele. Nenhuma empresa apaga cliente no SyncCore, porque o cadastro não é de uma empresa, é de todas.

Se você não escolheu uma empresa no seletor do topo, a exclusão não acontece: não há de qual empresa desvincular, e o sistema pede que você escolha.

O campo Observações é muito útil para guardar informações importantes, como: "Alérgica a tintura X", "Prefere corte mais curto", "Sempre pede sem cebola".

Cadastro único: editar e histórico

A ficha de uma pessoa fica guardada uma vez só, e não uma vez por empresa: nome, CPF/CNPJ, telefone, WhatsApp, e-mail, inscrições, foto e endereço servem igualmente a todas as empresas que atendem essa pessoa. Por isso a sua lista mostra quem é cliente seu, e não todo mundo que existe no sistema.

Ao sair do campo CPF/CNPJ

O sistema confere os dois dígitos do fim, que existem justamente para acusar erro de digitação: se algum número saiu trocado, o campo fica vermelho ali mesmo. Enquanto você digita, nada de vermelho. Nenhuma busca na base é feita aqui.

O que você corrige, todos passam a ver

Qualquer empresa que atende a pessoa pode editar a ficha, e a mudança vale para todas. Use quando tiver certeza — o caso normal: a pessoa está na sua frente.

Telefone ou CPF/CNPJ de outra pessoa não entram. Se o número já é de outro cliente, aparece "Use outro número." (ou "Use outro documento.") e nada é salvo.

Histórico de alterações: cada campo alterado fica registrado com quem alterou, de qual empresa e quando. O gerente vê, no detalhe do cliente, as alterações feitas pela própria empresa ("E-mail: alterado por Ana (Barbearia Centro) em 22/10/2026 14:05"); atendente e profissional não veem o histórico.

Empresas vinculadas a um cliente

Somente administrador

Na lista de Clientes, o botão de prédios na linha abre a janela com as empresas às quais aquela pessoa está vinculada. Para gerente, profissional e atendente o botão não existe: não é um botão cinza pedindo permissão, ele simplesmente não aparece.

O cadastro é um só; o vínculo é por empresa

O cadastro do cliente vale para todas as empresas. Isso não é detalhe técnico: é o que faz o WhatsApp funcionar. A mesma pessoa fala com a barbearia e com a borracharia pelo mesmo número, e se cada empresa tivesse o cadastro dela, ninguém juntaria essas duas pontas depois.

O que existe por empresa é o vínculo: ele diz que aquela pessoa falou com aquela empresa. Ele nasce sozinho, quando a pessoa manda mensagem ou quando alguém a usa num atendimento. E é nele que ficam dois ajustes que cada empresa faz por pessoa:

IA responde — se a IA responde automaticamente a essa pessoa nessa empresa. Desligue quando alguém for atender no lugar do robô.
Resumo de contexto — o que a IA precisa saber sobre essa pessoa nessa empresa ("prefere corte na tesoura", "trocou os quatro pneus em agosto"). Esse texto vai no prompt da IA.

Os dois valem só para aquela empresa: desligar a IA na barbearia não desliga na borracharia, e o resumo de uma não é lido pela outra.

Nada é salvo sozinho: quem salva é o botão da linha. Enquanto houver alteração pendente, a linha mostra a etiqueta "Não salvo". É de propósito. Você pode estar num celular com internet ruim, e salvamento automático que falha calado é o pior desfecho, porque a tela parece ter gravado. E o resumo é texto longo que viaja no prompt da IA: "Cliente não quer" salvo antes de "…receber lembrete de manutenção" é pior do que não salvar nada. Se o salvamento falhar, o erro aparece na própria linha e o que você digitou continua no campo.

Remover o vínculo: o que faz e o que não faz

Faz: a empresa deixa de ver a pessoa na lista dela, e o resumo de contexto e o ajuste de IA que aquela empresa tinha sobre ela são perdidos, porque são dados do vínculo. As conversas e os atendimentos que já existem não são apagados. A ação pede confirmação, porque para aquela empresa ela é destrutiva.

Não faz: não apaga o cliente. A pessoa continua cadastrada, e os vínculos dela com as outras empresas continuam intactos, com o resumo e a IA de cada uma. O vínculo pode nascer outra vez, bastando a pessoa voltar a falar com a empresa.

Removendo o último vínculo, a pessoa fica cadastrada e sem empresa nenhuma — e a tela diz isso com essas palavras, para ninguém concluir que apagou o cliente e cadastrar a mesma pessoa de novo, em duplicidade.

Pedido do cliente sobre os dados dele (LGPD)

Quando o cliente pedir uma cópia do que você guarda sobre ele, abra o cliente na lista e, no fim da janela, use Exportar dados (LGPD): em PDF para entregar a ele, ou em JSON se ele pedir o arquivo. Quando ele pedir para ser excluído, use Excluir/anonimizar e digite ANONIMIZAR para confirmar. Só o dono ou o gerente da empresa vê esses botões.

Excluir tira o cliente da sua empresa e apaga o que só você guardava sobre ele. As notas fiscais ficam guardadas por 5 anos, como a lei manda, e os relatórios continuam com os valores certos. O passo a passo está em Dados pessoais (LGPD).

Dica: Mantenha o cadastro de clientes atualizado para melhorar a comunicação e personalização do atendimento via WhatsApp.