Karavi AI Assistant

Free open-source AI chatbot and behavior automation plugin for WordPress and WooCommerce.

Karavi AI Assistant helps WordPress sites turn visitor behavior into useful AI-powered actions. Instead of showing the same static chatbot to every visitor, KaraviAiAssistant can react to what people are doing on the site: the page they are reading, the product they are viewing, how far they scroll, whether they are returning, whether they are close to leaving, what they click, what is in the cart, and how they move through a WooCommerce store.

Download on GitHub | Releases | WordPress.org | Website | Community Support

If Karavi AI Assistant helps you build a smarter WordPress or WooCommerce site, a GitHub star helps more developers discover the project and shows which open-source work is worth improving next.

GitHub Description

Open-source AI chatbot and behavior automation plugin for WordPress/WooCommerce: BYOK AI chat, smart triggers, Knowledge Base context, Content Insights, conversion goals, A/B testing, SEO tools, WooCommerce automation, and GitHub updates.

Requirements

• WordPress 6.0 or newer (tested up to 6.5).
• PHP 7.4 or newer.
• WooCommerce is optional but required for cart, checkout, product, and marketplace automation features.
• An AI provider API key from Google Gemini, OpenAI, Anthropic Claude, Grok, Mistral, or DeepSeek (Bring Your Own Key).

What Karavi AI Assistant Does

• Adds an AI chatbot to WordPress using the site owner's own AI provider API key.
• Supports Google Gemini, OpenAI, Anthropic Claude, Grok, Mistral, and DeepSeek.
• Creates behavior-based chat triggers for smarter proactive messages.
• Uses WordPress pages, posts, products, rendered page text, uploaded files, and live page context as Knowledge Base sources.
• Supports WooCommerce product context, cart behavior, checkout flow, purchase attribution, coupons, and product discovery.
• Tracks conversations, submissions, conversion goals, trigger analytics, A/B testing results, and content performance.
• Includes AI content generation, SEO tools, schema generation, internal-link suggestions, keyword ideas, and content refresh planning.
• Includes separate admin and frontend UI language controls with Persian (fa_IR) translation.
• Uses semantic design tokens, light/dark admin theme support, and WCAG-oriented UI helpers.

Why It Saves Money

Many chatbot tools charge a recurring fee per website, seat, contact volume, or advanced feature. That becomes expensive for freelancers, agencies, small businesses, WooCommerce stores, marketplace builders, and anyone managing more than one WordPress site.

Karavi AI Assistant removes that extra hosted chatbot layer. The plugin is free and open source. You install it on your own WordPress site, add your own AI provider API key, and pay only for the AI usage you choose. There is no Karavi AI Assistant account fee, no per-site unlock step, no required hosted chatbot platform, and no forced vendor lock-in.

This matters because store owners and site builders can:

• Start with the AI provider they already trust.
• Use cheaper/faster models for simple messages and stronger models for complex questions.
• Cache answers and reuse context to reduce repeated AI calls.
• Keep the automation logic inside WordPress instead of paying another SaaS platform for basic behavior rules.
• Extend the plugin directly when a client or marketplace workflow needs something specific.

Why It Can Be Better Than Generic Chatbots

Generic chat widgets usually wait for a visitor to ask a question. KaraviAiAssistant is built around WordPress, WooCommerce, and visitor behavior, so it can act at the right moment:

• It can open based on behavior, not only manual chat input.
• It understands WordPress content types, WooCommerce products, carts, and checkout context.
• It can use live page text, uploaded files, rendered content, and behavior snapshots as answer context.
• It lets site owners control provider, model, prompts, triggers, buttons, analytics, appearance, caching, and retention.
• It can test different chat variations and connect messages to real conversion goals.
• It is open source, so developers can inspect, modify, and extend it.

For WooCommerce stores and marketplaces, Karavi AI Assistant is useful because it can connect AI help to real buying behavior: product views, add-to-cart events, checkout drop-off, cart state, coupons, order attribution, and product-specific Knowledge Base answers.

Feature Map

AI Providers And Model Control

• Provider support for Gemini, OpenAI, Anthropic, Grok, Mistral, and DeepSeek.
• Separate API key fields for each provider.
• Automatic model fetching for selected providers.
• Variation A and Variation B can use different providers, models, personas, settings, and appearances.
• Content Engine can reuse Variation A credentials or use independent provider credentials.
• Optional fallback provider and fallback model when the primary provider fails.
• Optional model routing for short questions or greetings to cheaper/faster models.
• Local greeting replies can answer simple greetings without calling an AI model.
• Global API timeout setting.

Chat Widget

• Frontend chat widget enable/disable control.
• Bot name control.
• Welcome message and loading message controls.
• Custom floating logo.
• AI persona/instructions field for tone, rules, button behavior, and answer style.
• AI-generated contextual buttons.
• Persistent quick chat buttons.
• Quick button placement under messages, in the chat bar, or both.
• Action buttons that can open URLs or send predefined messages to AI.
• Normal chat response format modes: free AI, template locked, or hybrid required placeholders.
• Response templates with placeholders, slot instructions, missing-placeholder policy, and max word controls.
• Main chat capture for contact/data requests into Submissions with purpose, status, tags, and capture instructions.
• Conversation history support with configurable message and character budgets.

Knowledge Base

• Select which public WordPress content types can be used as AI context.
• Use posts, pages, WooCommerce products, and other public custom post types.
• Include rendered public page text from blocks, page builders, shortcodes, templates, and custom fields.
• Include visible current page text from the visitor's active page.
• Upload Knowledge Base files for AI context.
• Supported file-oriented knowledge workflows for PDF, TXT, Markdown, CSV, JSON, HTML, XML, and other text-like sources.
• Add behavior patterns from Content Insights as AI context.
• Control content excerpt words, product excerpt words, rendered page max characters, uploaded file count, and characters per file.
• Product tool-calling can let supported providers search WooCommerce products on demand.
• Tool result limits for product search.

Appearance And Layout

• Desktop floating button positions: bottom right, bottom left, top right, top left, or custom coordinates.
• Desktop floating button size, logo scale, background color, and transparent background option.
• Mobile floating button size, logo scale, bottom offset, and side offset.
• Floating label text, label color, background color, transparency, max width, gap, desktop position, and desktop font size.
• Optional mobile label with separate mobile position and font size.
• Chat window desktop width and height.
• Mobile panel width, full-width mode, height, full-height mode, horizontal alignment, and vertical alignment.
• Header text color, user message background color, user message text color.
• Chat font family, font size, line height, background color, text color, border radius, and padding.
• Quick button style, shape, and font size.
• Generated button style, shape, and font size.

A/B Testing

• Enable or disable A/B testing.
• Separate Variation A and Variation B configuration.
• Compare conversations, trigger conversations, normal conversations, views, conversions, and conversion rates.
• Assign triggers to all variations, Variation A only, or Variation B only.
• Mark conversion goals as A/B goals.
• Dashboard statistics for each variation.
• Export A/B results as CSV.

Engagement Triggers

• Trigger types: time on page, scroll depth, inactivity, click intent, cart abandonment, return visitor, page depth, UTM/referrer, instant condition, and desktop exit intent.
• Target page URL contains rules.
• Excluded page URL rules.
• Target section CSS selector rules.
• Proactive message per trigger.
• Normal side-panel opening or centered modal opening.
• Trigger quick reply buttons.
• Trigger-specific chat follow-up instructions.
• Trigger-specific submission capture with purpose, status, and tags.
• Trigger message modes: static, AI, AI-first, or static-first.
• Trigger AI controls for persona, provider scope, provider, model, temperature, max tokens, cache TTL, fallback message, and audit saving.
• Trigger response templates, required placeholders, slot instructions, missing-placeholder handling, and max word controls.
• Priority score and high-priority override.
• Trigger order preview.
• Cooldown modes: once per session, once per page, once per day, once per N days, disabled, or unlimited where supported.
• Cooldown day controls and dismiss-suppression limits.
• Suppress after conversion.
• Minimum time on page.
• Only if cart is empty or only if cart has items.
• Suppress if visitor already visited matching URLs.
• Date scheduling, day scheduling, and time-window scheduling.
• QA preview only mode with preview URL support.
• Recovery templates for cart/exit moments.
• Recovery CTA options: resume checkout, view cart, apply offer, custom action, coupon selection, custom label, and custom URL.
• Optional exit warning and fake exit button controls.

Trigger Segmentation And Verification

• Content Insights gate for trigger eligibility.
• Gate windows for last 7 days or last 30 days.
• Gate refresh intervals: 1 day, 7 days, 30 days, or manual.
• Thresholds for views, conversions, conversion rate, average time, scroll depth, add to cart, and checkout flow.
• Segment by page type: homepage, product, post, page, or any.
• Segment by device: mobile, desktop, or any.
• Segment by traffic source: direct, search, social, paid, email, referral, or any.
• Segment by behavior pattern: fast leaver, medium leaver, slow leaver, comparison shopper, fast closer, discoverer closer, unknown, or any.
• Segment by predicted next step.
• Include and exclude URL pattern filters.
• Opportunity threshold and hysteresis buffer controls.

WooCommerce And Marketplace Features

• Product Knowledge Base context.
• WooCommerce product visit conversion goals.
• Product search/select controls for goals and targeting.
• Add-to-cart tracking.
• Checkout and place-order action tracking.
• WooCommerce purchase attribution for Content Insights.
• Cart abandonment trigger.
• Cart-not-empty and cart-empty trigger conditions.
• Checkout flow and checkout dropout behavior signals.
• Coupon dropdown for recovery CTA offers.
• Product queue for AI content generation.
• Generate content for all products, specific products, or keyword topics.
• Related product recommendations in generated content.
• Product tool-calling for supported AI providers.
• Useful for marketplaces because each product, seller page, category, checkout path, and campaign source can become part of the visitor context.

Conversion Goals And Notifications

• Conversion goals by URL contains rules.
• Any detected conversion/payment success goal.
• CSS selector click goals.
• Form submit selector goals.
• Popular WordPress action goals.
• WooCommerce product visit goals.
• Common presets for WordPress button/CTA clicks, Contact Form 7, WPForms, Gravity Forms, Elementor forms, Fluent Forms, Ninja Forms, Formidable Forms, WooCommerce add to cart, WooCommerce checkout/place order, phone links, email links, and download links.
• Goal counters and A/B test goal selection.
• Email notifications for new leads.
• Optional full conversation transcript email to admin.

Content Insights And Behavior Analytics

• Track all public content, selected post types, or target URLs.
• Include and exclude post types.
• Include and exclude exact URLs or URL contains rules.
• Filter by any content, AI-generated content, or manual content.
• Filter by improved or not-improved content.
• Opportunity scoring with threshold and top-opportunity limits.
• Conversion counting by any conversion signal or only configured goals.
• Database-first analytics processing option.
• Dedicated Content Insights admin page.
• Content performance labels such as promote, watch, or improve.
• Content Insights suggestions for practical next actions.
• Create triggers from insight opportunities.
• Import historical CSV analytics from external tools.
• Map CSV columns into KaraviAiAssistant fields.
• Pull historical metrics from compatible WordPress analytics data when available.