mindwebconcierge

<p>Mind Web Concierge brings intelligent AI assistance directly to your WordPress website. Powered by RAG (Retrieval-Augmented Generation) technology, it understands your content and delivers accurate, context-aware responses to your visitors in real time.</p>
<p>It allows you to:</p>
<ul>
<li>Provide instant automated responses to visitors</li>
<li>Improve customer engagement and retention</li>
<li>Reduce support workload</li>
<li>Deliver 24/7 AI-powered assistance</li>
<li>Index WordPress posts, pages, and WooCommerce products automatically</li>
<li>Connect any OpenAI-compatible language model via the LLM settings panel</li>
<li>Link a Mind Spaces workspace where you can upload documents and ask questions about them directly</li>
<li>Use Local Thinking mode to let visitors ask questions focused on the current page content and any linked Mind Spaces notebooks assigned to that page</li>
</ul>
<p>Perfect for:</p>
<ul>
<li>Business websites</li>
<li>E-commerce stores</li>
<li>Service providers</li>
<li>Corporate portals</li>
</ul>
<p>Easy to install, configure, and scale.</p>
<h3>Data Handling</h3>
<p>This plugin stores chatbot conversation logs and metadata in the WordPress database. The following visitor data is collected per conversation: session ID, IP address, screen resolution, user agent (browser info), accepted language, referrer URL, timezone, and platform. Data is accessible only to authorized administrators. Depending on configuration, conversation content may be sent to external services for AI processing.</p>
<h3>External Services</h3>
<p>This plugin connects to the following external services operated by Smart Processes. Data is transmitted to these services during normal plugin operation.</p>
<h4>RAG API</h4>
<ul>
<li>URL: https://rag.smartprocesses.cloud</li>
<li>Purpose: Content indexing, category management, and AI-generated streaming responses.</li>
<li>Data sent: WordPress post content, WooCommerce product data, visitor questions.</li>
</ul>
<h4>Mind Spaces API</h4>
<ul>
<li>URL: https://spaces.smartmind.services</li>
<li>Purpose: Authentication, space retrieval, document-based knowledge access, and knowledge base management.</li>
<li>Data sent: Authentication tokens derived from administrator login, space queries, and related knowledge base requests.</li>
</ul>
<p>Mind Spaces is the knowledge management platform behind Mind Web Concierge. It lets you manage spaces (knowledge bases), upload documents, and ask questions directly to test AI responses. For more information visit: https://spaces.smartmind.services</p>
<h4>Subscription API</h4>
<ul>
<li>URL: https://subscriptions.smartprocesses.cloud</li>
<li>Purpose: Retrieves pricing information and handles subscription billing and management via Stripe, including trial creation, subscription retrieval, cancellations, reactivations, and invoice downloads.</li>
<li>Data sent: App GUID, customer email, Stripe product ID.</li>
</ul>
<h4>Smart Mind Website</h4>
<ul>
<li>URL: https://smartmind.it</li>
<li>Purpose: Provides product information, legal pages, optional pricing display, and the optional “Powered by” link shown in the chatbot widget.</li>
<li>Data sent: No personal visitor data is intentionally transmitted by the plugin to this website during normal operation.</li>
</ul>
<p>The plugin may display links to Smart Mind legal or product pages for administrator reference and optional front-end branding. These links do not process visitor chat content.</p>
<p>The plugin communicates with Smart Processes services only for features explicitly enabled and used by the site administrator, such as AI responses, content indexing, notebook access, pricing retrieval, and subscription management. No personal user data is transmitted without the administrator’s configuration and the visitor’s direct interaction with the chatbot.</p>
<ul>
<li>Privacy Policy: https://smartmind.it/mind-web-privacy-policy/</li>
<li>Terms of Service: https://smartmind.it/mind-web-terms-of-service/</li>
</ul>
<h3>Plugin Constants</h3>
<p>The plugin defines the following internal constants. These are set automatically and do not require manual configuration.</p>
<h4>MINDWECO_RAG_URL</h4>
<p>The base URL for the RAG API service. Used for all indexing, category management, and streaming ask requests.<br />
Value: <code>https://rag.smartprocesses.cloud</code></p>
<h4>MINDWECO_NOTEBOOKS_URL</h4>
<p>The base URL for the Mind Spaces (Notebooks) service. Used for authentication, notebook retrieval, and knowledge base management.<br />
Value: <code>https://spaces.smartmind.services</code></p>
<h4>MINDWECO_STRIPE_URL</h4>
<p>The base URL for the Stripe subscription management API. Used for trial creation, subscription status, cancellation, reactivation, and invoice downloads.<br />
Value: <code>https://subscriptions.smartprocesses.cloud/api</code></p>
<h4>MINDWECO_PROD_ID</h4>
<p>The Stripe Product ID associated with this plugin’s subscription plan. Passed automatically when creating trial subscriptions.<br />
Value: <code>prod_U3VYkOBf6Ngqi3</code></p>
<h4>MINDWECO_POWER_BY</h4>
<p>The URL of the service provider’s product page. Used to display an optional “Powered by” link in the chatbot widget when enabled by the administrator.<br />
Value: <code>https://smartmind.it/</code></p>
<h3>API Reference</h3>
<p>The plugin communicates with external services through the following internal functions.</p>
<h4>Authentication & Token Management</h4>
<p><strong>mindweco_plugin_api_login( $base_url, $username, $password )</strong><br />
Authenticates with the RAG API and retrieves an access token.</p>
<p><strong>mindweco_plugin_refresh_token()</strong><br />
Refreshes the main RAG API access token using stored credentials.</p>
<p><strong>mindweco_plugin_knowledge_repository_get_token()</strong><br />
Returns a valid knowledge repository token, refreshing automatically if expired.</p>
<p><strong>mindweco_plugin_knowledge_repository_refresh_token()</strong><br />
Refreshes the knowledge repository token using stored credentials.</p>
<p><strong>mindweco_plugin_knowledge_repository_login_with_cookie( $base_url, $username, $password, $external_id, $external_name, $type )</strong><br />
Authenticates with the knowledge repository (Mind Spaces) and retrieves an auth token. Also registers the current indexing configuration as an external app connection.</p>
<p><strong>mindweco_plugin_knowledge_repository_logout( $base_url, $external_app_id, $user_id )</strong><br />
Removes the external app connection from the knowledge repository and clears stored credentials.</p>
<h4>Categories</h4>
<p><strong>mindweco_plugin_api_create_category( $base_url, $token, $name, $indexing_id, $sitemap_xml, $language, $parent_id )</strong><br />
Creates a new content category in the RAG service. Called automatically on plugin activation using the site’s nav menu sitemap.</p>
<p><strong>mindweco_plugin_api_get_categories( $base_url, $token )</strong><br />
Retrieves all categories for the authenticated account.</p>
<h4>Indexing</h4>
<p><strong>mindweco_plugin_api_index_items( $base_url, $token, $category_id, $chunk_size, $chunk_overlap, $url, $wp_json, $header_levels, $meta, $local_item_id )</strong><br />
Indexes a WordPress post or page into the knowledge base. Also called automatically when a post is published or updated via the <code>transition_post_status</code> hook.</p>
<p><strong>mindweco_plugin_api_index_products( $base_url, $token, $category_id, $chunk_size, $chunk_overlap, $product_json, $meta, $local_item_id )</strong><br />
Indexes a WooCommerce product into the knowledge base.</p>
<p><strong>mindweco_plugin_api_delete_indexed_items( $base_url, $token, $category_id, $item_id )</strong><br />
Deletes a previously indexed item. Also called automatically when a post is trashed or permanently deleted via the <code>before_delete_post</code> and <code>wp_trash_post</code> hooks.</p>
<h4>Streaming / Ask</h4>
<p><strong>mindweco_ask_page_based_ref( $base_url, $token, $question, $category_id, $category_ids, $top_k, $app_guid, $callback, $items_ids, $conversation_id )</strong><br />
Sends a question to the streaming endpoint and delivers the response via Server-Sent Events (SSE). Uses cURL exclusively because the WordPress HTTP API does not support streaming callbacks. Supports multi-category queries and item-level filtering for Local Thinking mode.</p>
<h4>Stripe / Subscriptions</h4>
<p><strong>mindweco_stripe_add_trial( $stripe_base_url, $app_guid, $product_id, $customer_email, $title, $site_base_url )</strong><br />
Creates a Stripe trial subscription and a new RAG user account simultaneously. Called on plugin activation.</p>
<p><strong>mindweco_stripe_add_trial_without_user( $stripe_base_url, $app_guid, $product_id, $customer_email )</strong><br />
Creates a Stripe trial subscription without creating a user account.</p>
<p><strong>mindweco_stripe_active_subscription( $stripe_base_url, $app_guid )</strong><br />
Retrieves the currently active Stripe subscription for a given app GUID. Called periodically via <code>mindweco_periodic_subscription_check</code> (every 30 minutes) to keep subscription status in sync.</p>
<p><strong>mindweco_get_all_subscriptions( $stripe_base_url, $app_guid )</strong><br />
Retrieves all Stripe subscriptions for a given app GUID.</p>
<p><strong>mindweco_get_history_subscription( $stripe_base_url, $app_guid )</strong><br />
Retrieves the full subscription history for a given app GUID.</p>
<p><strong>mindweco_plugin_cancel_subscription( $stripe_base_url, $app_guid, $subscription_id, $cancel )</strong><br />
Cancels an active Stripe subscription. Also called automatically on plugin deactivation.</p>
<p><strong>mindweco_plugin_reactivate_subscription( $stripe_base_url, $app_guid, $subscription_id, $cancel )</strong><br />
Reactivates a previously cancelled Stripe subscription.</p>
<p><strong>mindweco_download_subscription_invoice( $stripe_base_url, $invoice_number )</strong><br />
Retrieves the PDF download URL for a given invoice number.</p>
<h4>LLM Configuration</h4>
<p><strong>mindweco_plugin_create_attach_llm_to_config( $base_url, $token, $name, $llm_base_url, $model_name, $provider, $api_key, $indexing_id )</strong><br />
Creates a new LLM configuration and attaches it to an existing indexing configuration. The API key is encrypted before being stored using AES-256-CBC via <code>mindweco_encrypt_api_key()</code>.</p>
<p><strong>mindweco_plugin_update_llm_config( $base_url, $token, $llm_id, $name, $api_key, $llm_base_url, $model_name, $user_id )</strong><br />
Updates an existing LLM configuration.</p>
<p><strong>mindweco_plugin_delete_llm_config( $base_url, $token, $llm_id )</strong><br />
Deletes an LLM configuration by ID and clears all related options from the WordPress database.</p>
<h4>Mind Spaces / Notebooks</h4>
<p><strong>mindweco_plugin_get_notebooks( $base_url, $token )</strong><br />
Retrieves all notebooks (spaces) from the Mind Spaces knowledge repository.</p>
<h4>Page-Based Notebooks</h4>
<p>Notebooks can be assigned to specific WordPress pages via the admin UI. These mappings are stored in the <code>mindweco_page_based_notebooks</code> option as an array keyed by page ID, each containing a <code>title</code> and a <code>notebooks</code> array of notebook IDs.</p>
<p>At runtime, <code>mindweco_get_notebooks_for_page( $post_id )</code> looks up the current page’s title and returns its assigned notebook IDs. These are merged into the category_ids sent to the streaming endpoint.</p>
<h3>Videos</h3>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/Y8d5Sn0xg2I?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<h3>Privacy Policy</h3>
<p>This plugin transmits the following data to external services operated by Smart Processes:</p>
<ul>
<li>WordPress post and page content (for indexing)</li>
<li>WooCommerce product data (for indexing, if WooCommerce is active)</li>
<li>Visitor questions typed into the chat widget</li>
<li>Authentication tokens derived from administrator login (for API authentication)</li>
<li>Customer email and subscription data (for Stripe billing)</li>
</ul>
<p>The following visitor metadata is stored in the WordPress database per conversation session:</p>
<ul>
<li>IP address</li>
<li>User agent (browser and OS information)</li>
<li>Screen resolution</li>
<li>Accepted language</li>
<li>Referrer URL</li>
<li>Timezone</li>
<li>Platform</li>
</ul>
<p>Data is transmitted to the following services:</p>
<ul>
<li>RAG API: https://rag.smartprocesses.cloud</li>
<li>Mind Spaces: https://spaces.smartmind.services</li>
<li>Subscription API: https://subscriptions.smartprocesses.cloud/api</li>
<li>Smart Mind Website: https://smartmind.it</li>
</ul>
<p>A session cookie named <code>mindweco_sid</code> is set in the visitor’s browser containing only a randomly generated session ID (UUID v4). It is automatically deleted when the browser tab or window is closed.</p>
<p>Access tokens and passwords are encrypted at rest in the WordPress database<br />
using AES-256-CBC encryption tied to the site’s unique AUTH_KEY.</p>
<h4>Browser Local Storage</h4>
<p>This plugin stores the following data in the visitor’s browser localStorage to preserve UI preferences across page loads:</p>
<ul>
<li>mindweco-theme-mode – stores the visitor’s preferred color theme (light or dark).</li>
<li>mindweco_ask_only_current_page_{post_id} – stores the state of the Local Thinking toggle per page.</li>
<li>pinned_{message_id} – stores which chat messages the visitor has pinned.</li>
<li>cit_{message_id} – stores citation/source references for bot responses.</li>
</ul>
<p>All data is stored locally in the visitor’s browser only. None of this data is transmitted to external servers. It is automatically cleared when the visitor starts a new chat session.</p>
<p>The subscription service may also be contacted server-side to retrieve pricing and billing-related information for the plugin’s subscription features.</p>
<p>The Smart Mind website may be referenced for legal pages, product information, optional pricing display, and optional front-end branding links.</p>
<p>For full details on how data is collected, processed, and protected, please refer to our Privacy Policy:<br />
https://smartmind.it/mind-web-privacy-policy/</p>


Mind Web Concierge

Mind Web Concierge is an intelligent WordPress assistant powered by RAG technology. It acts as a digital concierge for your website - guiding users th …

Mind Web Concierge vs MxChat – AI Chatbot & Content Generation for WordPress