Focused WordPress plugins for real client work.Clear licensing for 1, 5, or 100 websites
Dprime Plugins
CartBrowse plugins

AI Smart Woo Chatbot help

Installation, usage, and technical reference for version 3.6.1.

Overview

Dprime AI Smart Woo Chatbot adds an AI shopping assistant to your WooCommerce store. It appears as a chat bubble on every page, answers product questions using your catalogue and knowledge base, and lets customers add simple products to cart directly from the conversation.

Before you start

  • WordPress 6.4 or newer
  • PHP 8.2 or newer
  • WooCommerce must be active

Installation

  1. Install and activate WooCommerce and Dprime Core.
  2. Download this plugin from dprimeplugins.com.
  3. Install and activate it. It appears under Dprime > AI Smart Woo Chatbot.
  4. Pick an AI provider, add its API key on the Settings tab, and enable AI.
  5. Fill in the Knowledge Base and click Sync now on the Settings tab.

Interface guide

Use these screens with the steps below. Select an image to open it at full size.

AI Smart Woo Chatbot settings for the chat name, opening message, and storefront controls.
Set the shopper-facing name, opening message, WooCommerce behavior, and AI provider from one screen.

Using the plugin

  • AI powered with full product catalogue awareness, choose OpenAI, Anthropic Claude, DeepSeek, Google Gemini, or xAI Grok
  • Sync mode (cached snapshot) or Live mode (tool calls per query)
  • Product cards in chat with View, Add to cart, and synchronized wishlist controls
  • Knowledge base for store policies, shipping, and FAQ
  • Configurable bubble position, movement mode, colours, and theme
  • AI usage dashboard with token and cost tracking
  • WhatsApp handover button shown in chat when a customer asks for a person or the AI cannot answer
  • Nine chat themes including Browser, Terminal, Phone, Minimal, and Retro
  • Usage dashboard with per model cost estimates and a reset button
  • Knowledge base import and export as plain text files, single .txt or a .zip of many
  • Integrates with Dprime Woo Wishlist, Addons, Attachment, Product Condition, Product Warranty, Currency Switcher, and TranslatePress when installed
  • Bubble only, no shortcode and no inline placement

Styling and CSS classes

These public-facing class hooks are present in the plugin styles. Add custom CSS only after checking the result on a staging site.

.dplb-addon-chip.dplb-addon-chips.dplb-addon-desc.dplb-addon-error.dplb-addon-form.dplb-addon-form-title.dplb-addon-group.dplb-addon-input.dplb-addon-label.dplb-admin-notice.dplb-attachment-btn.dplb-attachment-icon.dplb-attachments.dplb-avatar.dplb-branding.dplb-bubble.dplb-chip.dplb-chrome.dplb-chrome-bar.dplb-chrome-body.dplb-chrome-browser-dark.dplb-chrome-browser-light.dplb-chrome-dot.dplb-chrome-notch

Works with

These connections are covered by the release contract tests.

  • Woo Wishlist: Wishlist actions inside store chat
  • Woo Addons: Product add-on choices and cart data inside store chat
  • Woo Attachment: Product-linked attachment downloads inside store chat
  • Woo Product Condition: Product condition context inside store chat
  • Woo Product Warranty: Product warranty context inside store chat
  • Woo Currency Switcher: Store-chat prices use the selected storefront currency

Data and cleanup

  • 4 WordPress settings
  • Database table: your WordPress table prefix + dpswc_usage
  • Scheduled task: dpswc_usage_purge
  • Optional external services: OpenAI, Anthropic, DeepSeek, Google Gemini, xAI

Retention: kept until the plugin is uninstalled. Uninstall policy: delete the plugin-owned data declared above.

Troubleshooting

  1. Confirm the required WordPress, PHP, and companion-plugin versions above.
  2. Save the plugin settings again, then repeat the exact action that failed.
  3. Clear page, object, and browser caches when the issue affects front-end output.
  4. Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
  5. If the problem remains, record the steps, visible error, and relevant logs before contacting support.

Frequently asked questions

Which AI providers and models are supported?

OpenAI, Anthropic Claude, DeepSeek, Google Gemini, and xAI Grok. Each provider keeps its own API key and model selection. The cheapest model of each provider is preselected and fits most stores, and premium models such as GPT-5, Claude Opus, Gemini Pro, and Grok 4 are available for complex catalogues.

How does the WhatsApp handover work?

Enable WhatsApp handover on the Settings tab, pick your country code, and enter your number in national format. The country code list covers countries worldwide and defaults to your WooCommerce store location. When a customer asks for a person, asks for WhatsApp, or the AI cannot answer, the chat shows a WhatsApp button that opens a conversation with your number.

Does the movable bubble work on mobile only?

Yes. Set Movable bubble to Mobile only from the Appearance tab. You can also enable it on desktop and mobile.

Can I keep the launcher tooltip visible?

Yes. Set Auto hide after seconds to 0 on the Appearance tab.

How do I translate text such as Shop Assistant and Add to cart?

Open Dprime > AI Smart Woo Chatbot > Translations. The plugin reads the published TranslatePress languages and gives each non-default language its own fields. Manual values take priority over automatic translation for JavaScript generated text.

How does the chatbot answer when a customer asks for the phone number?

Enable WhatsApp handover, turn on Show the number in replies, and optionally enter a formatted Public display number. The chatbot then returns that exact number and can show the WhatsApp button according to the selected visibility mode.

Updates and access

An active individual or portfolio entitlement provides updates and support. After expiry, the installed local version remains, while update access, support, new activations, domain moves, and protected remote services stop.