Aspired Chatbot

Description

Aspired Chatbot helps site owners answer common questions using only approved business information.

The plugin is built for sites that want a controlled chatbot experience instead of a general-purpose AI assistant. You decide what information is allowed into the knowledge base, and the chatbot uses that approved content when responding to visitors.

Features

  • Manual knowledge base management
  • Site scanner for pages and posts
  • Allowed-topics fallback behavior
  • OpenAI-powered replies using approved knowledge base context
  • Analytics with transcripts, CSV export, and unanswered question tracking
  • Per-page conversation starters
  • Prompt preview for administrators
  • Human handoff email and URL settings
  • Rate limiting for chat requests
  • Optional uninstall cleanup

How it works

  1. Add your OpenAI API key in the plugin settings.
  2. Add approved business information to the knowledge base manually or import it from your site with the scanner.
  3. Place the chatbot on the site frontend.
  4. When a visitor sends a message, the plugin checks the approved knowledge base context and sends the message plus that approved context to OpenAI.
  5. If the knowledge base does not contain relevant information, the plugin falls back to a restricted reply instead of inventing an answer.

External Services

This plugin connects to the OpenAI API to generate chatbot responses.

Service: OpenAI
Website: OpenAI
API Endpoint: https://api.openai.com/v1/responses
Service terms: https://openai.com/policies/terms-of-use

Data sent to the service:
* The visitor’s chat message
* Approved knowledge base context selected from your site
* Your configured system prompt/instructions
* The selected OpenAI model needed to complete the request

When data is sent:
* Only when a visitor submits a chat message and a response is requested

Why data is sent:
* To generate a chatbot reply based on the approved knowledge base context configured by the site owner

Service privacy policy:
* https://openai.com/policies/privacy-policy

Data storage

This plugin stores data in your WordPress database.

It creates the following custom database tables:
* aspich_kb for approved knowledge base entries
* aspich_analytics for analytics events, transcripts, unanswered question tracking, and related chatbot activity

The analytics table may store data such as:
* Visitor chat messages
* Bot replies
* Event type
* Page URL
* Session hash used for rate limiting and conversation tracking

Plugin settings are stored in the standard WordPress options table.

The plugin also stores chat history and widget state in the visitor’s browser using localStorage so the conversation can continue across pages on the same browser/device.

Privacy

When the chatbot is used, visitor-submitted chat messages are sent to OpenAI to generate responses.

This plugin may store the following data in the WordPress database:
* Chat messages submitted by visitors
* Chatbot responses
* Event types (such as message sent or suggestion click)
* Page URLs where interactions occur
* A generated session hash used for rate limiting and conversation tracking
* Unanswered question records for analytics

The plugin also stores chat history and widget state locally in the visitor’s browser using localStorage to maintain conversation continuity across pages.

This plugin does not:
* Track users across sites
* Store personal data beyond what is submitted in chat messages
* Share data with any third-party service other than OpenAI

Site owners are responsible for updating their privacy policy to disclose:
* Use of OpenAI as a third-party processor
* Storage of chat transcripts and analytics data
* Use of browser localStorage for chat persistence

Upload-ready notes

  • No obfuscated code
  • No hidden remote control behavior
  • No frontend exposure of the OpenAI API key
  • External service usage is disclosed above

Screenshots

  • Settings screen with General and AI Model tabs
  • Knowledge Base management screen
  • Site Scanner screen for importing approved content
  • Analytics screen with transcripts and unanswered questions

Installation

  1. Upload the plugin folder to the /wp-content/plugins/ directory, or install it through the WordPress Plugins screen.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. Go to Aspired Chatbot > Settings.
  4. Add your OpenAI API key under the AI Model tab.
  5. Configure the chatbot settings.
  6. Add knowledge base entries under Aspired Chatbot > Knowledge Base.
  7. Optionally review pages and posts under Aspired Chatbot > Scanner and import approved content into the knowledge base.

FAQ

Does this plugin answer from the entire website automatically?

No. You control what goes into the approved knowledge base. The scanner helps you review site content, but you still decide what should be added.

Is the OpenAI API key exposed on the frontend?

No. The API key is stored in WordPress settings and used only on the server side.

Can I choose the AI model?

Yes. The AI Model tab includes the API key, model, allowed topics, and system prompt settings.

What happens if the chatbot cannot find a relevant answer?

The plugin returns a restricted fallback response and can direct the visitor to approved topics or a handoff destination you configure.

Does uninstall remove plugin data?

Only if you enable the cleanup option in settings. If enabled, the plugin deletes its settings and custom database tables during uninstall.

Does this plugin store user data?

Yes. The plugin can store chat transcripts and analytics data in WordPress, and it stores chat history locally in the visitor’s browser using localStorage so the conversation can continue across pages.

Does this plugin send data to a third-party service?

Yes. Visitor-submitted chat messages, approved knowledge base context, system instructions, and the selected model are sent to OpenAI only when a chatbot response is requested.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Aspired Chatbot” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Aspired Chatbot” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

  • Initial release.