Clientes

Objetivo

/clientes é a visão-mãe da carteira comercial. Ela reúne todos os contatos do workspace em uma planilha flexível e destaca quem merece atenção, sem substituir os fluxos especializados:

• Prospecção: primeiro contato e reativação de pessoas sem negócio aberto.
• Follow-up: continuidade de negócios abertos que precisam avançar.
• Foco do Dia: execução da agenda priorizada para hoje.
• Clientes: exploração, organização e leitura completa da carteira.

Comportamento

• Busca por qualquer dado principal do cliente, mesmo quando a coluna está oculta.
• Filtros rápidos para falar hoje, sem próximo passo, esfriando e clientes antigos.
• Filtros combináveis de temperatura, próximo passo, responsável e oportunidade.
• Colunas visíveis e ordem personalizáveis, incluindo todos os campos personalizados de CONTACT; a preferência fica salva no navegador por usuário.
• Edição pela própria tela de nome, cargo, e-mail, telefone, empresa, responsável, temperatura manual e campos personalizados de Contatos.
• Links para perfil, negócio, WhatsApp, Prospecção ou Mentor conforme a ação sugerida.
• Limite de 2.000 registros carregados; a interface avisa quando a carteira ultrapassa esse teto.

Arquitetura da inteligência

A tela possui três camadas separadas:

1. Fatos: contatos, mensagens, e-mails, reuniões, atividades de contato e negócios já registrados no CRM.
2. Sinais determinísticos: atraso, atividade de hoje, próximo passo futuro, resposta pendente, esfriamento, oportunidade e prioridade. São regras testáveis e sempre exibem o motivo.
3. Leitura do Jordão: interpretação sob clique na linha. Usa somente os fatos e sinais enviados, devolve diagnóstico, evidências, ação e, quando houver base, uma mensagem sugerida. AiArtifact é a única fonte durável e idempotente: a chave inclui o digest completo dos fatos, dia de referência, prompt, versão e modelo, e a reutilização também respeita status e expiração. Chamadas concorrentes compartilham o mesmo artefato e somente o gerador vencedor consome crédito.

A página nunca chama IA para toda a base durante o carregamento.

Regras das colunas e dos sinais

• Responsável: Contact.ownerId. Nunca é inferido do negócio, porque uma pessoa pode participar de vários negócios.
• Última interação: o evento real mais recente entre WhatsApp visível ao usuário, e-mail, reunião realizada e atividade concluída cujo tipo representa contato humano. Tarefas administrativas não contam.
• Próximo passo exibido: primeira atividade pendente de hoje ou futura. A classificação usa o dia no fuso de São Paulo; uma tarefa de hoje mais cedo continua rotulada “Hoje”, não “Vencida”.
• Sem próximo passo: existe negócio aberto e não existe atividade depois do instante atual. Uma atividade antiga ou de hoje já ultrapassada continua urgente, mas não mascara a necessidade de agendar a continuidade. Essa definição é compartilhada por Clientes, Funil, Follow-up e Rotina.
• Falar hoje: há resposta do cliente pendente, atividade vencida ou atividade prevista para hoje.
• Esperando resposta: última mensagem inbound, conversa ativa e conteúdo não é um encerramento óbvio como “obrigado”.
• Esfriando: sem interação há 30 dias (ou nenhuma interação), com relacionamento comercial, sem resposta pendente e sem ação prevista nos próximos 14 dias.
• Oportunidade: cliente que já comprou e está sem negócio aberto, ou valor aberto que ficou sem próximo passo/esfriando.
• Potencial: soma dos valores de negócios abertos visíveis ligados ao contato.
• Já comprou: soma dos valores de negócios ganhos visíveis ligados ao contato.

Temperatura e prioridade

A página não dispara IA em massa durante o carregamento. Ela consolida sinais já existentes e aplica regras determinísticas e explicáveis:

• Quente: participação recente e recorrente do cliente, ou conversa analisada como quente com movimento recente.
• Morno: interação nos últimos 30 dias com resposta do cliente ou sinal morno já analisado.
• Frio: ausência de interação ou engajamento recente.

O usuário pode definir uma temperatura manual. A interface identifica a origem manual e permite voltar ao cálculo automático sem apagar o histórico de interações.

A prioridade considera, nesta ordem aproximada: cliente esperando resposta, atividade atrasada ou de hoje, negócio aberto sem próximo passo, esfriamento e oportunidade de recompra. Cada ação mostra sua justificativa ao passar o cursor.

Segurança

Todas as consultas e edições recebem o workspaceId validado no servidor. Contatos usam o responsável real e seguem a política de carteira OPEN, OWN e TEAM; nos modos privados, contatos sem responsável formam um pool visível que pode ser reivindicado. A Lista, a ficha, os seletores e suas actions aplicam a mesma autorização também às relações aninhadas: negócios privados não entram em títulos/contagens e conversas privadas não entram em timeline, métricas ou fatos enviados à IA. Responsável, empresa e campos personalizados são validados como pertencentes ao mesmo workspace. Há testes positivos e negativos de ownership, concorrência e isolamento entre workspaces.

Limitações da primeira versão

• A configuração de colunas é local ao navegador; sincronização entre dispositivos exigirá preferência persistida no servidor.
• Os sinais não alteram o CRM automaticamente. A decisão humana continua necessária para enviar mensagem, concluir atividade ou criar negócio.