Title: ColorWhistle AI ChatBot
Author: ColorWhistle
Published: <strong>24 مارس 2026</strong>
Last modified: 10 آگوست 2026

---

جستجوی افزونه‌ها

![](https://ps.w.org/colorwhistle-ai-chatbot/assets/banner-772x250.png?rev=3489711)

![](https://ps.w.org/colorwhistle-ai-chatbot/assets/icon-256x256.png?rev=3489898)

# ColorWhistle AI ChatBot

 توسط [ColorWhistle](https://profiles.wordpress.org/colorwhistlecw/)

[دانلود](https://downloads.wordpress.org/plugin/colorwhistle-ai-chatbot.1.2.2.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/colorwhistle-ai-chatbot/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/colorwhistle-ai-chatbot/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/colorwhistle-ai-chatbot/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/colorwhistle-ai-chatbot/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/colorwhistle-ai-chatbot/)

## توضیحات

**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.
 * **Response Rules Engine**: Trigger custom automated responses, page redirects,
   or CTA buttons based on visitor keywords.
 * **IP Blocking Security**: Easily block abusive or spam IP addresses manually 
   or automatically to protect your chatbot.
 * **Conversation Limits**: Set maximum message limits per visitor session to control
   OpenAI API costs.
 * **Visitor Page & Location Tracking**: Track the exact page URL, path, and geolocation
   where visitors initiate chat conversations.
 * **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, honeypot anti-spam protection, and IP
   blocking.
 * **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/

This plugin connects to ipapi.co for visitor IP geolocation mapping.
 Data sent:
visitor IP address. Purpose: displaying visitor country location in the admin dashboard
and visitor logs.

ipapi.co Privacy Policy: https://ipapi.co/privacy/

This plugin connects to api64.ipify.org to resolve server public IP address in local
development environments.
 Data sent: HTTP GET request header. Purpose: resolving
server IP for rate limiting and logging on loopback environments.

ipify Privacy Policy: https://www.ipify.org/

#### 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.

## عکس‌های صفحه

[⌊Admin Settings Page⌉⌊Admin Settings Page⌉[

Admin Settings Page

[⌊Knowledge Base Sync⌉⌊Knowledge Base Sync⌉[

Knowledge Base Sync

[⌊Chat Widget Frontend⌉⌊Chat Widget Frontend⌉[

Chat Widget Frontend

## نصب

 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**.

## سوالات متداول

### 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.

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“ColorWhistle AI ChatBot” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت 
کرده‌اند.

مشارکت کنندگان

 *   [ ColorWhistle ](https://profiles.wordpress.org/colorwhistlecw/)

[ترجمه “ColorWhistle AI ChatBot” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/colorwhistle-ai-chatbot)

### علاقه‌ مند به توسعه هستید؟

[کد را مرور کنید](https://plugins.trac.wordpress.org/browser/colorwhistle-ai-chatbot/)،
[مخزن SVN](https://plugins.svn.wordpress.org/colorwhistle-ai-chatbot/) را بررسی 
کنید، یا از طریق [RSS](https://plugins.trac.wordpress.org/log/colorwhistle-ai-chatbot/?limit=100&mode=stop_on_copy&format=rss)
در [گزارش توسعه](https://plugins.trac.wordpress.org/log/colorwhistle-ai-chatbot/)
مشترک شوید.

## گزارش تغییرات

#### 1.2.2

 * Improved CSS Selectors configuration and validation.
 * Improved Knowledge Base sync accuracy and duplicate prevention.
 * Improved settings validation for API credentials.
 * Enhanced security with IP Blocking functionality.
 * Improved spam protection with Conversation Limit functionality.
 * Added Dynamic Response Rules functionality.
 * Added Visitor Page Tracking functionality.

#### 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.

## اطلاعات

 *  نگارش **1.2.2**
 *  آخرین به‌روزرسانی **2 ماه پیش**
 *  نصب‌های فعال **کمتر از 10**
 *  نگارش وردپرس ** 6.2 یا بالاتر **
 *  آزمایش‌شده تا **7.0.7**
 *  نگارش PHP ** 8.0 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/colorwhistle-ai-chatbot/)
 * برچسب
 * [AI](https://fa.wordpress.org/plugins/tags/ai/)[assistant](https://fa.wordpress.org/plugins/tags/assistant/)
   [chatbot](https://fa.wordpress.org/plugins/tags/chatbot/)[knowledge base](https://fa.wordpress.org/plugins/tags/knowledge-base/)
   [openai](https://fa.wordpress.org/plugins/tags/openai/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/colorwhistle-ai-chatbot/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

[بررسی شما](https://wordpress.org/support/plugin/colorwhistle-ai-chatbot/reviews/#new-post)

[مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/colorwhistle-ai-chatbot/reviews/)

## مشارکت کنندگان

 *   [ ColorWhistle ](https://profiles.wordpress.org/colorwhistlecw/)

## پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/colorwhistle-ai-chatbot/)