Description
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
keywordsarray 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.jsonfile 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.
Installation
- Upload the
gmss-agentfolder to/wp-content/plugins/(or install through the Plugins screen in WordPress). - Activate the plugin through the Plugins screen.
- Go to Settings > gmss-agent and customize the widget title, welcome message, fallback message, primary color, and position.
- Create a file named
knowledgebase.jsonat the root of your WordPress install (the same folder aswp-config.php). The Settings page shows the exact expected path and a format example. A sample file ships with the plugin atwp-content/plugins/gmss-agent/knowledgebase-sample.json— until you create your own, the widget will answer using the sample. - Visit your site front-end; the chat widget will appear in the configured corner.
FAQ
-
Does this plugin send anything to a third party?
-
No. Visitor questions are matched against your local
knowledgebase.jsonfile on your own server. No external service is contacted, no API key is required, and no visitor data leaves your site. -
How does the matching work?
-
For each question, the plugin scores every entry in your knowledge base. A point is awarded each time a query word matches the entry’s body, three points when it matches the entry’s title, and five points when it matches one of the entry’s optional
keywords. The entry with the highest non-zero score wins; if nothing scores above zero, the visitor sees your configurable fallback message. -
What is the knowledge base file format?
-
A JSON array of objects, each with a
contentstring and an optionaltitleandkeywordsarray. The Settings page shows a complete example, and a sample file is bundled with the plugin. -
Can I use synonyms or alternate phrasings?
-
Yes — add a
keywordsarray to any entry. For example, an entry titled “Pricing and Quotes” might list["price", "cost", "quote", "discount"]so the widget answers regardless of which word the visitor types. -
What happens when no entry matches?
-
The visitor sees the fallback message you configured on the Settings page. The default is “I’m not sure how to answer that. Please contact our team for help.”
-
Does it work on multisite?
-
Yes. Each site stores its own settings. The uninstall routine cleans options across the entire network.
-
Where is the knowledge base file expected?
-
In the root of your WordPress installation — the same folder as
wp-config.php. The Settings page shows the exact filesystem path on your server.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“gmss-agent” is open source software. The following people have contributed to this plugin.
Contributors
Translate “gmss-agent” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Removed all external API dependencies. Replies are now generated locally by matching visitor questions against the knowledge base file.
- Renamed
knowledgebase.jstoknowledgebase.jsonand dropped the JS-wrapper parser in favor of pure JSON. - Added optional
keywordsarray on each entry for synonym matching. - Added a configurable fallback message setting for unmatched queries.
- Removed the Anthropic API key and AI model settings.
1.0.0
- Initial release.