Pular para o conteúdo principal

Clientes

🛂 Permissões: customer.view, customer.create, customer.edit, customer.delete 🔒 Plano: total de clientes limitado por max_customers. 📍 Caminho: Clientes & Vendas → Clientes

A base de clientes é compartilhada entre todos os canais: vendedor, loja online e agente de IA por WhatsApp. Toda venda com cliente identificado alimenta a inteligência comercial e a comissão.

Tipos de cliente​

TipoOrigemCaracterística
B2B (cadastrado por vendedor)PainelVinculado a uma tabela de preço, pode ter prazo de pagamento, condições especiais.
B2C (auto-cadastro)Loja onlineSenha hasheada — pode logar no portal e ver o histórico.
Agente de IAWhatsAppCadastrado automaticamente quando manda mensagem pela primeira vez.

Portal unificado: clientes com hashed_password podem logar em loja.../minha-conta e ver todos os pedidos (independente do canal).

Campos do cadastro​

Identificação​

  • Nome / Razão Social
  • CPF/CNPJ (validado)
  • E-mail
  • Telefone / WhatsApp

Endereços​

Um cliente pode ter vários endereços (entrega, cobrança, secundário). O endereço-padrão é usado em pedidos novos.

Geolocalização​

Cada endereço pode ter latitude/longitude — preenchidas no cadastro ou rodando o script de geocodificação em lote.

Comercial​

  • Tabela de preço padrão (Tabelas de preço)
  • Limite de crédito (informativo)
  • Condições de pagamento (texto)
  • Vendedor responsável — usuário que ganha as comissões automáticas dos pedidos deste cliente.

Notas internas​

Texto livre, visível só para a equipe.

Como criar / editar​

  1. Em Clientes & Vendas → Clientes, clique em Novo Cliente ou edite um existente.
  2. Preencha os campos.
  3. (Opcional) Adicione múltiplos endereços.
  4. Salve.

Importação em massa​

Para grandes volumes (migração de ERP), use o Importador (ferramenta auxiliar) ou a API pública (API Keys). Suporta CSV com mapeamento de colunas.

O que a inteligência comercial faz com o cliente​

Se o plano tiver commercial_intelligence_enabled, cada cliente ganha:

  • Score RFM (recência, frequência, valor) e segmento (champion, at-risk, hibernating, etc.).
  • Recomendações de cross-sell e reposição.
  • Alertas automáticos (compra atrasada, ticket caindo, abandono de carrinho).

Detalhes em Inteligência comercial.

Excluindo um cliente​

A exclusão é restrita: clientes com pedidos vinculados não podem ser apagados (ficaria órfão). Em vez disso, desative o cliente (toggle no formulário). Histórico permanece intacto.

Limite do plano​

A criação de novos clientes é bloqueada quando o tenant atinge max_customers. Faça upgrade para aumentar.

Boas práticas​

  • Cadastre o CPF/CNPJ sempre — chave para deduplicar leads vindos de canais diferentes (loja, vendedor, IA).
  • Vincule vendedor responsável mesmo que a venda seja online — assim a comissão sai certa quando este cliente comprar.
  • Geocodifique endereços antes de operar com DISTANCE_BASED (Frete).
  • Use notas internas para combinados ("não tocar a campainha", "entregar pelos fundos").