OpenCart Tutorials for EcomAIBridge

OpenCart Tutorials for EcomAIBridge

This tutorial guide covers everything you need to know to get the most out of the OpenCart plugin

Getting Best Results from EcomAiBridge OpenCart Extension

Welcome to EcomAiBridge — the OpenCart extension that transforms your store into an AI-powered shopping experience. Install it directly from the OpenCart Marketplace, activate, and your product catalogue is instantly reachable by AI agents, chat assistants, and every major LLM platform.

This guide walks you through every step — from a clean first installation right through to fine-tuning your AI's personality and reading your analytics dashboard. The OpenCart extension installs and works exactly like a native OpenCart extension. No FTP access, no code editing, no developer required. Follow the steps in order the first time through; return to any section whenever you need a quick reference.

Pro tip: The more completely you fill in every setting, the smarter and more helpful your AI assistant becomes. Skipping fields means your assistant is working with less context — always fill in all fields for best results.

Step 1 — Extension Installation

Installing EcomAiBridge for OpenCart is identical to installing any other OpenCart extension. No FTP access is required and no files need to be edited manually. The extension is fully self-contained and works on standard shared hosting, VPS, and dedicated servers running OpenCart.

Prerequisites

  • OpenCart: 3.x or 4.x
  • PHP: 7.4 or later (8.x recommended)
  • MySQL / MariaDB: 5.7 or later
  • cURL: Enabled on your server (check with your host if unsure)
  • HTTPS: Your store must be served over HTTPS (required for secure AI API communication)
  • OpenCart Admin Access: You must have full administrator privileges to install extensions

Installation — OpenCart Marketplace (Recommended)

  1. Log in to your OpenCart Admin panel.
  2. Navigate to Extensions → Marketplace and search for EcomAiBridge.
  3. Click Download on the EcomAiBridge listing. The extension will download and install automatically.
  4. Once the download completes, navigate to Extensions → Installer to confirm the package appears in the installed list.
  5. Go to Extensions → Modifications and click the Refresh button (top right). This applies the extension's OCMOD modifications to OpenCart. A success message confirms the refresh is complete.
  6. Navigate to Extensions → Extensions, select Modules from the extension type dropdown, find EcomAiBridge in the list, and click the green Install button.
  7. Click the blue Edit button that replaces Install after activation. This opens the EcomAiBridge settings panel — confirming a successful installation.

Installation — Manual Upload Method

  1. Download the ecomaibridge-opencart.ocmod.zip file from your purchase confirmation email or your account dashboard on the EcomAiBridge OpenCart page.
  2. In your OpenCart admin, navigate to Extensions → Installer.
  3. Click Upload, select the .ocmod.zip file, and wait for the upload progress bar to complete.
  4. Once uploaded, navigate to Extensions → Modifications and click Refresh.
  5. Navigate to Extensions → Extensions → Modules, find EcomAiBridge, and click Install then Edit.

Verify the Installation

After installation and activation, a new EcomAiBridge menu entry should appear in your OpenCart left-hand admin navigation. Click it to open the EcomAiBridge dashboard — you should see a setup checklist of steps still to complete. If the menu does not appear, return to Extensions → Modifications, click Refresh, then clear your OpenCart theme cache under Dashboard → the blue cog icon → Refresh.

Step 2 — Settings & Configuration

The Settings screen is the engine room of EcomAiBridge. This is where you connect the extension to your chosen AI provider and control how it reads your OpenCart product catalogue. The extension auto-detects your store name, currency, timezone, and OpenCart database tables automatically — you only need to supply your LLM API key.

AI Provider & API Key

  1. Go to EcomAiBridge → Settings → AI Provider.
  2. Select your AI model from the dropdown. Supported providers include Groq (free tier available), OpenAI (GPT-4o, GPT-4o mini), Anthropic (Claude Haiku, Claude Sonnet), Gemini, DeepSeek, Mistral, OpenRouter, and GLM.
  3. Paste your API key into the API Key field. Your key is stored securely in your OpenCart database and is never transmitted to third parties other than your chosen AI provider.
  4. Click Test Connection to confirm the key is valid and the API is reachable from your server. A green Connection Successful badge confirms everything is working.

Which model should I choose? Groq offers a generous free API tier and is the fastest option for most stores — a great starting point. For richer, more nuanced responses, use GPT-4o mini or Claude Haiku. Upgrade to GPT-4o or Claude Sonnet for technically complex product catalogues.

Product Catalogue Sync

  1. Under Catalogue Settings, the extension reads directly from your OpenCart database — no manual sync or API keys are needed for product access. Your live catalogue is always used.
  2. Set the Product Limit per AI Request — the number of products included in each AI context window. The default of 50 products covers most store sizes efficiently. Increase to 100 for larger catalogues or reduce to 30 for very fast response times.
  3. Enable Include Out-of-Stock Products if you want the AI to be aware of unavailable items so it can proactively suggest alternatives.
  4. Enable Include Product Attributes to give the AI access to extended product attributes (size, colour, material, compatibility) — strongly recommended for fashion, electronics, and technical product stores.

Auto-Detected Store Settings

EcomAiBridge reads the following directly from your OpenCart configuration — verify these are correct in Settings → General:

  • Store name and URL
  • Default currency and currency format
  • Store timezone
  • Default language

General Settings Checklist

  • ☑ AI provider selected and API key saved
  • ☑ Connection test passed (green badge)
  • ☑ Product limit per request configured
  • ☑ Product attributes enabled (recommended)
  • ☑ Auto-detected store settings verified

Step 3 — AI Chat Widget

The chat widget is the floating button and conversation panel your customers see and interact with. EcomAiBridge gives you full control over its appearance, position, and behaviour — directly from your OpenCart admin, no coding required.

Enabling the Widget

  1. Navigate to EcomAiBridge → Chat Widget.
  2. Toggle Enable Chat Widget to On.
  3. Select the pages where the widget should appear:
    • All Pages — widest coverage, good for stores where any page can drive a sale
    • Category & Product Pages Only — recommended for most stores; keeps the chat focused on purchase intent
    • Custom Selection — choose specific route paths (e.g. product/product, product/category)

Appearance Customisation

  • Widget Position: Bottom-right (default) or Bottom-left. Choose bottom-left if another extension (e.g. a cookie notice or live chat tool) already occupies the bottom-right corner.
  • Brand Colour: Set the primary colour of the widget button and the chat header to match your store's brand palette. Enter a hex code (e.g. #f97316) or use the colour picker.
  • Widget Button Icon: Choose from the built-in icon set (chat bubble, robot, sparkle, headset) or upload a custom SVG icon.
  • Widget Title: The heading shown in the open chat panel (e.g. "Ask Our AI Assistant" or your store name). Keep it short — under 30 characters looks best on mobile.
  • Welcome Message: The first message the assistant sends when a customer opens the chat. Make it friendly and action-oriented, for example: "Hi! I'm here to help you find the perfect product. What are you looking for today?"
  • Placeholder Text: The greyed-out text inside the input box. Use something inviting like "Type a question or describe what you need…"

Preview & Save

Use the Live Preview panel on the right side of the Chat Widget screen to see your changes in real time before saving. Once satisfied, click Save. Changes go live immediately — no OpenCart cache clear is required for widget settings.

Step 4 — License Key

The EcomAiBridge OpenCart Extension is available for free with no licence key required for the core features — including the AI Chat Widget, MCP Server, REST API, and AI Discovery Chain. A Pro licence unlocks the advanced admin dashboard, analytics, AI Personality customisation, and extended FAQ Builder.

Free Version — No Key Required

The free version activates immediately after installation. No registration, no licence key, no credit card. Your store's product API and basic AI chat are live from the moment you save your API key in Settings.

Activating Your Pro Licence

  1. Locate your licence key in the purchase confirmation email.
  2. In OpenCart admin, go to EcomAiBridge → Licence.
  3. Paste your licence key (format: EAIB-XXXX-XXXX-XXXX-XXXX) into the Licence Key field.
  4. Click Activate Licence. The extension will contact our licence server to validate the key.
  5. A green Licence Active badge with your plan name and expiry date confirms successful activation. The Pro admin dashboard sections will unlock immediately.

Licence Limits & Sites

  • Each licence key covers a specific number of active site activations as defined by your plan (e.g. 1-site, 3-site, or unlimited).
  • If you need to move the extension to a different domain, go to Licence → Deactivate on the old site first, then activate on the new domain using the same key.
  • For staging environments, activations on localhost or subdomains containing staging, dev, or test are not counted against your licence limit.

Automatic Updates

With an active Pro licence, EcomAiBridge updates are available directly from the OpenCart Marketplace. Navigate to Extensions → Marketplace → My Purchases to check for and apply updates. We recommend keeping the extension up to date to receive the latest AI model integrations, security patches, and feature improvements.

Step 5 — Business Info

The Business Info section is one of the most important — and most commonly under-filled — screens in the extension. The information you enter here is automatically injected into every AI conversation as background context. The more detail you provide, the more accurate, confident, and on-brand your assistant's answers will be.

Core Fields

  • Store Name: Your trading name as it should appear in customer-facing responses. The extension auto-fills this from your OpenCart store name — verify it matches your public brand name exactly.
  • Store Tagline: A one-sentence description of what your store sells and for whom. Example: "Premium electronics and accessories for tech enthusiasts — shipped across Southeast Asia." This helps the AI stay on-topic and gives it quick context for ambiguous questions.
  • Store URL: Your live storefront URL (auto-filled from OpenCart settings — verify it is the correct public-facing domain).
  • Contact Email: The support email address the assistant should direct customers to when it cannot answer a question.
  • Contact Phone: Optional but recommended for stores with a customer service line.
  • Physical Address: Include this if you have a showroom, physical store, or local pickup options — the AI will use it to answer location-based queries.

Store Policies

These fields are critical. Fill in every one — the AI uses this data to answer the questions customers ask most frequently, without any human involvement.

  • Returns & Refunds Policy: Paste a plain-text summary of your return window, conditions, and process. Even 3–4 sentences is far better than leaving this blank. Example: "We accept returns within 14 days of purchase. Items must be unused and in original packaging. Refunds are processed within 7 business days to the original payment method."
  • Shipping Policy: Delivery timelines, carriers used, free shipping threshold, international shipping availability. Example: "Free shipping on orders over ₹2,000. Standard delivery 3–5 business days. Express available at checkout."
  • Warranty / Guarantee: If you offer any product warranties or satisfaction guarantees, describe them here.
  • Other Store Policies: Any additional policies relevant to your store — exchange guidelines, pre-order terms, age restrictions, custom order lead times, etc.

Why This Matters

Without store policy data, your AI assistant will either refuse to answer policy questions (frustrating customers) or will guess (dangerous and potentially misleading). With complete policies entered, the assistant can confidently answer "What's your return policy?" in a natural, conversational way — saving you support emails and giving customers the confidence to purchase.

Step 6 — AI Personality

The AI Personality settings define how your assistant speaks — its tone, style, language, and the role it plays within your brand. A well-configured personality makes your chatbot feel like a natural extension of your store rather than a generic robot.

Assistant Name

Give your assistant a name that fits your brand. Customers are more likely to engage with a named assistant than one that introduces itself as "the AI." Examples: Luna for a fashion store, Max for a tech accessories store, Aria for a wellness brand. The assistant will use this name in its opening greeting and when referring to itself.

Tone of Voice

Select the communication style that best reflects your brand from the preset options, or choose Custom to write your own tone description:

  • Friendly & Casual — Warm, approachable, uses contractions and light humour. Best for lifestyle, fashion, home décor, and gifting stores.
  • Professional & Helpful — Clear, efficient, respectful. Best for B2B, electronics, office supplies, and professional services.
  • Enthusiastic & Energetic — High-energy, motivational, uses exclamations. Best for sports, fitness, and outdoor gear stores.
  • Caring & Empathetic — Gentle, understanding, patient. Best for health, wellness, baby, and pet stores.
  • Custom: Describe your tone in your own words, for example: "Speak like a knowledgeable friend who is an expert in sustainable fashion. Be concise, never preachy, and always give honest product comparisons."

Language & Localisation

  • Primary Language: The language your assistant should default to. Supports English, Hindi, Bahasa Indonesia, Arabic, Spanish, French, and all major languages supported by your chosen AI model.
  • Auto-detect Customer Language: When enabled, the assistant detects the language of the customer's first message and responds accordingly — ideal for stores with international traffic.
  • Currency Display: Auto-filled from your OpenCart store currency — verify the format (e.g. ₹1,499 vs INR 1499) so the assistant formats prices consistently in chat responses.

Response Length

  • Concise — Under 80 words per response. Good for quick product lookups and simple questions.
  • Balanced — 80–150 words. The default. Strikes the right balance for most queries.
  • Detailed — Up to 300 words. Use for stores with technically complex products (electronics, tools, supplement stacks) where thorough explanations drive conversions.

Custom System Prompt (Advanced)

If you have specific instructions that do not fit the preset options, the Custom System Prompt field lets you add free-form instructions that are prepended to every AI conversation. Use this for things like:

  • "Always mention our current sale (20% off sitewide) when recommending products."
  • "Never recommend competitor products under any circumstances."
  • "If a customer asks for a product we don't carry, suggest the closest alternative we have and explain why it is a good substitute."
  • "Always end responses with a call to action: invite the customer to add to cart or visit the product page."

Keep custom prompt additions focused and concise — overly long system prompts can reduce response quality and increase your API costs.

Step 7 — Behavior & FAQ

The Behavior & FAQ section gives you fine-grained control over what your assistant can and cannot do, and lets you pre-load answers to your most frequently asked questions for instant, reliable responses.

Behaviour Controls

  • Allow Product Recommendations: Toggle on to allow the AI to proactively suggest products based on what the customer describes, even if they haven't asked for a recommendation. Highly recommended — this is one of the biggest conversion drivers.
  • Allow Upsells & Cross-sells: When enabled, the assistant may suggest complementary products during a recommendation conversation. Control the behaviour further by specifying a maximum of 1, 2, or 3 additional suggestions per turn.
  • Out-of-Stock Handling: Choose what the assistant does when a customer asks about an out-of-stock product:
    • Suggest alternatives — recommends in-stock similar products (recommended)
    • Notify and offer back-in-stock alert — collects customer email (requires compatible email extension)
    • State unavailability only — does not recommend alternatives
  • Scope Boundary: Define what happens when a customer asks a question completely outside your store's scope. Options:
    • Politely redirect to products (default and recommended)
    • Politely decline and offer contact info
    • Answer briefly then redirect

FAQ Builder

The FAQ Builder is one of EcomAiBridge's most powerful tools. Pre-loaded question and answer pairs are given priority over the AI's general reasoning — so for your store's most critical questions, you get guaranteed, word-perfect answers every time.

How to add an FAQ entry:

  1. Click Add FAQ Entry.
  2. In the Question field, write the question as a customer would ask it naturally. Example: "Do you ship internationally?"
  3. In the Answer field, write the full, customer-facing answer. Example: "Yes! We ship to over 20 countries. International shipping rates and delivery times are shown at checkout based on your delivery address."
  4. Add synonyms or alternate phrasings in the Trigger Phrases field to help the AI recognise variations of the same question: "international shipping, ship overseas, deliver abroad, worldwide delivery".
  5. Click Save Entry.

Recommended FAQ categories to cover:

  • Shipping & delivery timelines
  • Return / exchange process
  • Payment methods accepted
  • Size guides and fit advice
  • Discount codes and loyalty programmes
  • Order tracking
  • Gift wrapping / special packaging
  • Product care and maintenance
  • Wholesale / bulk pricing enquiries
  • Custom or personalised orders

Aim to add at least 10–20 FAQ entries at launch. The more you add, the more reliably your assistant handles real customer questions without falling back on generic AI reasoning.

Step 8 — Analytics

The EcomAiBridge Analytics dashboard gives you insight into how your AI assistant is performing — which questions it handles well, where customers are dropping off, and how chat interactions translate into conversions. Use this data to continuously improve your configuration.

Key Metrics Explained

  • Total Conversations: The total number of chat sessions initiated during the selected period. A growing trend here indicates strong widget discoverability and customer curiosity. If this is low, consider changing your widget button label or welcome message to be more inviting.
  • Messages per Conversation (Depth): The average number of exchanges per chat session. A depth of 3+ is healthy and suggests the assistant is holding customer attention. A depth of 1 (one message in, one out) may indicate the first response is not satisfying or engaging enough.
  • Resolution Rate: The percentage of conversations where the customer's question was successfully answered without escalation. Aim for 70%+ at launch, improving toward 85%+ as you add FAQ entries and refine your prompt.
  • Escalation Rate: Conversations where the assistant referred the customer to human support or contact. A high escalation rate (above 25%) usually means your FAQ library or store policies are incomplete — review the most common escalation trigger phrases to identify gaps.
  • Catalogue Coverage: The percentage of product recommendations that referenced a product found in your live OpenCart catalogue. A low score indicates your product descriptions may be too thin for the AI to match queries accurately — enrich your product descriptions in Catalogue → Products.
  • Top Searched Products (Pro): The products and categories most frequently mentioned by customers in chat — invaluable for merchandising decisions and promoted category placement.
  • Provider Distribution (Pro): A breakdown of which AI provider handled each request, useful if you are running multiple providers or testing response quality across providers.

Using the Conversation Log

Navigate to Analytics → Conversation Log to review individual chat sessions. Each session shows:

  • Timestamp and session duration
  • Full message transcript (customer + AI)
  • Products mentioned or recommended
  • Session outcome: resolved, escalated, or abandoned

Review your conversation log weekly for the first month. Look for:

  • Questions answered incorrectly → Add or improve the relevant FAQ entry or update your store policy fields
  • Questions the AI refused to answer → Likely a scope boundary issue; review your Behavior settings or add a FAQ entry for that topic
  • Recurring questions not in your FAQ → Add them to the FAQ Builder immediately
  • Successful recommendation flows → Note which product categories perform best and ensure those descriptions are as detailed as possible

Analytics Filters

Use the date range filter (last 7 days / 30 days / 90 days / custom) to segment performance over time. The CSV export includes anonymised session IDs, timestamps, message counts, outcomes, and products referenced — no personally identifiable customer data is included in exports.

Exporting Data

Click Export CSV on any analytics table to download the full dataset for use in your own spreadsheets or reporting tools. Up to 90 days of historical data is available for export on Pro plans.

Getting the Most from EcomAiBridge — Summary Checklist

Before you consider your setup complete, run through this final checklist:

  • ☑ Extension installed and OCMOD modifications refreshed
  • ☑ AI provider connected and connection test passed
  • ☑ Product limit and attribute inclusion configured
  • ☑ Chat widget enabled, branded, and positioned correctly
  • ☑ Pro licence activated (if applicable)
  • ☑ All Business Info fields completed — store name, contact details, and all policies
  • ☑ AI Personality configured — name, tone, language, and response length set
  • ☑ Behaviour rules reviewed — recommendations, upsells, escalation triggers enabled
  • ☑ At least 10 FAQ entries added and saved
  • ☑ Analytics reviewed after the first 7 days of live operation

If every item on this checklist is ticked, your EcomAiBridge OpenCart Extension is operating at full capacity. From here, your job is to review analytics weekly, keep your FAQ library growing, and ensure your product descriptions are detailed enough for the AI to make precise, confident recommendations.

Need Help?

If you run into any issues during setup or have questions not covered in this guide:

  • Browse the full documentation and video walkthroughs on our OpenCart Extension page
  • If you are not on OpenCart, explore the EcomAiBridge Standalone Middleware — a platform-agnostic PHP installation that works with WooCommerce, PrestaShop, and custom stores
  • Contact our support team — we typically respond within one business day

EcomAiBridge is actively developed and updated. New AI model integrations, behaviour controls, and analytics features are released regularly — keep your extension updated to access the latest improvements.

OpenCart Extension
Video Tutorials