WP Manifestindependent plugin directory
manifest / ecommerce / chatbliss

ChatBliss

chatbliss de ia para proyectos wordpress

by BLISS Systems LLC · github.com/yarodmo/chatbliss · website

0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/yarodmo/chatbliss/archive/refs/heads/main.zip

ChatBliss - AI Chatbot & Content Generation for WordPress

ChatBliss is the best free AI chatbot and content generation plugin for WordPress in 2026. Train ChatGPT, Claude, Gemini, or Grok on your website content. Generate full blog posts and landing pages with AI. WooCommerce ready with RAG knowledge base, live chat handoff, and 100+ AI models.

Description

ChatBliss is the most powerful free AI chatbot and content generation plugin for WordPress — connecting your website to ChatGPT, Claude, Gemini, Grok, DeepSeek, and 100+ AI models through a single, easy-to-use interface. Train your AI chatbot on your website content, WooCommerce products, PDFs, and more using advanced RAG (Retrieval-Augmented Generation) technology. Now with a built-in AI Content Generator to create full blog posts and landing pages complete with images, SEO metadata, and inline AI editing.

Documentation | Demo Videos

Why Choose ChatBliss as Your WordPress AI Chatbot?

6 Major AI Providers in One Plugin: OpenRouter, OpenAI GPT, Claude, Gemini, xAI Grok, and DeepSeek - switch between 100+ models instantly ✅ Train on Your Website Data: Advanced RAG technology learns from sitemaps, PDFs, URLs, or manual input for ultra-relevant responses ✅ Live Agent Handoff via Slack: Seamlessly escalate from AI to human support when customers need personal assistance ✅ Real-Time Debug Panel: See exactly what your chatbot retrieves and triggers with our admin testing interface ✅ Boost Sales with WooCommerce: Product cards, cart management, and AI-powered shopping assistance ✅ AI Content Generator: Create full blog posts and landing pages with AI-generated images, SEO metadata, and real-time preview editing ✅ Extensive Add-On Ecosystem: Forms, moderation, recommendations, theme customization, and more

🎬 Quick Setup with ChatBliss – Learn how to quickly setup and understand how your chatbot works

📦 Optional Premium Add-Ons

Extend the free plugin with these optional premium features:

  • Advanced Content Editor Add-On – Smart internal linking, AI image management, readability analysis, Google Search Console integration, advanced SEO optimization, and 30-day AI Content Calendar for automated blog scheduling
  • WooCommerce Add-On – AI-powered shopping assistance with product-aware conversations, native product cards with images and pricing, upselling and recommendations, order inquiry handling, cart management, and real-time inventory awareness
  • Forms Action Add-On – Capture leads and data with custom in-chat forms
  • ChatBliss Anywhere Add-On – Deploy your chatbot on any website with one script tag — Shopify, Squarespace, Wix, static HTML, and more
  • AI Chatbot Theme Customizer Add-On – Instantly design chatbot themes with natural language using AI
  • Multi-Bot Add-On – Run unlimited AI chatbots with custom knowledge and personalities
  • Image Analysis Add-On – Enable AI-powered image analysis and OCR inside chats

👉 Visit our website to view all add-ons

🔥 What's New in Version 3.2.3

  • NEW: Embedding Model Switch Protection — Changing your embedding model when content is already embedded silently breaks similarity matching. ChatBliss now warns you with a confirmation dialog before the switch and surfaces a persistent admin notice until the mismatch is resolved, so you never accidentally corrupt your knowledge base.
  • Richer Landing Pages — The Landing Page Generator now plans more sections and writes substantially more copy per section by default, producing fuller, more conversion-ready pages out of the box.
  • Full Width Fix for Block Themes — "Full Width" landing pages now render edge-to-edge on Twenty Twenty-Two through Twenty Twenty-Five and other block themes that previously constrained content via theme.json.
  • Cleaner Manual-Entry Citations — Chat responses no longer leak internal chatbliss:// placeholder URLs when citing manually submitted knowledge entries.

Core Features That Set ChatBliss Apart

🟢 100+ AI Models – Access ChatGPT, Claude, Gemini, Grok, DeepSeek, and 100+ models from OpenRouter with a single plugin 🟢 Lead Management Dashboard – Dedicated Leads tab inside Transcripts shows every captured email and name deduplicated by lead, with filters, bulk delete, CSV export, and one-click jump to each lead's latest conversation 🟢 Chat Transcripts Dashboard – Review all conversations, analyze chat history, track user engagement, and see exactly which knowledge sources the AI used for each response 🟢 WooCommerce Product Training – Train your AI chatbot on your entire product catalog including descriptions, pricing, SKUs, and categories for intelligent shopping assistance 🟢 Live Agent Handoff – Seamlessly escalate conversations from AI to human support via Slack when customers need personal assistance 🟢 ACF Field Control – Choose exactly which Advanced Custom Fields are included in your knowledge base—perfect for excluding private notes or internal data 🟢 Advanced Action Recognition – Smart vector embedding system understands user intent and triggers lead capture, appointments, redirects, and custom actions automatically 🟢 Document Processing – Let visitors upload and chat with PDFs and Word documents directly on your frontend 🟢 Pinecone Vector Storage – Optional lightning-fast knowledge retrieval for large datasets and enterprise-scale deployments 🟢 Web Search Integration – Brave search provides real-time information beyond your knowledge base 🟢 AI Content Generator – Create full blog posts and landing pages from a prompt with AI images, SEO metadata, real-time preview, and inline AI editing via chat 🟢 Image Generation – OpenAI GPT Image and Google Imagen for visual content creation within chat conversations 🟢 Streaming Responses – Real-time response streaming for OpenAI, Claude, and Grok models for the fastest possible chat experience

Choose from 100+ Premium AI Models

Access the world's most advanced AI models based on your specific needs:

OpenRouter: 100+ models from multiple providers with a single API key – including OpenAI, Anthropic, Google, Meta, Mistral, and more! OpenAI: GPT-5.2, GPT-5.1 Chat Latest, GPT-5.1, GPT-5, GPT-5-mini, GPT-5-nano Anthropic Claude: Claude Opus 4.6, Claude Sonnet 4.6, Claude Opus 4.5, Claude Sonnet 4.5, Claude Opus 4.1, Claude Haiku 4.5, Claude 4 Sonnet, Claude 4 Opus X.AI:
Grok-4, Grok-3, Grok-3 Fast, Grok-3 Mini, Grok-3 Mini Fast, Grok-2, Grok 4.1 Fast (Reasoning), Grok 4.1 Fast (Non-Reasoning) Google Gemini: Gemini 3 Pro Preview, Gemini 3 Flash Preview, Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash-Lite, Gemini 2.0 Flash, Gemini 2.0 Flash-Lite, Gemini 1.5 Pro, Gemini 1.5 Flash DeepSeek:
DeepSeek V3

Lead Management Dashboard — Turn Chat Traffic Into a Real Lead List

Every email and name your chatbot captures now lands in one clean, sortable dashboard — so you can finally see your leads as a list instead of hunting through individual transcripts.

What You Get:

  • One Row Per Lead — emails captured across multiple sessions are automatically deduplicated, so each lead appears once with a conversation count and a "last seen" timestamp
  • Top Pages Capturing Leads — instantly see which pages on your site are driving the most lead captures; click any page to filter the list to leads from that page only
  • Powerful Filtering — search by email or name, filter by date range (24h / 7d / 30d / 90d / all-time), or filter by status (leads with a conversation vs. orphan leads who submitted the form but never chatted)
  • Orphan Lead Tracking — visitors who drop their email in the pre-chat form but never send a message are surfaced separately so you never lose a captured contact
  • One-Click View Conversation — jump from any lead straight into their latest full conversation in the transcripts viewer
  • Bulk Delete + CSV Export — select multiple leads to delete or export in one action; CSV export supports email-only or email + name + conversation count + last-seen + top page
  • Clean, Responsive, Native — works beautifully on desktop, tablet, and phone with the same polished dashboard feel as the rest of ChatBliss
  • Zero Setup, Zero Migration — uses your existing chat data, no new database tables, no configuration — turn on lead capture and the dashboard just works

Perfect for sales teams managing inbound leads, agencies reporting to clients, and anyone who wants to see the actual ROI of their chatbot at a glance without digging through individual conversations.

AI Content Generator — Create Blog Posts & Landing Pages with AI

ChatBliss includes a built-in AI Content Generator that lets you create full blog posts and landing pages directly from your WordPress dashboard — no external tools or copy-pasting required.

How It Works:

  1. Describe Your Content — Enter a topic, title, or detailed prompt and choose between a blog post or landing page layout
  2. AI Generates Everything — The AI produces fully styled HTML with responsive CSS, ready-to-publish content, and optional AI-generated images using DALL-E, Gemini, or Grok
  3. Real-Time Preview — See your content exactly as it will appear on your site with a live scaled preview, including desktop and mobile viewport switching
  4. Edit with AI Chat — Use the built-in AI chat panel to request changes like "make the heading bigger" or "change the background to blue" — the AI updates your content in real time
  5. Publish Instantly — Content is saved as a native WordPress post or page with clean HTML, SEO metadata, and responsive design that works with any theme

Key Content Generator Features:

  • Choose from multiple AI models for content generation (GPT-5, Claude, Gemini, Grok, and more)
  • AI-generated images placed directly into your content with automatic media library uploads
  • SEO title and meta description generation for search engine optimization
  • Built-in SEO analysis with real-time scoring and one-click AI auto-optimization
  • Fullwidth and standard layout options with automatic theme compatibility
  • Content history to revisit and manage previously generated posts
  • Works with popular page builders and themes including Elementor, Bricks, Divi, Astra, Kadence, and more
  • Optional Advanced Content Editor Add-On for Google Search Console analytics, smart internal linking, readability analysis, and advanced SEO optimization

ChatBliss Anywhere — Deploy Your Chatbot on Any Website

Your WordPress site powers the AI, but your chatbot doesn't have to live there. The ChatBliss Anywhere Add-On lets you deploy your fully configured chatbot on any website with a single script tag — Shopify, Squarespace, Wix, static HTML, SaaS apps, documentation sites, or anything with an HTML page.

Key Features:

  • One script tag to add your chatbot to any site — no coding or framework required
  • Full style isolation via Shadow DOM so host page CSS never breaks your chatbot
  • All your ChatBliss settings carry over automatically — colors, themes, quick questions, email collection, streaming, and more
  • Multi-bot support lets you deploy different chatbot configurations on different sites
  • Secure domain whitelisting and API key authentication prevent unauthorized usage
  • Lightweight vanilla JS widget with zero dependencies — no jQuery needed on the target site

Ideal for SaaS products with a WordPress blog but a separate web app, e-commerce brands on Shopify, documentation sites, or any business that needs their chatbot beyond WordPress.

Powerful Add-On Ecosystem

Pro Add-Ons: 🟢 Advanced Content Editor – Google Search Console integration with per-page impressions, clicks, and search queries. Smart internal linking, AI readability optimization, image ALT text generation, and advanced SEO checks 🟢 Multi-Bot Manager – Create and manage multiple specialized chatbots with dedicated knowledge databases for different purposes (support, sales, technical, etc.) 🟢 Video Generation – Generate stunning AI videos using Google's Veo 2 and Veo 3 models with audio support and multiple aspect ratios 🟢 Admin Assistant – ChatGPT-like interface in WordPress admin with thread management and image generation 🟢 Chat Themes – Visual design editor with AI-powered chatbot theme generation from natural language 🟢 ChatBliss Forms – Create chatbot-triggered forms for lead capture and support tickets 🟢 Chat Moderation – Advanced security with email/IP banning and content filtering 🟢 ChatBliss Anywhere – Deploy your chatbot on any website with one script tag — Shopify, Squarespace, Wix, static HTML, and custom web apps with Shadow DOM style isolation 🟢 Perplexity Integration – Real-time web search with authoritative, well-sourced responses 🟢 Migration Tool – Seamlessly switch embedding models and vector databases without losing data, with batch processing and real-time progress tracking

📱 Mobile-Friendly & Fully Customizable

ChatBliss’s chatbot widget adapts seamlessly to all devices — desktop, tablet, or mobile. Customize colors, greetings, and placement to match your brand and provide a smooth experience across your entire website.

🔐 Reliable, Fast, Secure

ChatBliss is optimized for performance and security. Your AI chatbot runs smoothly, loads fast, and protects your customer data with enterprise-grade security measures.

🌟 What Makes ChatBliss the Best AI Chatbot for WordPress?

  • Used by hundreds of WordPress websites worldwide
  • 5-star average rating from satisfied customers
  • Native WordPress integration - no external dependencies
  • Setup in under 2 minutes with simple API key configuration

🆓 Start with ChatBliss’s Powerful Free Plan

ChatBliss offers a fully functional free plan that includes everything you need to get started with AI chatbot and customer support. With no credit card required, you can:

  • Access all AI models from 5 major providers
  • AI Content Generator for blog posts and landing pages with SEO scoring and AI auto-optimization
  • Train chatbot on unlimited website content
  • Loops email capture for lead generation
  • Web search and image generation capabilities
  • Real-time admin debug panel
  • Chat transcript review and export
  • RAG support & contextual awareness

Whether you're running a small business or launching a new online store, ChatBliss’s free plan gives you the tools to offer intelligent customer support and grow your business — without paying a cent.

Developer Hooks & Filters

ChatBliss provides WordPress filter hooks so developers can extend and customize chatbot behavior without modifying core plugin files. View full documentation with code examples.

chatbliss_before_process_post

Runs during knowledge base indexing and lets you modify a post's data before ChatBliss processes it. Use this to include custom field data (e.g. product specifications or ACF fields), strip internal content you don't want the chatbot to learn, or transform posts based on bot ID. Receives the WP_Post object and the bot ID.

chatbliss_system_instructions

Dynamically modify the system prompt before every AI response. Use this to inject live data such as business hours, inventory status, or user-specific context into the prompt at runtime. Receives the instructions text, bot ID, and session ID. ChatBliss also supports WordPress shortcodes directly in the system prompt field — any registered shortcodes are automatically expanded before being sent to the AI.

✅ Get Started with ChatBliss AI Chatbot Today

Installing ChatBliss for WordPress takes just a few clicks. Get started with our free plan and upgrade anytime to access our complete add-on ecosystem and premium features.

💰 Pricing

Most powerful features are included in the free plan. Upgrade to Pro for the complete add-on ecosystem and advanced capabilities.
View all pricing options

Use of Third-Party Services

This plugin connects to AI service providers to generate responses:

Service Providers:

Please ensure compliance with applicable terms and data privacy laws.

Installation

  1. Upload the chatbliss folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the 'Plugins' menu in WordPress.
  3. Navigate to the 'ChatBliss' settings page to configure your OpenAI API key and other settings.

Frequently Asked Questions

What AI models does ChatBliss support?

ChatBliss supports 100+ AI models including OpenAI GPT-5.2, GPT-5.1, GPT-5, GPT-5 Mini, Anthropic Claude Opus 4.6, Claude Sonnet 4.6, Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5, Google Gemini 2.0 Flash, Gemini 1.5 Pro, xAI Grok 4, Grok 3, DeepSeek Chat, and many more. With OpenRouter integration, you get access to models from OpenAI, Anthropic, Google, Meta, Mistral, and other providers with a single API key.

How do I get API keys for the AI chatbot?

For OpenAI, visit platform.openai.com and create an account. For Anthropic Claude, visit console.anthropic.com. For Google Gemini, visit ai.google.dev. For xAI Grok, visit x.ai. For DeepSeek, visit platform.deepseek.com. For OpenRouter (100+ models), visit openrouter.ai. Each provider offers different pricing tiers and free credits for new users.

Can I train the AI chatbot on my website content?

Yes. ChatBliss supports unlimited knowledge base training using RAG (Retrieval-Augmented Generation) technology. Import content from WordPress pages, posts, WooCommerce products, custom post types, PDFs, Word documents, text files, sitemaps, and manual Q&A entries. The AI chatbot will use your content to provide accurate, contextually relevant responses.

What is RAG technology and how does it work?

RAG (Retrieval-Augmented Generation) is an AI technique that retrieves relevant information from your knowledge base before generating responses. When a visitor asks a question, ChatBliss searches your trained content using vector embeddings, finds the most relevant matches, and provides that context to the AI model. This ensures accurate, factual answers based on your actual website content rather than generic AI responses.

Does ChatBliss work with WooCommerce?

Yes. ChatBliss includes full WooCommerce integration. The AI chatbot can be trained on your product catalog including titles, descriptions, pricing, SKUs, categories, and custom fields. Enable auto-sync to automatically update the knowledge base when products change. Your chatbot can answer questions about products, pricing, availability, and help customers find what they need.

Can I customize the AI chatbot appearance?

Yes. ChatBliss offers extensive customization options including custom colors, chatbot icon, AI avatar, chat bubble size, light/dark/system themes, positioning (left/right), custom CSS, greeting messages, placeholder text, and widget layouts. Use the built-in AI Theme Generator to describe your ideal design and let AI create custom styling automatically.

How do I add the chatbot to my WordPress site?

You can add the chatbot using the shortcode [chatbliss_chatbot floating="yes"] for a floating widget or [chatbliss_chatbot floating="no"] for an embedded chat. Alternatively, enable "Append to Body" in settings to automatically display the chatbot on all pages without shortcodes.

Does ChatBliss support streaming responses?

Yes. ChatBliss supports real-time streaming responses for OpenAI, Anthropic Claude, and xAI Grok models. Streaming displays AI responses word-by-word as they're generated, providing a faster, more engaging chat experience for your visitors.

What is the Chat Transcripts feature?

The Chat Transcripts dashboard provides comprehensive conversation management. View all chat histories, see detailed conversation flows, track which knowledge sources the AI used for each response, monitor user engagement, and analyze chat analytics including daily activity, peak hours, and user distribution.

Can I see which content the AI chatbot used to answer questions?

Yes. ChatBliss includes full knowledge source transparency. In the Chat Transcripts and the optional debug panel, you can see exactly which pages, posts, products, or Q&A entries the AI retrieved and used to generate each response, along with relevance scores.

Is Pinecone vector database required?

No. ChatBliss includes free, unlimited local vector storage in your WordPress database. Pinecone integration is optional and recommended only for enterprise-scale knowledge bases with thousands of entries requiring faster search performance.

Does ChatBliss support multiple languages?

Yes. The AI chatbot supports multi-language conversations and automatically responds in the language your visitors use. ChatBliss also supports right-to-left (RTL) languages like Arabic and Hebrew.

How much do AI API calls cost?

API costs depend on your chosen provider and model. OpenAI, Anthropic, Google, and others charge based on token usage. DeepSeek and Google Gemini offer generous free tiers. ChatBliss includes intelligent token optimization to minimize API costs. You can also set rate limits for guests and logged-in users to control usage.

Is ChatBliss GDPR compliant?

Yes. All conversation data is stored locally on your WordPress site, giving you complete control. Configure automatic data retention policies, export chat transcripts, or delete conversations as needed for compliance.

Can I restrict chatbot access to certain users?

Yes. ChatBliss includes role-based access controls. Restrict the chatbot to logged-in users only, specific user roles, or keep it public. You can also restrict specific knowledge base content to certain user roles.

Does ChatBliss support live chat handoff?

Yes. ChatBliss integrates with Slack for live agent handoff. When the AI cannot help or a visitor requests human support, conversations can be seamlessly transferred to your team via Slack.

What are Actions and how do they work?

Actions are custom triggers that execute when user intent is detected. Create actions for lead capture, appointment booking, support tickets, page redirects, or custom JavaScript. The AI automatically recognizes when users want to perform these actions and triggers them contextually.

Can visitors upload documents to chat?

Yes. Enable document uploads to let visitors chat with PDFs and Word documents. The AI extracts and processes document content in real-time, allowing contextual Q&A about uploaded files.

Does ChatBliss support image generation?

Yes. With DALL-E integration, the AI chatbot can generate images based on user descriptions directly within the chat conversation.

How does the knowledge base auto-sync work?

Enable auto-sync for posts, pages, WooCommerce products, or custom post types. When you publish or update content, ChatBliss automatically updates the knowledge base with the new information. No manual re-importing required.

Can I use Advanced Custom Fields (ACF) with ChatBliss?

Yes. ChatBliss fully supports Advanced Custom Fields. ACF field data is automatically included when importing content. Use the ACF Field Settings to control which custom fields are included or excluded from the knowledge base—perfect for hiding private notes or internal data from the chatbot.

What embedding models does ChatBliss support?

ChatBliss supports multiple embedding models for vector search including OpenAI text-embedding-ada-002, text-embedding-3-small, text-embedding-3-large, Google Gemini embedding, and Voyage AI embeddings. Choose the model that best fits your accuracy and cost requirements.

Is there a free version of ChatBliss?

Yes. ChatBliss is available for free on the WordPress plugin repository with full AI chatbot functionality. Premium add-ons are available for advanced features like the AI Theme Generator and priority support.

Screenshots

  1. Chat Transcripts Insights - Review and analyze conversations insights to see engagement rate, peak activity, and user distribution.
  2. Chat Transcripts Insights - View 7 day activity trend graph.
  3. Knowledge & Sitemap Submission - Submit custom content to enhance the chatbot's responses.
  4. Action Page - Set custom action triggers to complete specific actions.
  5. Plugin Settings Page - Configure your API key and other settings.
  6. ChatBliss Debug Panel - Easily debug and view your content matching scores, citation URLs, triggered actions and more.

(Note: Screenshots will be added in future updates)

Changelog

3.2.3 - April 29, 2026

  • New: Embedding model switch protection — warning dialog when changing embedding models with content already embedded, plus a persistent admin notice while the active and selected models don't match. Each new embedding is now stamped with the model that produced it (KB, actions, action phrases, and Pinecone metadata) so mismatches are detectable
  • Improved: Landing Page Generator now plans more sections and writes substantially more copy per section, producing fuller, more conversion-ready pages by default
  • Fixed: Landing Page "Full Width" option not honored on WordPress block themes (Twenty Twenty-Two through Twenty Twenty-Five) — content was constrained by the theme.json layout system
  • Fixed: Chatbot citing manually submitted knowledge entries with internal chatbliss:// placeholder URLs — placeholders are now correctly treated as manual entries with no citation across both WordPress-DB and Pinecone retrieval paths

3.2.2 - April 21, 2026

  • NEW: Lead Management Dashboard — dedicated Leads tab inside Transcripts that deduplicates captured emails into a single list with conversation count, last-seen, and the page that captured them. Includes top-pages analytics, search + date/status/page filters, bulk delete with two-step confirm, CSV export (email-only or email + name), and one-click "View convo" to jump to each lead's latest conversation.
  • Fixed: Orphaned Pinecone chunk vectors left behind when posts or products were unpublished, trashed, deleted, or had their slugs renamed — deletion is now chunk-aware across all sync paths
  • Fixed: Source count and chunk count settings were being ignored on certain paths and silently fell back to default values — the configured values now apply everywhere

3.2.1 - April 17, 2026

  • Fixed: Admin Testing Tab debug panel not displaying similarity scores, action matches, or source data — including when web search + streaming are both enabled
  • Fixed: Web search responses (streaming and non-streaming) not saving RAG context to chat transcripts, causing the "sources" link to be missing

3.2.0 - April 15, 2026

  • Added: chatbliss_similarity_results filter hook after similarity search completes, allowing add-ons to access matched sources and their URLs
  • Removed: data-no-optimize attribute injection on ChatBliss CSS/JS tags, which was conflicting with third-party cache and optimization plugins

3.1.9 - April 7, 2026

  • Fixed: Session ownership issues that were causing "session expired" errors

3.1.8 - April 6, 2026

  • New: Loading indicator displayed while chat is initializing
  • New: Individual trigger phrase embeddings — each key phrase now gets its own vector for more accurate action matching
  • Improved: Existing actions remain fully backwards compatible with grouped legacy phrases
  • New: Admin Testing Tab - embedded chatbot replica with real-time debug panel showing similarity scores, action matches, approved URLs, system prompt, and debug log
  • Improved: "Delete All" in Knowledge Base now respects the active content type filter — only deletes the filtered type (e.g. Pages) instead of everything

3.1.7 - April 1, 2026

  • Fixed: Chat history not appearing for returning visitors until first message sent when chat persistence is enabled and email collection is off
  • Fixed: Lead capture form not displaying for new visitors when email collection is enabled
  • Fixed: Editing legacy manual knowledge base entries deleting all other manual entries sharing the same source URL
  • New: Google Drive PDF links are now automatically converted to direct downloads for knowledge base import

3.1.6 - March 30, 2026

  • Fixed: Pre-chat popup reappearing on every page refresh — it now stays dismissed for 24 hours
  • Fixed: Links with certain special characters in URLs being cut off
  • Fixed: Chat history not loading for returning visitors
  • Fixed: Links displaying as plain text instead of clickable links in chat responses

3.1.5 - March 25, 2026

  • Improved: Lowered default RAG sources limit from 6 to 3 to reduce token usage for users on lower-tier API plans
  • Improved: Added per-source chunk cap of 5 to prevent any single document from dominating context
  • New: RAG Chunks Limit setting — control max total chunks sent to AI (range 8–20, default 15) to balance context quality and token cost
  • New: Page-level chatbot visibility — show, hide, or use global setting per page/post from the meta box
  • New: Frontend debugger and transcripts now show actual sources and chunks used counts

3.1.4 - March 22, 2026

  • New: Added support for OpenAI GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano, and GPT-5.3 Chat models
  • New: Edit Default Prompt — customize the AI system prompt for blog posts and landing pages from the Content page, saved per type across sessions
  • New: Knowledge base entries can be edited inline with automatic re-chunking and re-embedding (works with both database and Pinecone)
  • New: Sitemap import now supports PDF URLs — bulk import PDFs via XML sitemap
  • Improved: Performance updates and bug fixes
  • Fixed: Clear chat session in ChatBliss debugger now fully clears chat sessions and context history

3.1.3 - March 16, 2026

  • New: Content Calendar tab added to Content page — shows locked preview when Advanced Content Editor is not installed, fully functional when add-on is active
  • New: Chat teaser pop-up message now supports multiple lines.
  • Improved: Session cookies and tracking now deferred until first user interaction — passive visitors no longer trigger session creation or AJAX calls
  • Improved: Markdown table rendering with column alignment, responsive scrolling, and alternating row styling

3.1.2 - March 13, 2026

  • New: Per-check AI fix buttons — hover any failing SEO check to see a sparkle icon that fixes just that item individually
  • New: SEO dashboard now has row checkboxes with "Optimize Selected" to batch-optimize posts (requires Advanced Content Editor add-on)
  • Improved: "AI Optimize" button renamed to "Optimize All" for clarity
  • Improved: SEO modal now includes a "View Page" link and per-check AI fix buttons are always visible
  • Improved: Post type dropdown now dynamically includes custom post types like WooCommerce Products
  • Fixed: AI Optimize now runs all addon checks (readability, internal links, image ALT, featured image) in the content editor — previously only meta description, title, and slug were included
  • Fixed: Chat transcripts not saving bot responses containing emojis due to database table using utf8mb3 charset — upgraded to utf8mb4
  • Fixed: WooCommerce product cards now display with image, price, and button in chat transcripts
  • Fixed: "Optimize All" now runs SEO fixes sequentially to prevent race conditions — previously internal links and other content-modifying fixes could overwrite each other
  • Upgraded: Image generation replaced deprecated DALL-E 3 with GPT Image (OpenAI) and added Gemini Imagen 4 action

3.1.1 - March 4, 2026

  • New: Slack agents can now transfer users back to AI mode by typing !endchat in the channel
  • New: Agents can include a custom farewell message (e.g. !endchat Thanks, have a nice day!) — the message is delivered to the user before the handoff
  • New: SEO analysis panel with real-time scoring for posts and pages in the Content section
  • New: AI Auto-Optimize — one-click AI fixes for meta descriptions, SEO titles, and URL slugs with configurable check selection
  • New: Google Search Console integration (Pro) — per-page impressions, clicks, CTR, and top search queries directly in the Content editor
  • New: SEO optimize settings — choose which checks AI Optimize will run from Content > Settings
  • Fixed: Stale nonce causing "Invalid nonce" errors on sites with full-page caching (WP Rocket, LiteSpeed, W3 Total Cache) — nonce is now refreshed via AJAX on page load
  • Fixed: Security scanner false-positives flagging file_put_contents as malware — replaced with WP_Filesystem API for transcript and PDF temp files
  • Improved: PDF parser library now lazy-loaded on demand instead of on every page request

3.1.0 - March 1, 2026

  • Fixed: Bulk deleting selected knowledge base entries with chunked content causing network timeout error when using Pinecone
  • Fixed: Manually entered knowledge base content not being used for AI context despite having high similarity scores
  • Fixed: Chat input remaining blocked after live agent handoff (Slack/Telegram)
  • Fixed: Pinecone knowledge base scan returning "Not In Knowledge Base" when using text-embedding-3-large (TE3 Large) due to hardcoded 1536 dimension instead of 3072
  • Fixed: Shortcode stripping silently losing all content on pages with large or deeply nested shortcodes (e.g. WPBakery/Visual Composer) due to regex backtracking
  • New: Added chatbliss_before_process_post filter hook to allow developers to modify post data before knowledge base processing
  • New: Added chatbliss_system_instructions filter hook and shortcode support in system prompt for dynamic data injection

3.0.9 - February 24, 2026

  • New: AI Content Generator — generate full blog posts and landing pages from a single prompt with AI images, SEO metadata, real-time preview, inline AI editing, and content history
  • New: Advanced Content Editor premium add-on — smart internal linking, AI image management, and per-field AI meta generation
  • New: Dynamic post type filtering in knowledge database dropdown — automatically pulls in all registered post types
  • Improved: Compatibility with popular optimization and caching plugins

3.0.8 - February 20, 2026

  • New: Debug & optimization tools with log viewer, settings export, and reset options
  • New: Added Claude Sonnet 4.6 model
  • Improved: Performance optimizations and caching plugin compatibility

3.0.7 - February 15, 2026

  • New: Performance optimization
  • Fixed: GPT-5.1 Chat Latest model returning API error when web search was disabled

3.0.6 - February 11, 2026

  • New: RAG Sources Limit slider - control how many knowledge base sources (3-10) are included in AI responses
  • New: {visitor_name} placeholder support in Intro Message and AI Behavior settings for personalized greetings
  • New: Added Claude Opus 4.6 and Claude Opus 4.5 models
  • Fixed: Chat persistence OFF now correctly starts fresh AI context on page reload (previously AI retained full history)
  • Deprecated: Removed all GPT-4 series and GPT-3.5 Turbo from model selection (OpenAI deprecation)
  • Deprecated: Removed Claude 3.x series models (3.7 Sonnet, 3.5 Sonnet, 3 Opus, 3 Sonnet, 3 Haiku) per Anthropic deprecation
  • Updated: Users on deprecated OpenAI models auto-migrated to GPT-5.1 Chat Latest (or GPT-5 Mini for mini models)
  • Updated: Users on deprecated Claude models auto-migrated to Claude Opus 4.6 (or Claude Haiku 4.5 for Haiku users)

3.0.5 - January 28, 2026

  • Fixed: Updated Gemini embedding model from deprecated gemini-embedding-exp-03-07 to stable gemini-embedding-001
  • Fixed: Notification settings not saving on new installations
  • Fixed: Save indicators not visible on settings fields (API keys, Slack, Telegram, Loops, Brave Search)
  • Added: Warning notice for WordPress database users recommending Pinecone for large knowledge bases
  • Improved: Minor admin UI updates for better user experience

3.0.4 - January 24, 2026

  • New: Added latest Google Gemini models (3 Pro Preview, 3 Flash Preview, 2.5 Pro, 2.5 Flash, 2.5 Flash-Lite)
  • New: Transcript translation feature - auto-translate chat transcripts to any language
  • New: Action scores visible in transcript sources modal - see document rankings and triggered actions
  • Fixed: Lead capture forms not working due to multi-bot class ID changes

3.0.3 - January 21, 2026

  • Fixed: Bug when web search was enabled the chat input was not enabled again.

3.0.2 - January 21, 2026

  • New: Telegram Live Agent integration for live chat handoff via Telegram forum topics
  • New: Telegram settings page (Settings > Integrations > Telegram)
  • New: Telegram action type in Actions page for intent-based handoff
  • New: Citation Links toggle to enable/disable source URLs in AI responses (Chatbot > Behavior)
  • Changed: Renamed "Live Agent" settings tab to "Slack"

3.0.1 - January 18, 2026

  • New: Multi-select entries with bulk "Delete Selected" in knowledge base
  • New: OpenAI Vector Store integration for knowledge retrieval
  • New: Custom Post Meta whitelist for including non-ACF meta fields in embeddings
  • Improved: WordPress database search now filters to matching records only
  • Improved: WordPress import shows 100 items by default with cross-page selection
  • Fixed: ACF Field Settings now displays correctly in Knowledge Base sidebar
  • Changed: Chatbot CSS selectors migrated from IDs to classes for multi-bot support
  • Note: AI Theme Customizer users must update add-on and click "Migrate" on their theme

3.0.0 - January 14, 2026

  • New: Complete admin UI overhaul with modern sidebar navigation across all pages
  • New: Clean, professional design with consistent styling throughout the plugin
  • New: Automatic sitemap detection wit

This README is longer than the copy stored here. Read the rest on GitHub →