Installation
Install MooChatAI on your WooCommerce store in just a few minutes.
Requirements
- WordPress 5.8 or higher
- WooCommerce 5.0 or higher
- PHP 7.4 or higher
Step 1: Install the Plugin
Download the latest version and upload it to your WordPress site:
Then upload it via your WordPress admin:
WordPress Admin → Plugins → Add New → Upload Plugin → Choose File
Step 2: Activate the Plugin
After installation, click Activate to enable the plugin. You will be automatically redirected to the setup wizard.
Install MooChatAI on your Shopify store directly from the Shopify App Store.
Requirements
- An active Shopify store (any plan)
- Products in your store catalog
Step 1: Install from Shopify App Store
Find MooChatAI on the Shopify App Store and click Install. You will be redirected to authorize the app.
Step 2: Authorize the App
Review the permissions and click Install app. MooChatAI requests access to:
- Products: To sync your product catalog for AI recommendations
- Orders: To provide order tracking and shipping notifications
- Customers: To personalize the chat experience
Step 3: App Opens in Shopify Admin
After authorization, MooChatAI opens as an embedded app inside your Shopify admin. You'll see the dashboard with your free plan activated.
Setup Wizard
The setup wizard walks you through the initial configuration in 3 easy steps.
Step 1: Choose Your Plan
Select from the available pricing plans:
| Plan | Price | Products | Chats/Month |
|---|---|---|---|
| Free (BYOK) | $0 | 10 | 500 |
| Basic (BYOK) | $36/year | 100 | 25,000 |
| Pro (BYOK) | $79/year | Unlimited | Unlimited |
| Standard | $19/month | 100 | 10,000 |
| Plus | $49/month | 500 | 20,000 |
Step 2: Create Your Account
For BYOK plans: Enter your email address and your OpenAI API key. The key will be validated before proceeding.
For Provided plans: Enter your email address. If you've already purchased a license, it will be activated automatically.
Step 3: Setup Complete
Your account is registered and the widget is ready. You'll be taken to the MooChatAI dashboard where you can sync your products and start chatting.
After installing from the Shopify App Store, MooChatAI is ready to configure right inside your Shopify admin panel.
Initial Setup
Once installed, MooChatAI automatically:
- Creates your MooChatAI account linked to your Shopify store
- Activates the Free plan (BYOK — Bring Your Own Key)
- Registers product and order webhooks for real-time sync
- Sends a welcome email with your account details
Next Steps
- Add your OpenAI API key in the API Key (BYOK) section, or upgrade to a Provided plan in Billing
- Sync your products from the Product Sync page
- Enable the widget on your storefront by activating the theme app extension
- Customize the widget appearance, greeting, and language in Widget Settings
Configuration
Configure MooChatAI from your WordPress admin panel at MooChatAI → Settings.
Widget Settings
- Enable Chat Widget: Toggle the widget on or off
- Position: Bottom-right or bottom-left
- Primary Color: Match your brand color
- Language: Default UI language (26 languages available)
- Welcome Message: Customize the greeting shown when visitors open the chat
- Proactive Delay: Seconds before the chat popup appears automatically
Lead Capture Settings
- Collect Email: Ask visitors for their email before or during chat
- Require Email: Force email entry before chatting
- Notification Email: Where to receive lead notifications
Email Notifications
- New Chat Alert: Get notified when customers start chatting
- New Lead Alert: Get notified when visitors provide their email
- Daily Summary: Receive a daily report of chat activity
Sync Settings
- Sync Frequency: Hourly, twice daily, daily, or weekly
- Last Sync Status: View when products were last synced
- Manual Sync: Trigger a product sync on demand
Configure MooChatAI directly inside your Shopify admin. Navigate to Apps → MooChatAI to access all settings.
Widget Settings
Navigate to the Widget Settings section in the sidebar:
- Position: Bottom-right or bottom-left
- Primary Color: Hex color picker to match your brand
- Greeting Message: Custom welcome text
- Language: Default UI language (26 languages available)
- Proactive Chat: Toggle with configurable delay
- Quick Buttons: Up to 5 quick action buttons (see Quick Buttons)
Store Info
Navigate to Store Info in the sidebar to add business information the AI uses to answer customer questions:
- Shipping Information: Shipping rates, timeframes, methods
- Return Policy: Return window, conditions, process
- Contact Information: Email, phone, support hours
- Business Hours: Your operating hours
Product Sync
MooChatAI uses AI-powered vector search to match customer queries with your products. Products must be synced from WooCommerce to MooChatAI's search engine before the AI can recommend them.
Automatic Sync
Products are automatically synced when you:
- Add, update, or delete a product in WooCommerce
- Change stock status or price
- Run the scheduled sync (configurable: hourly, daily, weekly)
Manual Sync
Trigger a manual sync from the dashboard:
MooChatAI → Dashboard → Click "Sync Products"
What Gets Synced
Each product's data includes:
- Name, description, price, sale price
- Categories, tags, and attributes
- Images (main image + gallery, up to 10)
- Stock status and quantity
- Variations (for variable products)
- Reviews (average rating, count)
- Related products, upsells, and cross-sells
Store Data
Along with products, MooChatAI also syncs your store configuration:
- Shipping zones, methods, and rates
- Tax settings and rates
- Payment gateways (Stripe, PayPal, etc.)
- Active coupon codes (if enabled)
- Checkout and cart URLs
MooChatAI syncs your Shopify products so the AI can recommend them to customers. Products are stored in a vector database for fast, intelligent search.
Trigger a Sync
Navigate to Product Sync in the sidebar and click Sync Products Now. The sync runs in the background — you can track progress in real-time.
Automatic Sync
MooChatAI keeps your products up-to-date automatically via:
- Real-time webhooks: Products are synced instantly when you add, update, or delete them in Shopify
- Daily fallback sync: A daily sync at 6 AM UTC ensures no missed updates
What Gets Synced
- Product title, description, and vendor
- Price, compare-at price, and currency
- Images (main + gallery, up to 10)
- Variants (sizes, colors, etc.) with individual pricing
- Stock status and inventory tracking
- Product type and tags
Dashboard Overview
The MooChatAI dashboard provides an at-a-glance view of your store's chat performance.
Key Metrics
- Total Chats: All-time chat sessions
- Total Leads: Visitors who provided their email
- Conversions: Chats that led to purchases
- Average Rating: Customer satisfaction rating (1-5)
- Chat Usage: Monthly chat count vs. plan limit
- Product Usage: Synced products vs. plan limit
Quick Actions
- Sync Products: Manually trigger a product sync
- View Settings: Quick link to the settings page
- Recent Chats: See the 5 most recent conversations
- Recent Leads: See the 5 most recent email captures
The MooChatAI Overview page inside your Shopify admin shows your store's chat performance at a glance.
Key Metrics
- Total Chats: All-time chat sessions
- Chats This Month: Current month's usage vs. plan limit
- Average Rating: Customer satisfaction score
- Conversions: Chats that led to purchases
- Product Usage: Synced products vs. plan limit (with progress bar)
Navigation
Use the sidebar to navigate between sections:
- Overview — Stats and plan info
- Product Sync — Sync status and trigger
- Widget Settings — Customize appearance
- API Key (BYOK) — OpenAI key management
- Custom Training — Q&A pairs
- Store Info — Business information
- Agents — Human handoff setup
- Content Training — PDF and page import
- Recent Chats — Chat history
Managing Chats
View and manage all customer conversations from MooChatAI → Chats.
Chat List
Browse all chat sessions with pagination (20 per page). Each entry shows:
- Visitor name or email
- Message count
- Rating (if provided)
- Status (active, closed, handed off)
- Date and time
Chat Detail View
Click any chat to view the full transcript. The detail view includes:
- Complete message history with timestamps
- Visitor info sidebar (email, name, page visited, device)
- Products recommended during the conversation
- Agent name (if handoff occurred)
Chat Actions
- Email Transcript: Send the conversation to the visitor's email
- Export CSV: Download the chat as a CSV file
- View Orders: See WooCommerce orders for that visitor
View recent chat sessions from the Recent Chats section in the sidebar.
Chat History
The chats table shows:
- Session ID
- Message count
- Customer rating (X/5)
- Status (active, closed, handed off)
- Date and time
AI Chat
The AI chat assistant helps customers find products, answer questions, and complete purchases — available on both WordPress and Shopify stores.
How It Works
- Customer opens the chat widget on your store
- AI understands the customer's intent using natural language processing
- AI searches your product catalog using vector-based semantic search
- AI responds with helpful answers and product recommendations
- Customer can add items to cart, ask follow-up questions, or request human help
AI Capabilities
- Natural Language Search: "Show me blue dresses under $50"
- Product Comparisons: "What's the difference between Product A and Product B?"
- Stock & Pricing: Real-time stock status and price information
- Policy Questions: Shipping, returns, and store policies
- Cart Management: Add, remove, or update cart items directly from chat
- Order Tracking: Check order status and shipping info
- Checkout Guidance: Help customers complete their purchase
- Multilingual: AI responds in 90+ languages naturally
Product Cards
When the AI recommends products, they appear as interactive cards with:
- Product image (with gallery carousel if multiple images)
- Product name and price
- Star rating (if reviews exist)
- "View" button to open the product page
- "Add to Cart" button for instant purchase
- Recommendation badge (e.g., "Goes with", "Similar", "Upgrade")
Streaming Responses
AI responses stream in real-time, word by word, giving customers immediate feedback. The widget maintains a persistent WebSocket connection for low-latency communication, with automatic REST API fallback if WebSocket is unavailable.
Product Recommendations
MooChatAI uses AI-powered semantic search to understand what customers are looking for and recommend the most relevant products.
How Recommendations Work
- Vector Search: Customer queries are converted to embeddings and matched against your product catalog using semantic similarity
- Context-Aware: The AI considers the current page, recently viewed products, and cart contents
- Smart Suggestions: Recommends upsells, cross-sells, and complementary products
- Price Filtering: Understands budget constraints ("under $50", "cheapest option")
Recommendation Types
| Badge | Description |
|---|---|
| Similar | Products similar to what the customer is viewing |
| Goes with | Complementary products that pair well together |
| Upgrade | Higher-tier alternatives with more features |
| Related | Products in the same category or collection |
Image Gallery
Product cards display image galleries when multiple images are available. Customers can browse through images using previous/next buttons, and tap any image to open a full-screen lightbox viewer.
Cart Management
Customers can manage their shopping cart directly from the chat widget without leaving the conversation.
Add to Cart
When the AI recommends products, each product card has an "Add to Cart" button. Clicking it adds the item directly to the store's cart.
Abandoned Cart Recovery
When a customer leaves with items in their cart and returns later, MooChatAI automatically detects the abandoned cart and proactively offers help to complete the purchase. Available on Basic/Pro/Standard/Plus plans.
- Proactive popup showing cart items and total
- AI assists with completing the purchase
- Email recovery links that re-open the chat widget
Order Tracking
Customers can check their order status directly in the chat widget. Available on paid plans.
Order Lookup
Customers can ask "Where's my order?" or "Track my order" and the AI will guide them through the lookup process:
- Customer provides their order number and email
- AI looks up the order and displays the status
- Shows a visual order timeline (Ordered → Processing → Shipped → Delivered)
- Displays tracking number and carrier link if available
Proactive Order Notifications
For Shopify stores, MooChatAI receives real-time webhooks when orders are paid, fulfilled, or cancelled. If the customer has an active chat session, they'll receive instant notifications:
- Order Paid: Confirmation with order number and total
- Order Shipped: Shipping alert with carrier name and tracking link
- Order Cancelled: Cancellation notice
Human Handoff & Agents
When the AI can't help or a customer requests it, the conversation is handed off to a human agent for live chat. Available on paid plans.
Agent Limits by Plan
| Plan | Max Agents |
|---|---|
| Free | 0 (no handoff) |
| Basic / Standard | 1 agent |
| Pro / Plus | 3 agents |
Setting Up Agents
Navigate to MooChatAI → Agents to manage your support team:
- Click Add New Agent
- Enter the agent's name, email, and password
- The agent can log in at moochatai.com/agent
Navigate to the Agents section in the MooChatAI sidebar:
- Click Add Agent
- Enter the agent's name, email, and password (min 6 characters)
- The agent can log in at moochatai.com/agent
How Handoff Works
- Customer requests to "talk to a human" or the AI initiates a handoff
- A handoff request is added to the queue. The widget shows "Connecting you to an agent..."
- Available agents see the request in their dashboard and can accept it
- Once accepted, the conversation switches to live chat between the customer and agent
- When done, the agent can end the handoff, returning the customer to the AI
Agent Features
- Agent Dashboard: Dedicated live chat interface at moochatai.com/agent
- Availability Indicator: Widget shows "X agents available" when agents are online
- Typing Indicators: Real-time typing indicators between agent and customer
- Auto-Translation: Messages are automatically translated between agent and customer languages
- Quick Replies: AI-suggested responses based on the conversation context
Lead Capture
Collect visitor emails through the chat widget to build your customer list.
Pre-Chat Form
When enabled, a pre-chat form appears when visitors first open the widget, asking for their name and email before starting the conversation.
- Optional mode: Shows the form with a "Skip, just chat" option
- Required mode: Requires email entry before chatting
- Returning visitors skip the form (email saved in browser)
Managing Leads in WordPress
Navigate to MooChatAI → Leads to view all captured emails. Each lead shows:
- Name, email, and avatar
- Total conversations and orders
- Total spent (from WooCommerce)
- First contact date and source
- Internal notes
Widget Appearance
Customize how the chat widget looks on your store to match your brand.
Customization Options
| Setting | Description |
|---|---|
| Position | Bottom-right or bottom-left corner of the page |
| Primary Color | Hex color for the widget header, buttons, and accents |
| Greeting Message | Custom text shown when visitors open the chat |
| Language | Default UI language (26 languages supported) |
| Proactive Chat | Auto-popup after configurable delay (seconds) |
| Branding | "Powered by MooChatAI" footer (hidden on paid plans) |
Enabling the Widget on Shopify
After installing MooChatAI, you need to enable the theme app extension to display the widget on your storefront:
- Go to Online Store → Themes → Customize
- Click App embeds in the left sidebar
- Toggle MooChatAI Widget on
- Configure the widget settings (site key, position, color)
- Click Save
Enabling the Widget on WordPress
The widget is automatically enabled after completing the setup wizard. To toggle it on/off:
MooChatAI → Settings → Widget → Enable Chat Widget
The widget appears on all public pages except the WordPress admin area and login page.
Customer Rating
When customers close the chat after sending messages, they're prompted to rate their experience (1-5 stars) with an optional feedback comment. Ratings appear in your chat history and contribute to the average rating on your dashboard.
Custom Training
Train the AI with your store-specific knowledge so it can answer questions accurately.
Q&A Pairs
Add common questions and their answers. The AI will use these to respond to similar customer queries:
Question: What's your return policy?
Answer: We offer free returns within 30 days of purchase. Items must be unworn with tags attached.
Question: Do you offer gift wrapping?
Answer: Yes! We offer complimentary gift wrapping on all orders. Just add a note at checkout.
Manage Q&A pairs at MooChatAI → AI Training. You can add, edit, and delete pairs. The AI also auto-learns from conversations — these appear with an "Auto" badge.
Manage Q&A pairs in the Custom Training section of the MooChatAI admin. Add a question and answer, then click Add.
Store Information
Provide key store details that the AI uses to answer policy and business questions:
- Shipping Info: Shipping rates, timeframes, free shipping thresholds
- Return Policy: Return window, conditions, process
- Contact Info: Support email, phone, and hours
- Business Hours: Operating days and hours
Content Training
Import additional content to expand the AI's knowledge beyond products and Q&A pairs.
PDF Upload
Upload PDF documents (product catalogs, policy documents, size guides) to train the AI. Maximum file size: 1 MB.
- Drag and drop or click to upload a PDF file
- Optionally extract Q&A pairs automatically from the content
- The text content is indexed for AI search
Import Store Pages
Import content directly from your Shopify pages and blog articles:
- Click Load Store Content in the Content Training section
- Select the pages and blog articles you want to import
- Click Import Selected
Imported content is indexed into the AI's knowledge base, so it can answer questions about your policies, FAQs, and blog topics.
Import Pages
Upload PDF documents from MooChatAI → Content Training. The content is automatically processed and added to the AI's knowledge base.
Languages
MooChatAI supports multilingual stores with both widget UI translations and AI language capabilities.
Widget UI Languages (26)
The widget interface (buttons, labels, placeholders) is available in 26 languages:
English, Spanish, French, German, Portuguese, Italian, Dutch, Polish, Japanese, Chinese (Simplified & Traditional), Korean, Russian, Arabic, Turkish, Hindi, Vietnamese, Thai, Indonesian, Malay, Swedish, Danish, Norwegian, Finnish, Czech, and Romanian.
AI Response Languages (90+)
Powered by GPT-4o-mini, the AI can respond naturally in over 90 languages, including languages not in the widget UI list. Even if the widget UI isn't translated, the AI will respond in the customer's language.
Automatic Language Detection
When a visitor opens the chat, MooChatAI detects their browser language. If it differs from the store's default language and is supported, the visitor is prompted to choose their preferred language.
RTL Support
Arabic, Hebrew, and other right-to-left languages are fully supported with proper text direction and layout mirroring.
BYOK Setup
BYOK (Bring Your Own Key) lets you use your own OpenAI API key. This means you pay OpenAI directly for AI usage, and MooChatAI charges a lower subscription fee (or free).
Who Should Use BYOK?
- Free plan users: BYOK is required on the free plan
- High-volume stores: Direct OpenAI billing can be more cost-effective
- Control: You manage your own usage limits and spending
Getting an OpenAI API Key
- Go to platform.openai.com and sign up or log in
- Navigate to API Keys in your dashboard
- Click Create new secret key
- Copy the key immediately (it won't be shown again)
- Add billing info to your OpenAI account if not already set up
Adding Your Key
- Go to MooChatAI → Settings → BYOK
- Paste your OpenAI API key
- Click Validate API Key to verify it works
- Click Save
- Open MooChatAI in your Shopify admin
- Navigate to API Key (BYOK) in the sidebar
- Check Enable BYOK
- Paste your OpenAI API key
- Click Save
Coupons
Let the AI suggest and apply WooCommerce coupon codes during chat conversations. Available on paid plans.
Setting Up Coupons
- Go to MooChatAI → Settings → Coupons
- Enable Coupons in Chat
- Select which WooCommerce coupons the AI can suggest
- Optionally enable Auto-Suggest to let the AI proactively offer coupons
- Add Coupon Instructions to guide how the AI presents coupons
How It Works
The AI sees your coupon codes, discount types, amounts, and restrictions. It can:
- Suggest relevant coupons when customers ask about discounts
- Apply coupon codes directly to the customer's cart
- Show success/error notifications after applying
- Respect minimum spend and product restrictions
Coupon management for Shopify stores is handled through Shopify's native discount system. The AI can reference any active discounts you've configured in your Shopify admin.
Billing & Plans
WordPress plans are managed through your MooChatAI account. Visit moochatai.com/pricing for current pricing.
BYOK Plans (Bring Your Own Key)
| Plan | Price | Products | Chats/Month | Agents |
|---|---|---|---|---|
| Free | $0 | 10 | 500 | 0 |
| Basic | $36/year | 100 | 25,000 | 1 |
| Pro | $79/year | Unlimited | Unlimited | 3 |
Provided Plans (We Supply the AI)
| Plan | Monthly | Yearly | Products | Chats/Month | Agents |
|---|---|---|---|---|---|
| Standard | $19/mo | $190/yr | 100 | 10,000 | 1 |
| Plus | $49/mo | $490/yr | 500 | 20,000 | 3 |
Payments are processed via Stripe. You can manage your subscription from your MooChatAI billing page.
Shopify plans are billed through Shopify's billing system. Charges appear on your regular Shopify invoice.
Available Plans
| Plan | Price | Type | Products | Chats/Month | Agents |
|---|---|---|---|---|---|
| Free | $0 | BYOK | 10 | 500 | 0 |
| Basic | $9.99/mo | BYOK | 100 | 25,000 | 1 |
| Pro | $29.99/mo | BYOK | Unlimited | Unlimited | 3 |
| Standard | $19.99/mo | Provided | 100 | 10,000 | 1 |
| Plus | $49.99/mo | Provided | 500 | 20,000 | 3 |
Changing Your Plan
- Open MooChatAI in your Shopify admin
- Click Change Plan at the bottom of the sidebar
- Select a plan and click Subscribe
- Approve the charge on the Shopify billing confirmation page
- Your plan activates immediately
API Reference
MooChatAI provides a REST API for advanced integrations. All API endpoints are available at https://api.moochatai.com/v1/.
Authentication
Two types of keys are used:
- API Key (
sk_live_xxx): Private server-to-server key. Include in theX-API-Keyheader. - Site Key (
pk_live_xxx): Public key for browser/widget use. Used as a WebSocket query parameter.
Key Endpoints
| Endpoint | Method | Description |
|---|---|---|
/v1/chat/message |
POST | Send a chat message |
/v1/chat/ws |
WebSocket | Real-time chat via WebSocket |
/v1/products/sync |
POST | Sync products to the AI |
/v1/sites/settings |
GET/PUT | Get or update site settings |
/v1/knowledge/train |
POST | Submit Q&A training pairs |
/v1/handoff/request |
POST | Request human agent handoff |
/v1/chat/rate |
POST | Submit chat rating |