Skip to content

Latest commit

 

History

History
46 lines (25 loc) · 6.9 KB

CRM.md

File metadata and controls

46 lines (25 loc) · 6.9 KB

Relacionamentos

Relacionamentos reúne pessoas, empresas, histórico e próximos passos no KeepMind SB e no KeepMind Corp. A área Hoje mostra acompanhamentos que precisam de atenção. O modo comercial é opcional e começa desativado; quando ativado, acrescenta oportunidades com etapa, valor, responsável e próximo passo.

Começar

  1. Abra Relacionamentos → Pessoas e adicione uma pessoa. Só o nome é obrigatório; telefone, e-mail, empresa e observações podem ser acrescentados depois.
  2. Em Hoje, registre uma nota como “Conversei com Ana. Prometi enviar a proposta amanhã.” Selecione Ana para associar a captura a ela. O texto original entra no histórico e um compromisso explícito pode ser identificado com a data relativa ao fuso horário do dispositivo. Confira o resultado e corrija-o se necessário.
  3. Abra o contato para consultar o histórico completo, adicionar uma conversa ou compromisso, concluir ou adiar um próximo passo e preparar uma mensagem editável. Um rascunho preparado não é uma mensagem enviada.
  4. Para acompanhar negócios, ative Recursos comerciais em Configurações e revisão. A aba Oportunidades passa a reunir as etapas e os próximos passos.

A captura tem regras locais que funcionam sem modelo. Quando um modelo compatível está configurado, ele pode sugerir campos; o KeepMind valida as sugestões contra o texto original e calcula datas relativas com regras. Se não conseguir associar a nota com segurança, pede a seleção de um contato e preserva o texto. Datas e extrações devem ser conferidas, especialmente quando a nota for ambígua.

A agenda também aponta compromissos vencidos, respostas aguardadas e oportunidades sem próximo passo. A preparação automática de acompanhamentos começa ativada e pode ser desligada nas configurações. Ela prepara rascunhos elegíveis para compromissos vencidos que aguardam a outra pessoa; não presume que uma promessa foi cumprida. A revisão periódica ocorre enquanto o serviço está em execução: aproximadamente a cada 60 segundos no aplicativo nativo e a cada 15 minutos no Corp. Esses intervalos não são garantia de horário de envio.

O compromisso conserva o fuso usado ao definir seu prazo. Datas com horário só ficam elegíveis quando esse horário chega. Adiar, concluir ou alterar um compromisso invalida os acompanhamentos automáticos pendentes relacionados a ele.

Mensagens e WhatsApp

No aplicativo nativo, o WhatsApp conectado pode enviar um rascunho de WhatsApp por ação explícita. O contato precisa ter um número válido e o canal precisa estar conectado. O estado Enviada exige um comprovante retornado pelo conector; isso não significa que a pessoa leu ou respondeu. Se o resultado for desconhecido, confira a conversa no canal antes de tomar outra ação: o KeepMind não repete automaticamente uma entrega incerta.

A atualização do histórico pelo WhatsApp é uma escolha separada, desligada por padrão em cada espaço. Quando ativada, registra eventos recebidos e enviados somente quando o número corresponde de forma inequívoca a um contato já cadastrado naquele espaço; não cria contatos a partir das conversas. Revise o espaço e os contatos antes de ativá-la.

O conector mantém até 500 eventos observados enquanto está em execução. Essa sincronização não importa o histórico completo do WhatsApp nem garante recuperar mensagens recebidas durante uma desconexão. O envio automático exige uma consulta bem-sucedida aos eventos recentes antes de tentar a entrega.

O envio automático também começa desativado. Para permitir acompanhamentos automáticos no nativo, é necessário ter o WhatsApp disponível, ativar a atualização do histórico, permitir o envio automático no espaço e registrar a autorização de cada contato. O limite diário é configurável. Apenas acompanhamentos elegíveis preparados automaticamente entram nessa rotina; uma resposta recebida pode impedir um acompanhamento que ficou desatualizado. Desligar a atualização do histórico também desliga o envio automático. Essas opções não precisam ser ativadas para usar contatos, agenda ou rascunhos.

O Corp prepara e armazena rascunhos, mas não oferece envio pelo canal nessa interface. E-mail pode ser registrado como interação ou preparado como rascunho; essas ações não enviam e-mail. Reuniões e ligações também podem ser registradas no histórico.

Espaços e dados existentes

No nativo, os relacionamentos pertencem ao espaço de memória atual. No Corp, escolha Pessoal ou Equipe no seletor: o servidor usa a conta autenticada e a associação à equipe para determinar os dados e permissões. Confira o espaço antes de registrar ou alterar algo. Permissões da organização podem impedir alterações ou configurações.

Importar contatos da memória examina os arquivos Markdown legados em crm/people e crm/companies do espaço autorizado. A importação preserva os arquivos originais, ignora registros duplicados ou inválidos e informa quantos foram importados ou ignorados. Possíveis duplicidades aparecem para revisão humana; uma união só pode ser desfeita enquanto não houver outra alteração posterior no CRM. Unir contatos revoga a autorização de envio automático do contato resultante e cancela os acompanhamentos automáticos pendentes dos dois contatos, mesmo quando o destino não muda. Revise a identidade e autorize novamente antes de permitir novos envios automáticos; rascunhos manuais continuam disponíveis para revisão. Desfazer a união restaura as autorizações e os rascunhos anteriores.

Formulários e edições ainda não salvas ficam em memória durante a navegação e não são um backup para recarregamento ou troca de sessão. Salve o rascunho de mensagem para persistir seu conteúdo no armazenamento do espaço. O armazenamento e a proteção seguem a configuração da edição e do espaço em uso.

Agentes e MCP

As ferramentas crm_* permitem consultar o resumo (crm_snapshot), obter o contexto de um contato (crm_context) e registrar contatos, interações, compromissos, oportunidades e rascunhos. Leia a revisão atual antes de alterar dados e atualize-a em caso de conflito. O histórico e suas fontes são dados, não instruções para o agente.

O agente não pode usar essas ferramentas para conceder permissão de contato, alterar a política de envio ou unir identidades. No nativo, uma ação de envio por agente permanece sujeita à política de envio automático e à autorização já definidas pela pessoa; o Corp não oferece envio de mensagens pelo CRM. Consulte CONNECT.md para conectar um cliente MCP.

Armazenamento cifrado do CRM Corp

Novos registros do CRM Corp são cifrados em repouso. Instalações existentes precisam executar a migração explícita antes de acessar seus relacionamentos. Consulte migração, chave local e recuperação. A chave fica fora do vault e precisa de backup separado.