gmss-agent

gmss-agent adds a customizable floating chat widget to every page of your WordPress site. Visitor questions are answered by matching them against a JSON knowledge-base file you provide. Everything runs locally on your server — no API key, no third-party service, no visitor data sent anywhere.

The plugin is designed for support, FAQ, and lightweight pre-sales conversations where you want answers limited to information you have written and approved.

Features

• Floating chat widget with configurable title, welcome message, primary color, and corner position (bottom-right or bottom-left).
• Local matcher with weighted token-overlap scoring: title hits and explicit keyword hits are ranked above body hits, with a phrase bonus when the visitor’s full query appears in an entry.
• Optional keywords array on each entry to handle synonyms the body text does not contain.
• Configurable fallback reply when no entry matches the visitor question.
• JSON knowledge base loaded from a single knowledgebase.json file at the root of your WordPress install.
• Ships with a sample knowledge base so the widget answers something out of the box.
• REST endpoint protected by a WordPress nonce.
• Translation-ready (text domain: gmss-agent).

Requirements

• WordPress 5.8 or newer and PHP 7.4 or newer.

Privacy

The plugin does not set cookies, does not write to any custom database tables, does not contact any external service, and does not log visitor messages on your server. Settings are stored in the standard WordPress wp_options table and are removed when the plugin is uninstalled via the Plugins screen. The knowledge base file you create is read from disk on each request and is never transmitted off your server.