Getting Started

WooAI Chatbot Pro is an AI sales assistant for your WooCommerce store. Here’s how to install the plugin and get the chatbot running on your storefront.

ℹ️
Before You Begin

You need administrator access to your WordPress site, a working WooCommerce store with products, and about 30 minutes. Keep your license key handy; it came with your purchase.

System Requirements

Requirement Minimum Recommended Status
WordPress Version 6.2+ 6.6+ Required
WooCommerce Version 8.0+ 9.0+ Required
PHP Version 8.1+ 8.2+ Required
PHP Memory Limit 128MB 256MB+ Recommended
SSL Certificate Active Recommended

What Else You Will Need

Two external accounts, both free to start:

  • An AI provider key. We use Google Gemini as the default. OpenAI and Anthropic Claude work too.
  • A Supabase project. This is the vector database that lets the bot search your real catalogue. The RAG & Search guide walks through it.

Installation

Install WooCommerce first

WooAI Chatbot Pro extends WooCommerce. Make sure WooCommerce is installed and activated before you continue, otherwise activation will fail.

Upload the plugin

Go to Plugins → Add New → Upload Plugin, click “Choose File”, select woo-ai-chatbot-pro.zip, then click “Install Now”.

WordPress plugin upload screen
Plugins → Add New → Upload Plugin
Activate

Click Activate Plugin when the upload finishes.

Confirm the menu appears

You’ll see AI Chatbot in the WordPress admin sidebar. Open it to reach the Dashboard.

⚠️
Activation failed?

Usually one of two things: WooCommerce is not active, or PHP is older than 8.1. Check both, then try again.

Activating Your License

The license unlocks updates and support.

Open the License screen

Go to AI Chatbot → License & Updates.

Enter your license key

Paste the key you received with your purchase and click Activate License.

Verify

A green License Active badge appears, together with the domain the license is registered to, the plan and the expiry date.

WooAI License screen showing an active license
License & Updates with an active license

If you ever move the site to another domain, open this screen, click Deactivate License on the old domain and activate it again on the new one. Revalidate forces a fresh check without deactivating.

Getting Around the Admin

Everything lives under the AI Chatbot menu:

ScreenWhat it is for
DashboardConversations, messages, cart and conversion metrics
AI ProvidersAPI keys, models, fallback provider, custom rules
RAG & SearchSupabase connection, content and product indexing, search tuning
TopicsThe suggested topic chips shown in the chat window
ContextExtra knowledge you give the bot about your business
PromotionsOffers the bot is allowed to mention
LicenseLicense status and updates
Analytics SettingsWhat the analytics layer records
AppearanceColours, position, welcome message, widget behaviour
LogsDiagnostic log for troubleshooting

First Run

Three steps, in this order.

Connect an AI provider

Go to AI Chatbot → AI Providers, paste your API key and pick a model. Use the Test button next to the key to confirm it works. Full walkthrough: AI Providers.

Connect Supabase and index your catalogue

Without this the bot can still chat, but it cannot answer questions about your actual products, prices or stock. This is the longest step. Follow RAG & Search from start to finish.

Style the widget and test it

Adjust colours, position and welcome message under Appearance, then open your storefront in a normal browser tab and ask the bot about a product you know exists.

🎉
You are done

Ask the bot about a real product. If the name, price and stock status are all correct, the install works. After that, Topics, Context and Promotions are where you make it sound like your store.