Beskrivelse
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.
Installation
- Upload
colorwhistle-ai-chatbotfolder to/wp-content/plugins/. - Activate through ‘Plugins’ menu.
- Go to ColorWhistle AI ChatBot settings.
- Enter API Keys.
- Sync content in Knowledge Base.
- 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 fortext-embedding-3-small, or 512/1024 if customized).
3. If the error mentionsVector 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.
Anmeldelser
Der er ingen anmeldelser for denne widget.
Bidragsydere & udviklere
“ColorWhistle AI ChatBot” er open source-software. Følgende personer har bidraget til dette plugin.
BidragsydereOversæt “ColorWhistle AI ChatBot” til dit eget sprog.
Interesseret i udvikling?
Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.
Ændringslog
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.



