O que Eu Construi Esta Semana: Módulos do Perfex CRM e UX do Admin
Esta semana eu construí dois módulos do Perfex CRM e uma passagem mais ampla pela UX do admin do Perfex CRM. Não foi uma grande funcionalidade. Foi uma limpeza prática do trabalho que atrasa uma equipe de CRM todos os dias: encontrar o contexto certo, filtrar listas sem lembrar de cada campo, escanear tabelas no celular e enviar atualizações de módulos sem adivinhações.
A parte importante é que mantive o trabalho próximo ao Perfex CRM em vez de construir um segundo sistema ao lado dele. As novas peças são módulos, hooks, melhorias nas listas e verificações de liberação que se encaixam no fluxo de trabalho administrativo existente.
Ideia Central: Manter o Perfex Nativo, Tornar o Trabalho Mais Rápido
a camada administrativa do Perfex CRM já vive dentro do Perfex CRM, então o objetivo não era substituir o Perfex. O objetivo era remover a fricção ao redor dele.
Um CRM geralmente fica bagunçado de pequenas maneiras. As tabelas se tornam difíceis de escanear. O contexto do e-mail fica fora do lead. Os filtros são poderosos, mas a equipe precisa saber os campos exatos antes que possam usá-los. As páginas administrativas móveis tecnicamente funcionam, mas parecem páginas de desktop espremidas em um telefone.
Isso é o que eu trabalhei esta semana. Dois módulos foram mais importantes: Histórico de E-mails e Filtros de IA.
O que Mudou em Termos Práticos
O trabalho se divide em quatro melhorias práticas: melhor contexto do cliente, filtragem mais rápida do CRM, tabelas administrativas mais limpas e liberações de módulos mais seguras. O Histórico de E-mails lida com o problema de contexto. Os Filtros de IA lidam com o problema de busca e segmentação. A passagem do DataTables torna as telas administrativas diárias mais fáceis de escanear. Os portões de liberação reduzem o risco de enviar uma atualização de módulo do Perfex CRM quebrada.
Para busca, o tópico principal são os módulos do Perfex CRM, mas a verdadeira intenção é mais ampla: as equipes querem automação de CRM que não vaze dados, quebre fluxos de trabalho nativos ou force a equipe a aprender um novo painel.
Módulo 1: Histórico de E-mails para Perfex CRM
O módulo de Histórico de E-mails adiciona uma visão de conversa somente leitura aos leads e clientes do Perfex.
O módulo importa mensagens correspondentes de caixas de entrada IMAP configuradas ou de um diretório .eml, e então vincula mensagens somente quando o participante externo corresponde exatamente a um e-mail de contato de lead ou cliente no Perfex. Essa regra de correspondência exata é importante. Ela mantém o módulo útil sem transformá-lo em um índice de busca de e-mails solto.
O módulo não envia e-mails, responde a e-mails, exclui e-mails ou marca mensagens como lidas. Ele é construído como evidência e contexto, não como outra caixa de entrada.
Para a tela do lead, a parte útil é simples: quando eu abro um lead, posso ver o contexto de e-mail mais recente acessível sem sair do CRM. O mesmo contexto também pode apoiar decisões de próximos passos no perfil do lead. Se um lead ficou em silêncio, se o e-mail mais recente muda o status, ou se o membro da equipe precisa de um lembrete da última conversa real, a visualização do CRM tem a evidência próxima.
Eu também adicionei limites mais fortes em torno do e-mail interno. O módulo suporta e-mails ignorados do mesmo domínio e domínios internos adicionais da empresa, para que conversas apenas internas não poluam a visualização do histórico do cliente. Os dados de auditoria existentes não são excluídos apenas porque as regras de visibilidade mudam.
O manuseio de dados é intencionalmente conservador. Ele armazena texto simples, participantes, cabeçalhos necessários para a visualização e as relações exatas do CRM. Não armazena anexos, renderiza HTML, carrega imagens remotas, executa pixels de rastreamento ou mostra iframes. As credenciais são criptografadas, e as importações podem ser testadas primeiro antes de aplicar as mudanças.
Esse é o tipo de automação de CRM em que confio mais: somente leitura onde deveria ser somente leitura, correspondência estrita onde uma correspondência solta criaria ruído, e auditoria suficiente para entender o que aconteceu.
Módulo 2: Filtros de IA para Perfex CRM
O segundo módulo são os Filtros de IA para o Perfex CRM.
A ideia é simples: um membro da equipe descreve a lista que deseja em linguagem simples, e o módulo converte esse pedido em regras de filtro nativas do Perfex.
Isso é útil porque os CRMs já têm lógica de filtragem, mas os usuários muitas vezes não lembram onde cada campo está. Eles sabem o que querem: faturas vencidas, leads de alto valor de uma fonte, projetos ativos com um status específico, tickets que precisam de atenção. O módulo transforma essa intenção no sistema de filtro existente em vez de inventar uma camada de busca separada.
O limite de segurança é o principal recurso. O módulo envia o pedido do usuário e as definições de filtro disponíveis para a OpenAI. Ele não envia as linhas da lista filtrada. Não envia filtros salvos como dados. O modelo não pode retornar SQL, código executável, callbacks brutos ou nomes de colunas arbitrárias. O servidor valida a saída contra uma lista de permissões antes de aplicar qualquer coisa.
A interface do usuário também é construída em torno da recuperação. Se o pedido de IA falhar, o filtro atual do usuário e o texto digitado permanecem intactos. Limpar o filtro de IA restaura o estado exato anterior ao filtro de IA. O botão de varinha está lá para velocidade, mas o resultado ainda se encaixa no comportamento nativo de filtro do Perfex.
Eu também movi a configuração do módulo para a área de Configurações nativas do Perfex, adicionei manuseio de chave de API criptografada somente para escrita e apertei a limpeza de desinstalação em torno das permissões de função. Para atualizações de liberação, o módulo verifica ativos de liberação imutáveis do GitHub, metadados de versão, digest SHA-256, caminhos de arquivo, sintaxe PHP e comportamento de troca no mesmo sistema de arquivos antes de substituir arquivos.
Isso soa chato até que uma atualização de módulo de CRM dê errado. Então é a única coisa que importa.
Listas Administrativas Receberam a Maior Passagem Visual
A parte visível da semana foi a UX da lista administrativa.
Eu trabalhei em uma skin de linha de cartão compacta para DataTables em toda a camada administrativa do Perfex CRM. O objetivo era tornar as telas de lista mais fáceis de escanear sem mudar a fonte de dados subjacente. Os cabeçalhos ganharam indicadores de ordenação mais limpos. As colunas de ordenação ativas agora mostram uma seta de acento mais forte, enquanto as colunas não ordenadas mantêm uma dica mais leve. As ações da linha foram comprimidas em um pequeno menu onde isso fazia sentido, e o transbordo de tags agora usa um padrão +N em vez de esticar a linha.
Os leads também ganharam uma estrutura mais forte. O status foi movido para frente, as ações de contato se tornaram uma coluna de ícone mais clara, e a fonte foi movida para depois, onde pertence. Isso faz com que a tabela seja lida mais como uma fila de trabalho em vez de uma exportação bruta de banco de dados.
Eu também consertei a dor de cache em torno do CSS administrativo usando uma URL custom.css versionada em md5. Essa foi uma pequena mudança com um grande efeito: o cache de navegador imutável não deve deixar a equipe olhando para uma folha de estilo antiga depois que uma correção de UX é enviada.
Trabalho Administrativo Móvel
Um admin de CRM não deve desmoronar em um telefone.
Esta semana incluiu passagens móveis em clientes, leads, projetos, tarefas, faturas, despesas e estimativas. Eu apertei colunas-chave, alvos de toque, entradas, contraste de paginação, comportamentos de rolagem na borda direita, anéis de foco e comportamento em modo escuro.
Isso não é sobre fazer um CRM parecer um aplicativo de consumo. É sobre tornar o trabalho administrativo rápido possível quando alguém está longe de uma mesa. Se um usuário só precisa verificar um lead, escanear uma fatura ou atualizar uma tarefa, a página não deve puni-lo por abri-la no celular.
A Busca da Base de Conhecimento Foi Reconstruída
A lista da base de conhecimento também recebeu uma verdadeira passagem de busca.
Eu adicionei um herói de busca central, contagem ao vivo, destaque, comportamento de Enter e Escape, e um atalho de teclado. Isso transforma a base de conhecimento de uma lista estática em algo mais próximo de uma ferramenta interna. A equipe deve ser capaz de encontrar a resposta certa rapidamente, especialmente quando já está dentro de um fluxo de trabalho de cliente.
O Próximo Passo do Lead Ficou Mais Útil
O widget de próximo passo do lead agora tem um contexto melhor para trabalhar. O Histórico de E-mails pode fornecer contexto de comunicação recente, enquanto o fluxo de trabalho mantém a decisão próxima ao perfil do lead.
Essa é a direção que eu gosto para a IA no trabalho de CRM. A IA não deve flutuar acima do sistema. Ela deve estar ao lado do registro real, usar contexto estreito, explicar a próxima ação e deixar o usuário no controle.
Portões de Liberação e Testes Importam Mais do que a UI
O trabalho menos visível esta semana pode ser o mais importante.
Eu endureci o empacotamento de módulos e os portões de liberação, adicionei verificações em torno das migrações do Histórico de E-mails, testei o comportamento do importador, cobri o empacotamento dos Filtros de IA e adicionei verificações locais de TLS e implantação em torno do ambiente do painel.
A lição é simples: melhorias na UX do admin são apenas credíveis quando o caminho de liberação é chato. Uma skin de tabela bonita não é suficiente se as atualizações de módulo forem frágeis. Um filtro de IA útil não é suficiente se o modelo puder empurrar uma saída de filtro insegura. O contexto do e-mail não é suficiente se o módulo armazenar demais ou vincular mensagens de forma muito solta.
Então, o trabalho foi dividido entre a superfície do produto e a disciplina operacional: telas melhores, módulos mais rigorosos, atualizações mais seguras e modos de falha menores.
O que Eu Tirei Desta Semana
A melhor personalização do Perfex CRM não é aquela que exibe o código personalizado mais. É aquela que faz o CRM existente parecer mais afiado sem quebrar a maneira como as equipes já trabalham.
O Histórico de E-mails torna o registro do CRM mais completo. Os Filtros de IA tornam as visualizações de lista mais fáceis de usar. O trabalho na tabela administrativa torna a varredura diária mais rápida. As correções móveis tornam os mesmos fluxos de trabalho menos dolorosos longe do desktop. Os portões de liberação tornam o trabalho mais seguro para ser enviado.
Essa é a versão da automação de CRM com IA que eu quero continuar construindo: estreita, útil, testável e ligada ao trabalho administrativo real.