Description

ApiroSite Assistant adds a configurable chat widget to your WordPress site. It can crawl published pages and posts into a local knowledge base and answer visitor questions locally. An administrator can explicitly enable external AI processing to use OpenAI, Pollinations.AI, or OVHcloud AI Endpoints.

Features:

Crawl pages and posts into a local knowledge base.
Add custom facts or Q&A entries manually.
Train a site summary from the knowledge base.
Optional OpenAI embeddings for semantic search.
Optional OpenAI API key with encrypted storage.
AI modes: Free only, OpenAI with free fallback, or OpenAI only.
Explicit opt-in before visitor messages or site knowledge are sent to an external AI provider.
Free online fallback providers when external processing is enabled and no API key is configured or the primary provider fails.
Configurable widget design, placement, visibility, tone, language, and content rules.
Response caching with scheduled cleanup.
Public chat endpoint with IP-based rate limiting.
Optional attribution control, disabled by default.

Note: Crawled page content is injected into AI context. Only crawl content you trust, because adversarial text in site content can influence model behavior.

External AI processing is disabled by default. When it is enabled, the plugin may send visitor messages, up to ten recent conversation messages, the generated system prompt, and relevant excerpts from the local knowledge base to an external provider. Do not place secrets or sensitive personal data in the knowledge base. Site owners should explain this processing in their privacy policy and obtain any consent required in their jurisdiction.

External Services

The plugin can communicate with the following external services only after an administrator enables external AI processing in AI Chat > AI Configuration.

OpenAI API

Used when an OpenAI API key is configured. The plugin sends visitor messages, recent conversation context, the system prompt, and relevant site-knowledge excerpts to generate chat responses. During training, selected site-knowledge text may also be sent to create summaries and embeddings.

Service: https://openai.com/
Business terms: https://openai.com/policies/business-terms/
Privacy policy: https://openai.com/policies/privacy-policy/

Pollinations.AI

Used as the first free provider in Free only mode and as a fallback in OpenAI with free fallback mode. The plugin sends visitor messages, recent conversation context, the system prompt, and relevant site-knowledge excerpts to generate a response. No Pollinations account is required by this plugin.

Service: https://pollinations.ai/
Terms: https://pollinations.ai/terms
Privacy policy: https://pollinations.ai/privacy

OVHcloud AI Endpoints

Used as the second free fallback if Pollinations.AI is unavailable. The plugin sends visitor messages, recent conversation context, the system prompt, and relevant site-knowledge excerpts to generate a response. No OVHcloud account is required by this plugin for this fallback endpoint.

Service: https://www.ovhcloud.com/en/public-cloud/ai-endpoints/
Terms and conditions: https://www.ovhcloud.com/en/terms-and-conditions/
Privacy policy: https://www.ovhcloud.com/en/terms-and-conditions/privacy-policy/

Screenshots

Knowledge Base dashboard for crawling, training, and managing site content.

AI Configuration screen for provider settings and content behavior rules. — Knowledge Base dashboard for crawling, training, and managing site content.

Installation

Upload the apirosite-assistant folder to /wp-content/plugins/.
Activate ApiroSite Assistant from the Plugins screen.
Open AI Chat > AI Configuration to configure provider behavior.
Enable external AI processing only if you accept the listed services and data handling, or leave it disabled for local knowledge-base answers.
Open AI Chat > Knowledge Base and run a crawl.
Adjust widget design and placement as needed.

FAQ

Do I need an API key?: No. The plugin can answer from its local knowledge base without an API key. If you explicitly enable external AI processing, it can use free online fallback providers. For more reliable responses, add an OpenAI API key in AI Chat > AI Configuration.
Is the API key exposed to visitors?: No. API keys are stored server-side, encrypted at rest where OpenSSL is available, and are never sent to frontend JavaScript.
Does it crawl WooCommerce products?: No. Product crawling is intentionally excluded.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“ApiroSite Assistant” is open source software. The following people have contributed to this plugin.

Fakhrul Alam

Translate “ApiroSite Assistant” 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.1

Updated plugin branding images and admin accent colors.

1.0.0

Added explicit opt-in before external AI processing.
Documented external providers, transmitted data, terms, and privacy policies.
Added suggested privacy-policy text and updated WordPress compatibility metadata.

1.0.23

Improved human handoff answers for visitors asking to talk to a real person, admin, owner, or support staff.

1.0.22

Added Train Site workflow for AI-generated site summary.
Added OpenAI embedding generation and semantic search retrieval.
Added embeddings database table and streaming training progress.

1.0.21

Improved fallback answer voice so local fallback speaks as the site instead of saying “Here is what I found.”
Tightened fallback confidence checks and filtered job/salary snippets from pricing answers.

1.0.20

Added explicit AI mode selection.
Shared OpenAI-compatible provider request helper.
Added prompt override knowledge placeholder support.
Added cache normalization and knowledge-version cache invalidation.
Added token-budgeted knowledge injection and prompt-injection notice.
Added optional attribution setting.

1.0.19

Hardened API key handling and admin settings responses.
Added encrypted OpenAI key storage and masked admin display.
Moved deterministic knowledge extractors behind AI provider attempts.
Added provider circuit breaker, reduced HTTP timeouts, fallback testing, and opt-in failure logging.
Added custom knowledge entries, knowledge caching, large table warning, and cache cleanup cron.

1.0.18

Improved chat widget opening animation and mobile placement.

1.0.17

Added optional OpenAI key flow and knowledge text cleanup.