Addon de vtiger que responde perguntas consultando os dados do próprio CRM, com a fronteira de segurança desenhada antes da funcionalidade.
O problema
Colocar IA sobre um CRM é fácil de fazer errado. O caminho ingênuo é dar ao modelo uma conexão de banco e pedir que ele escreva a consulta, o que transforma qualquer instrução hostil no meio de uma conversa em acesso administrativo. E responder "quantos contatos existem" sem consultar os dados produz um número inventado, que é pior que não responder.
A arquitetura
A IA não fala com o banco: fala com quatro ferramentas declaradas — buscar registros, contar registros, descrever módulo e criar registro — e decide sozinha quando invocá-las. Toda a fronteira de segurança vive em um arquivo único, propositalmente, para que revisar a superfície de risco seja ler um arquivo. São quatro travas: lista branca de módulos, que alcança Contatos, Organizações, Leads, Oportunidades, Chamados, Produtos, Serviços e Atividades e nunca Usuários ou Configurações; ausência de qualquer caminho para SQL arbitrário, com toda leitura e escrita passando pelas APIs do vtiger que já aplicam permissão; execução com a permissão do usuário logado, de modo que quem não vê Oportunidades pela interface também não vê pela IA; e auditoria em tabela própria de tudo que a IA cria, com quem pediu e quais campos. A criação de registros nasce desligada. O provedor padrão é compatível com a API da OpenAI e oferece modelos gratuitos, então o addon funciona sem custo de inferência.
O resultado
Módulo instalável pela interface do vtiger (Configurações → Módulos → Importar módulo) ou por linha de comando, com instalador que encontra a instalação sozinho, teste de ponta a ponta e manual dentro da própria aplicação. Duas armadilhas do provedor ficaram tratadas no código e documentadas: o User-Agent obrigatório, sem o qual o Cloudflare responde 403 com um código de erro que não explica a causa, e o mínimo de tokens de 300, porque os modelos gratuitos raciocinam antes de responder e com orçamento baixo devolvem resposta vazia parecendo travamento.
🔒 Código-fonte
git clone https://git.programandosolucoes.com.br/git/repos/vtiger-addon-assistente-ia.gitCódigo-fonte privado. As credenciais de leitura são liberadas sob solicitação — me chame para conversar sobre o projeto.