Chatbot Local para WordPress: não deixe que uma IA responda por você

Aqui está o plugin Chatbot Local em funcionamento; é o mesmo chat que você sempre encontrará aqui.

Se você pesquisar por “chatbot” no repositório do WordPress, encontrará centenas de plugins baseados em IA ou serviços externos. A IA está em toda parte. É impossível encontrar algo simples e leve que permita criar um chat de atendimento baseado apenas nas suas respostas. Foi assim que surgiu o Chatbot Local, em busca de algo que eu não encontrei. Embora eu saiba que, hoje em dia, com a quantidade de plugins que existe, é mais do que provável que apenas três ou quatro pessoas o instalem, acredito que esse plugin preencha uma lacuna.

Há algum tempo, compartilhei aqui um sistema básico, por meio de código, para adicionar um chatbot de lógica difusa (Fuzzy Search) no WordPress, baseado em palavras-chave. É leve, funciona bem, não depende de nenhuma IA, nem de APIs externas ou chamadas a terceiros, e preserva a privacidade. No entanto, implementar isso exigia lidar com trechos de código, colar blocos manualmente ou editar arquivos do tema. Algo que nem todo mundo quer ou sabe fazer.

Para resolver isso, desenvolvi o Chatbot Local, que em breve estará disponível como plugin no repositório do WordPress; enviei-o para revisão no dia 2 de agosto, e você já pode testá-lo. Por enquanto, ele está em inglês, mas será traduzido no repositório assim que for necessário.

6 de agosto: Já recebi a primeira revisão (com resposta mista de IA e humana) e, no repositório, para evitar um possível conflito de nomes com algo “genérico” ou de marca (que eu não vi em lugar nenhum), o plugin passará a se chamar JRMora Local Chat Assistant (nome sugerido por eles). É muito mais longo e pretensioso. Não gosto, mas assim ele passou pelo filtro.

Não me parece uma boa estratégia incluir tanta IA na resposta, porque o resultado é um e-mail interminável que confunde mais do que ajuda.

29 de agosto. O plugin é aprovado no repositório após as correções necessárias.

Por que trocar o snippet por um plugin específico?

Ao contrário de inserir funções avulsas no arquivo functions.php do seu tema ou em um gerenciador de snippets, empacotá-lo como um plugin nativo permitiu estruturar tudo muito melhor, melhorar a segurança, adicionar um painel de administração e resolver questões-chave relacionadas ao desempenho e ao banco de dados:

1. Carregamento condicional estrito de recursos (WPO)

Um dos principais problemas ao adicionar código manualmente é controlar quando os estilos e scripts são carregados. No JRMora Local Chat Assistant, tanto o CSS quanto o JS só são adicionados à fila se a página ou postagem contiver ativamente o shortcode [chatbot-local]. Se o shortcode não estiver no conteúdo, o plugin não carrega absolutamente nada nessa URL.

2. Painel de controle visual e gerenciamento da base de conhecimento (perguntas e respostas)

Chega de ter que editar manualmente matrizes de PHP ou arquivos JSON via FTP. No menu de administração do plugin, você pode:

• Configurar as regras em JSON: Um editor dedicado com validação para definir suastags erespostas, que funciona nos bastidores; você só vê duas caixas simples para inserir o texto de cada pergunta e sua respectiva resposta.

Você pode adicionar palavras isoladas separadas por vírgulas ou frases que, mesmo que contenham essas palavras isoladas, gerarão um resultado diferente, o que permite refinar as respostas para frases específicas e abranger mais possibilidades.

• Personalização de estilos: É possível alterar as cores do cabeçalho, do botão e do texto “Enviar”, do plano de fundo e dos balões de bate-papo. Se você deixar a caixa de seleção do estilo padrão marcada, ele será exibido com o CSS do seu blog.

• Detector de shortcodes: O painel verifica o banco de dados e exibe uma lista das páginas ou posts em que você inseriu o shortcode.

3. Registro de consultas por meio da API REST nativa

O chatbot inclui sua própria tabela leve no banco de dados (wp_chatbot_logs). Cada interação do usuário é enviada por meio de um endpoint seguro da API REST do WordPress, o que permite visualizar no painel as últimas 100 consultas com estas referências e opções:

• Quais perguntas tiveram resposta (correspondentes).
• Quais pesquisas não foram atendidas (unmatched), o que é ideal para saber quais conteúdos ou palavras-chave você ainda precisa adicionar à base de conhecimento para melhorar as respostas e abranger mais possibilidades de consultas reais.
• Exclusão em massa ou individual de registros diretamente da tabela de logs.

4. Privacidade e segurança

Privacidade de dados (Zero PII): Não são armazenados endereços IP, dados do usuário nem cookies. O único dado que é enviado ao banco de dados é o texto da pergunta e o status (correspondente ou não correspondente).

Segurança e Sanitização: O endpoint da API REST limpa e desinfeta as entradas com a função ` sanitize_text_field() ` antes de realizar qualquer consulta.

Consultas seguras (proteção contra injeção de SQL): Utilizamos o método nativo $wpdb->insert() do WordPress, que prepara e escapa automaticamente todos os valores de forma segura por meio de marcadores de posição (%s).

Sem divulgação a terceiros: todas as informações ficam armazenadas no seu próprio servidor (na tabela wp_chatbot_logs). Não há chamadas externas nem serviços externos acessando esses registros.

5. Desinstalação completa (Zero Bloat)

Se você decidir excluir o plugin, inclua uma opção explícita de “limpeza completa” que elimine a tabela de logs e todas as opções salvas na tabela options, deixando o banco de dados exatamente como estava.

Também tenho ajustado a taxa de resposta e, no meu caso, consegui um CLS de 0,016 no celular e de 0,018 no computador nas postagens em que o chatbot é exibido. Como ainda há alguma margem para melhoria, na próxima atualização tentarei reduzi-lo.

Como funciona

O princípio continua sendo o mesmo que defendi no primeiro post: privacidade e velocidade.

1. Sem APIs externas: Não utiliza OpenAI, ChatGPT nem servidores de terceiros. Todo o processamento de palavras-chave ocorre localmente, por meio do Vanilla JS.
2. Normalização de texto: O algoritmo remove acentos e converte letras maiúsculas em minúsculas para encontrar correspondências com precisão.
3. Conversão automática de links: Se a resposta incluir uma URL (http:// ou https://), o script a converte automaticamente em um link HTML clicável.

Instalação rápida

1. Baixe, instale e ative o plugin e acesse o novo menu emConfigurações/Chatbot Local para configurar sua mensagem de boas-vindas e suas regras.
2. Cole o shortcode [jlca-chatbot-local] em qualquer página, postagem ou widget onde você queira exibir o assistente.

Se você tiver alguma sugestão, encontrar algum detalhe que precise ser aprimorado ou qualquer outra coisa, pode deixar um comentário no suporte ou pelo formulário de contato.

Este é o meu quinto plugin; aqui estão todos eles.