rapls

<p>Rapls AI Chatbot add an AI chatbot to your site with OpenAI, Claude, Gemini, or OpenRouter. Includes site learning, knowledge base, and web search.</p>
<h4>Key Features</h4>
<ul>
<li><strong>Multiple AI Providers</strong> — OpenAI, Anthropic Claude, Google Gemini, and OpenRouter (100+ models via single API key)</li>
<li><strong>Web Search</strong> — AI automatically searches the web when the knowledge base lacks a sufficient answer, using each provider’s built-in capability (OpenAI web_search_preview, Claude web_search, Gemini google_search)</li>
<li><strong>Site Learning</strong> — Crawl and index your website content (posts, pages, custom post types, WooCommerce products) for context-aware responses</li>
<li><strong>Vector Embedding RAG</strong> — Hybrid search combining keyword matching (40%) and vector similarity (60%) for accurate retrieval</li>
<li><strong>Custom Knowledge Base</strong> — Add Q&A pairs, free-form content, PDF/DOCX uploads with priority levels and draft/published workflow</li>
<li><strong>MCP Server</strong> — 7 built-in tools via JSON-RPC 2.0 for AI agent integration (Claude Desktop, Cursor, VS Code)</li>
<li><strong>WordPress Abilities API</strong> — Auto-register MCP tools as WordPress Abilities for discovery by MCP Adapters</li>
<li><strong>Gutenberg Block</strong> — Insert AI Chatbot block in the block editor with height, theme, and bot-id settings; SSR support</li>
<li><strong>Response Language Auto-detect</strong> — Automatically detect browser language for welcome message and AI responses</li>
<li><strong>Cross-site Embed</strong> — Embed the chatbot on external sites via iframe or script loader</li>
<li><strong>Conversation History</strong> — Save and review all chat conversations with configurable retention</li>
<li><strong>Usage Statistics</strong> — Track token usage and estimated API costs with visual charts and provider breakdown</li>
<li><strong>Feedback & Regeneration</strong> — Users can rate responses (thumbs up/down) and request regeneration</li>
<li><strong>6 Built-in Themes</strong> — Default, Simple, Classic, Light, Minimal, Flat</li>
<li><strong>Security</strong> — reCAPTCHA v3, rate limiting, consent mode, Cloudflare support, security diagnostics</li>
<li><strong>Settings Import/Export</strong> — Backup and restore all settings as JSON</li>
<li><strong>Multilingual</strong> — Japanese translation included; welcome messages configurable in 13 languages</li>
</ul>
<h4>Supported AI Models</h4>
<p><strong>OpenAI:</strong><br />
* GPT-5.2, GPT-5.1, GPT-5 series (Latest generation)<br />
* GPT-4.1 series (Long context, 1M tokens)<br />
* GPT-4o, GPT-4o-mini (Multimodal)<br />
* o1, o3, o4-mini (Reasoning models)</p>
<p><strong>Anthropic Claude:</strong><br />
* Claude Opus 4.6 (Most powerful)<br />
* Claude Sonnet 4.5 (Recommended — fast and powerful)<br />
* Claude Haiku 4.5 (Recommended — fastest)<br />
* Claude Opus 4.5, Opus 4.1, Sonnet 4, 3.7 Sonnet</p>
<p><strong>Google Gemini:</strong><br />
* Gemini 3 Pro/Flash (Preview, latest)<br />
* Gemini 2.5 Pro/Flash (Recommended)<br />
* Gemini 2.0 Flash (Stable)<br />
* Gemini 1.5 Pro/Flash (Legacy)</p>
<p><strong>OpenRouter:</strong><br />
* Access 100+ models from multiple providers through a single API key</p>
<h4>Dashboard</h4>
<p>The dashboard provides an at-a-glance overview of your chatbot’s activity:</p>
<ul>
<li>Statistics cards: total conversations, today’s messages, indexed pages, knowledge entries, monthly AI responses with usage limit</li>
<li>Status indicators: AI provider, site learning, conversation history</li>
<li>API usage statistics (past 30 days): total tokens, input/output tokens, estimated cost, daily usage chart, provider breakdown</li>
</ul>
<h4>Settings (5 Tabs)</h4>
<p><strong>AI Settings</strong> — Configure your AI provider, model, and API key. Enable vector search (RAG) with embedding provider. Set up MCP server with API key generation and Claude Desktop configuration example.</p>
<p><strong>Chat Settings</strong> — Customize bot name, avatar (emoji or image), welcome messages (13 languages: English, Japanese, Chinese, Korean, Spanish, French, German, Portuguese, Italian, Russian, Arabic, Thai, Vietnamese), system prompt, response language, message history count, feedback buttons, and API quota error message. Advanced: context prompts for knowledge matching, Q&A format, and site learning; feature prompts for regeneration instructions, good/bad example learning, and conversation summary.</p>
<p><strong>Display Settings</strong> — Choose from 6 free themes (Default, Simple, Classic, Light, Minimal, Flat). Configure badge position (4-corner grid), margins, primary/secondary colors, mobile display, Markdown rendering, typing indicator, maximum input length, page exclusion, footer text, and cross-site embed options (script or iframe).</p>
<p><strong>Security Settings</strong> — Enable reCAPTCHA v3 with site key, secret key, and score threshold. Configure access control: consent strict mode, rate limiting, Cloudflare integration, reverse proxy trust, reCAPTCHA failure mode. View security diagnostics (read-only): allowed origins, trusted proxies, IP detection, API key status, WP Consent API, rate limiting, reCAPTCHA, SSL/TLS, CSRF.</p>
<p><strong>Data Management</strong> — Enable/disable conversation history with configurable retention period. Import/export settings (optionally including knowledge base). Reset all settings to defaults.</p>
<h4>Knowledge Base</h4>
<ul>
<li>Add entries as text: title, content, category, priority level</li>
<li>File import: .txt, .csv, .md, .pdf, .docx (server-side parsing)</li>
<li>Statistics: total entries, active, inactive, categories</li>
<li>Filter by status: all, published, draft</li>
<li>Sortable table: ID, title, category, type, priority, updated date</li>
<li>Unlimited entries</li>
</ul>
<h4>Site Learning</h4>
<p>The plugin crawls and indexes your published content for context-aware AI responses:</p>
<ul>
<li>Posts and Pages</li>
<li>Custom Post Types</li>
<li>WooCommerce Products</li>
<li>Any public content</li>
</ul>
<p>With vector embedding enabled, hybrid search combines keyword matching (40%) and vector similarity (60%) for better retrieval accuracy.</p>
<h4>Free vs Pro</h4>
<p>The free version is fully functional with no artificial limits — you pay only your own AI API costs. An optional Pro add-on is available for business-oriented features.</p>
<ul>
<li><strong>Free</strong> — Full AI chat, unlimited responses, unlimited knowledge base, 6 themes, MCP server, Gutenberg block</li>
<li><strong>Pro</strong> — Adds analytics, lead capture, scenarios, operator mode, WooCommerce, LINE, and more</li>
</ul>
<p><strong>What Free includes:</strong></p>
<ul>
<li>All 4 AI providers (OpenAI, Claude, Gemini, OpenRouter)</li>
<li>Unlimited AI responses and knowledge base entries</li>
<li>Web search, site learning with vector RAG</li>
<li>MCP server, Gutenberg block, cross-site embed</li>
<li>6 themes, feedback, regeneration, reCAPTCHA, security diagnostics</li>
</ul>
<p><strong>What Pro adds:</strong></p>
<ul>
<li>Analytics dashboard with satisfaction scores, FAQ ranking, and PDF export</li>
<li>Lead capture forms, CSV/JSON export, webhooks, Google Sheets</li>
<li>Conversation scenarios, business hours, human handoff, operator mode</li>
<li>WooCommerce product cards, LINE Messaging API, Slack notifications</li>
<li>10 additional themes, dark mode, voice input/TTS, multimodal</li>
<li>Response caching, encryption, audit logs, and more</li>
</ul>
<p>Learn more at <a href="https://raplsworks.com/rapls-ai-chatbot-pro" rel="nofollow ugc">raplsworks.com</a></p>
<h3>External Services</h3>
<p>This plugin connects to the following external third-party services. <strong>No data is sent to any service until you configure an API key and enable the feature in the plugin settings.</strong> Each service requires the site administrator to create an account and obtain API credentials. By using these services, you agree to their respective terms and privacy policies listed below.</p>
<h4>1. OpenAI (GPT models) — AI Provider</h4>
<p>Used when you select OpenAI as your AI provider. User messages and optionally site content are sent to generate AI responses.</p>
<ul>
<li>Service URL: <a href="https://api.openai.com/" rel="nofollow ugc">https://api.openai.com/</a></li>
<li>Terms of Use: <a href="https://openai.com/terms/" rel="nofollow ugc">https://openai.com/terms/</a></li>
<li>Privacy Policy: <a href="https://openai.com/privacy/" rel="nofollow ugc">https://openai.com/privacy/</a></li>
</ul>
<h4>2. Anthropic (Claude models) — AI Provider</h4>
<p>Used when you select Anthropic Claude as your AI provider. User messages and optionally site content are sent to generate AI responses.</p>
<ul>
<li>Service URL: <a href="https://api.anthropic.com/" rel="nofollow ugc">https://api.anthropic.com/</a></li>
<li>Terms of Use: <a href="https://www.anthropic.com/terms" rel="nofollow ugc">https://www.anthropic.com/terms</a></li>
<li>Privacy Policy: <a href="https://www.anthropic.com/privacy" rel="nofollow ugc">https://www.anthropic.com/privacy</a></li>
</ul>
<h4>3. Google (Gemini models) — AI Provider</h4>
<p>Used when you select Google Gemini as your AI provider. User messages and optionally site content are sent to generate AI responses.</p>
<ul>
<li>Service URL: <a href="https://generativelanguage.googleapis.com/" rel="nofollow ugc">https://generativelanguage.googleapis.com/</a></li>
<li>Terms of Use: <a href="https://policies.google.com/terms" rel="nofollow ugc">https://policies.google.com/terms</a></li>
<li>Privacy Policy: <a href="https://policies.google.com/privacy" rel="nofollow ugc">https://policies.google.com/privacy</a></li>
</ul>
<h4>4. OpenRouter — AI Provider</h4>
<p>Used when you select OpenRouter as your AI provider. OpenRouter is a unified API gateway that routes requests to various AI models.</p>
<ul>
<li>Service URL: <a href="https://openrouter.ai/api/" rel="nofollow ugc">https://openrouter.ai/api/</a></li>
<li>Terms of Use: <a href="https://openrouter.ai/terms" rel="nofollow ugc">https://openrouter.ai/terms</a></li>
<li>Privacy Policy: <a href="https://openrouter.ai/privacy" rel="nofollow ugc">https://openrouter.ai/privacy</a></li>
</ul>
<h4>5. Google reCAPTCHA v3 (Optional)</h4>
<p>Used only if you enable reCAPTCHA in the plugin settings for spam protection. The visitor’s IP address and interaction data are sent to Google for verification.</p>
<ul>
<li>Service URL: <a href="https://www.google.com/recaptcha/" rel="nofollow ugc">https://www.google.com/recaptcha/</a></li>
<li>Terms of Use: <a href="https://policies.google.com/terms" rel="nofollow ugc">https://policies.google.com/terms</a></li>
<li>Privacy Policy: <a href="https://policies.google.com/privacy" rel="nofollow ugc">https://policies.google.com/privacy</a></li>
</ul>
<h4>6. LINE Messaging API (Pro Add-on, Optional)</h4>
<p>Used only if you enable the LINE integration via the Pro add-on. Connects to the LINE Messaging API for chatbot-to-LINE messaging.</p>
<ul>
<li>Service URL: <a href="https://api.line.me/" rel="nofollow ugc">https://api.line.me/</a></li>
<li>Terms of Use: <a href="https://terms.line.me/" rel="nofollow ugc">https://terms.line.me/</a></li>
<li>Privacy Policy: <a href="https://line.me/en/terms/policy/" rel="nofollow ugc">https://line.me/en/terms/policy/</a></li>
</ul>
<h4>Cross-Site Embed</h4>
<p>The plugin includes an optional embed loader script (<code>embed-loader.js</code>) for embedding the chatbot on external websites via an iframe. This script does not load any external CDN resources or third-party scripts — it creates an iframe pointing back to your own WordPress site. All data processing occurs on your server.</p>
<h4>Data Transmitted to External Services</h4>
<ul>
<li><strong>User messages</strong>: Chat messages entered by visitors (sent to the configured AI provider only)</li>
<li><strong>Site content</strong> (if Site Learning is enabled): Excerpts from your published posts/pages (sent to the configured AI provider)</li>
<li><strong>Knowledge base</strong> (if configured): Custom Q&A entries you create (sent to the configured AI provider)</li>
<li><strong>IP address</strong> (reCAPTCHA only): Sent to Google for spam verification</li>
</ul>
<h4>Data Storage</h4>
<ul>
<li><strong>Conversation history</strong>: Stored locally in your WordPress database (can be disabled)</li>
<li><strong>Visitor IP</strong>: Stored as SHA-256 hash (not plain text) for rate limiting</li>
<li><strong>Retention</strong>: Configurable auto-deletion period (default 90 days)</li>
</ul>
<h4>User Controls</h4>
<p>You can disable these features in the plugin settings:<br />
* Conversation history saving<br />
* Site content crawling/learning<br />
* Google reCAPTCHA verification<br />
* Web search</p>
<h3>Privacy</h3>
<h4>Data Collected</h4>
<p>When conversation history is enabled, the plugin stores:<br />
* Chat messages (user and AI responses)<br />
* Session identifiers<br />
* Page URLs where chats occurred<br />
* Hashed IP addresses (SHA-256, not reversible)<br />
* Timestamps</p>
<h4>Data Retention</h4>
<p>Conversation data is automatically deleted after the configured retention period (default: 90 days). Administrators can manually delete conversations at any time.</p>
<h4>User Rights</h4>
<p>Site administrators can:<br />
* View all conversation history<br />
* Delete individual or all conversations<br />
* Export settings (does not include conversation data)<br />
* Disable history saving entirely= Developer Information =</p>
<p>The plugin provides hooks and filters for customization:</p>
<h4>Available Filters</h4>
<ul>
<li><code>raplsaich_system_prompt</code> — Modify the system prompt sent to AI</li>
<li><code>raplsaich_context</code> — Modify the context from site learning</li>
<li><code>raplsaich_ai_response</code> — Filter the AI response before display</li>
<li><code>raplsaich_chatbot_enabled</code> — Control chatbot visibility programmatically</li>
<li><code>raplsaich_allowed_origins</code> — Add allowed origin hosts for same-origin check</li>
<li><code>raplsaich_chat_response_data</code> — Filter chat response data before returning to client</li>
<li><code>raplsaich_gpt5_token_multiplier</code> — GPT-5 reasoning token multiplier (default: 4, range: 1-8)</li>
</ul>
<h4>Example: Custom System Prompt</h4>
<pre><code>add_filter( 'raplsaich_system_prompt', function( $prompt, $settings ) {
    return $prompt . "\n\nAlways end responses with a friendly emoji.";
}, 10, 2 );
</code></pre>
<h4>Example: Conditionally Hide Chatbot</h4>
<pre><code>add_filter( 'raplsaich_chatbot_enabled', function( $enabled ) {
    // Hide on checkout page
    if ( is_page( 'checkout' ) ) {
        return false;
    }
    return $enabled;
} );
</code></pre>
<h4>REST API Endpoints</h4>
<p>The plugin registers REST API endpoints under the <code>rapls-ai-chatbot/v1</code> namespace:</p>
<p><strong>Session authentication:</strong> Pass the session ID via the <code>X-RAPLSAICH-Session</code> HTTP header (recommended). When the header is present, any session_id in the request body is ignored (prevents APM/WAF body-logging leakage). Query string parameters (<code>?session_id=...</code>) are <strong>not</strong> accepted for GET requests to prevent session leakage in server access logs.</p>
<p><strong>Free:</strong></p>
<ul>
<li><code>GET /rapls-ai-chatbot/v1/session</code> — Get or create a chat session</li>
<li><code>POST /rapls-ai-chatbot/v1/chat</code> — Send a message and receive AI response</li>
<li><code>GET /rapls-ai-chatbot/v1/history/{session_id}</code> — Get conversation history</li>
<li><code>POST /rapls-ai-chatbot/v1/feedback</code> — Rate a response (thumbs up/down)</li>
<li><code>POST /rapls-ai-chatbot/v1/regenerate</code> — Regenerate AI response</li>
<li><code>GET /rapls-ai-chatbot/v1/message-limit</code> — Check message limits</li>
<li><code>POST /rapls-ai-chatbot/v1/lead</code> — Submit lead form</li>
<li><code>GET /rapls-ai-chatbot/v1/lead-config</code> — Lead form configuration</li>
</ul>
<p>The Pro add-on registers additional endpoints for analytics, scenarios, LINE, and more. See the Pro documentation for details.</p>
<h4>Settings Architecture</h4>
<p>Extension settings are stored under the <code>extensions</code> key in <code>raplsaich_settings</code>. For backward compatibility, the legacy <code>pro_features</code> key is read as a fallback but all new settings are written to <code>extensions</code>.</p>
<h4>Database Tables</h4>
<p>The plugin creates the following database tables:</p>
<ul>
<li><code>{prefix}_aichat_conversations</code> — Chat sessions</li>
<li><code>{prefix}_aichat_messages</code> — Individual messages with token tracking</li>
<li><code>{prefix}_aichat_index</code> — Site learning content index</li>
<li><code>{prefix}_aichat_knowledge</code> — Custom knowledge base entries</li>
<li><code>{prefix}_aichat_leads</code> — Lead capture data</li>
</ul>
<h4>Uninstallation</h4>
<p>When uninstalled with “Delete data on uninstall” enabled, the plugin removes all database tables, options, and transients. Without this setting, data is preserved for re-installation.</p>
<h3>Development</h3>
<p>Release ZIPs are CI-verified for packaging correctness. Report any issues via the support forum.</p>
<h4>Credits</h4>
<ul>
<li><a href="https://www.chartjs.org/" rel="nofollow ugc">Chart.js</a> (MIT License) — Usage statistics charts</li>
</ul>


Rapls AI Chatbot

AI chatbot for WordPress with OpenAI, Claude, Gemini, and OpenRouter. Site learning, knowledge base, web search, and MCP server.

Rapls AI Chatbot vs BotWriter – AI Writer & Content Generator