ColorWhistle AI ChatBot

Beschrijving

ColorWhistle AI ChatBot transforms your WordPress site into a knowledgeable AI assistant. Leveraging OpenAI and Pinecone, it provides accurate, context-aware answers to visitors.

Key Features

  • Smart Indexing: Syncs content to Pinecone.
  • Context-Aware AI: RAG architecture retrieval.
  • Customizable Widget: Fully customizable design.
  • Lead Capture Forms: Collect visitor information seamlessly within the chat.
  • Chat History: Track and manage all AI conversations from the admin dashboard.
  • Built-in Protection: Rate limiting and honeypot anti-spam protection.
  • Source Citations: AI links to sources.
  • Secure: Best practices followed.

External Services

This plugin connects to OpenAI API to generate chatbot responses.
Data sent: user input messages.
Purpose: AI-generated responses.

OpenAI Privacy Policy: https://openai.com/privacy
OpenAI Terms of Service: https://openai.com/policies/terms-of-use/

This plugin also connects to Pinecone for vector storage.
Data sent: embeddings or chatbot data.
Purpose: semantic search and retrieval.

Pinecone Privacy Policy: https://www.pinecone.io/privacy/
Pinecone Terms of Service: https://www.pinecone.io/terms-of-service/

Fonts and Assets

  • What it does: Uses the Manrope font and Material Symbols icon set for styling the chat widget and admin panel.
  • Local Loading: All font files (Manrope and Material Symbols) are bundled locally within the plugin package (assets/fonts/). No external HTTP requests are made to third-party font servers like Google Fonts, ensuring compliance with strict privacy regulations.

Schermafbeeldingen

Installatie

  1. Upload colorwhistle-ai-chatbot folder to /wp-content/plugins/.
  2. Activate through ‘Plugins’ menu.
  3. Go to ColorWhistle AI ChatBot settings.
  4. Enter API Keys.
  5. Sync content in Knowledge Base.
  6. Enable widget in General Settings.

FAQ

Do I need an OpenAI account?

Yes, for embeddings and chat.

Do I need a Pinecone account?

Yes, for vector storage.

Does it support CPTs?

Yes, configurable in settings.

How do I fix “Embedding Dimension Mismatch” errors?

If you receive an error like Vector dimension X does not match the dimension of the index Y:
1. Go to ColorWhistle AI ChatBot -> Dashboard & Settings -> API Configuration.
2. Ensure Embedding Dimensions matches the dimension configured in your Pinecone index (e.g., 1536 for text-embedding-3-small, or 512/1024 if customized).
3. If the error mentions Vector dimension 0, ensure Pinecone Vector Type is set to Hybrid Search or Dense Only rather than Sparse Only if your index expects dense vectors.
4. Check that your OpenAI API Key is valid and has active quotas to generate embeddings.

What personal data is collected?

If the Lead Capture form is enabled, any details submitted by the visitor (such as name, email, or phone number) are collected and stored securely in your local WordPress database. Additionally, IP addresses may be temporarily cached for rate-limiting purposes to prevent spam.

What data is sent to external services?

When a visitor sends a chat message, the message text is sent to OpenAI to generate a response. Your site content (post titles and text) is sent to OpenAI (to create embeddings) and stored in Pinecone (as vector data) during the sync process. We do not intentionally send personally identifiable information to external APIs unless the user voluntarily types it into the chat box.

Beoordelingen

Er zijn geen beoordelingen voor deze plugin.

Bijdragers & ontwikkelaars

“ColorWhistle AI ChatBot” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

Vertaal “ColorWhistle AI ChatBot” in je eigen taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

1.2.1

  • Resolved delivery issues with immediate email notifications for captured leads.
  • Replaced static frontend error messages with dynamic API-driven error reporting.
  • Replaced Lead ID with Chat Conversation ID in the Email History logs for clearer tracking.
  • Improved Knowledge Base sync accuracy by extracting content from live-rendered pages (with a local database fallback).
  • Added clickable sub-navigation tabs to quickly filter and manage the Knowledge Base index.

1.2.0

  • Added automatic email notification support for successfully captured leads, sent to the configured email address.
  • Implemented chat session persistence to retain conversation history across page reloads.
  • Added conversation-based trigger conditions for displaying the lead capture form.
  • Enhanced lead capture logic to bypass redundant form triggers once a lead has been submitted.
  • Improved frontend rendering of the “Thank You” screen to respect backend WYSIWYG formatting and alignments.

1.1.1

  • Fixed an issue where the main plugin menu was not displayed after installation.

1.1.0

  • Added Chat History module to store and manage chatbot conversations.
  • Added Chat History administration page with conversation viewing capabilities.
  • Added Lead Management module.
  • Added Lead Capture Form builder with configurable form fields.
  • Added multi-step lead capture flow inside the chatbot widget.
  • Added custom database tables for storing leads and chat history.
  • Added lead submission tracking and management tools.
  • Improved chatbot user experience and conversation workflow.
  • Performance improvements and code optimizations.
  • Fixed minor bugs and UI issues.

1.0.0

  • Initial release.