WordPress Tutorials for EcomAIBridge

Getting Best results from EcomAiBridge WordPress Plugin

Welcome to EcomAiBridge — the WordPress plugin that transforms your WooCommerce store into an AI-powered shopping experience. In minutes you can give your customers a smart, conversational chat assistant that knows your entire product catalogue, answers pre-sales questions 24/7, and helps convert browsers into buyers.

This guide covers everything you need to know to get the most out of the plugin — from a clean first installation right through to fine-tuning your AI's personality and reading your analytics dashboard. Follow the steps in order the first time through; return to any individual section whenever you need a quick reference.

Step 1 — Plugin Installation

Installing EcomAiBridge is identical to installing any other WordPress plugin. You do not need to edit a single line of code. The plugin is fully self-contained and works on any standard WordPress / WooCommerce hosting environment (cPanel, Plesk, Kinsta, WP Engine, SiteGround, etc.).

Prerequisites

• WordPress: 6.0 or later
• WooCommerce: 7.0 or later (must be active)
• PHP: 8.0 or later
• cURL: Enabled on your server (check with your host if unsure)
• HTTPS: Your store must be served over HTTPS (required for secure API communication)

Installation — Upload Method (Recommended)

1. Download the ecomaibridge.zip file from your purchase confirmation email or your account dashboard on the EcomAiBridge WordPress page.
2. In your WordPress admin, navigate to Plugins → Add New → Upload Plugin.
3. Click Choose File, select the ecomaibridge.zip you downloaded, then click Install Now.
4. Once the upload is complete, click Activate Plugin.
5. A new EcomAiBridge menu item will appear in the left-hand WordPress admin sidebar — this confirms a successful installation.

Installation — FTP / File Manager Method

1. Extract the ecomaibridge.zip file on your local machine. You should see a folder named ecomaibridge.
2. Using an FTP client (FileZilla, Cyberduck, etc.) or your hosting control panel's File Manager, upload the ecomaibridge folder to /wp-content/plugins/ on your server.
3. Return to WordPress Admin → Plugins → Installed Plugins, find EcomAiBridge in the list, and click Activate.

Verify the Installation

After activation, navigate to EcomAiBridge → Dashboard in your admin sidebar. You should see the welcome screen with a checklist of setup steps still to complete. If the page does not appear, deactivate and reactivate the plugin, then check that WooCommerce is active.

Step 2 — Settings & Configuration

The Settings screen is the engine room of EcomAiBridge. This is where you connect the plugin to your chosen AI provider (OpenAI, Anthropic, etc.) and control how it reads your WooCommerce product catalogue.

AI Provider & API Key

1. Go to EcomAiBridge → Settings → AI Provider.
2. Select your AI model from the dropdown. Supported providers include OpenAI (GPT-4o, GPT-4o mini) and Anthropic (Claude Haiku, Claude Sonnet).
3. Paste your API key into the API Key field. Your key is stored securely in your WordPress 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? For most stores, GPT-4o mini or Claude Haiku offer the best balance of speed, cost, and quality. Use GPT-4o or Claude Sonnet if you have complex products that require detailed, nuanced responses.

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 — 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
   • Shop & Product Pages Only — recommended for most stores; keeps the chat focused on purchase intent
   • Custom Selection — choose specific pages by ID or slug

Appearance Customisation

• Widget Position: Bottom-right (default) or Bottom-left. Choose bottom-left if another plugin (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. #1A6BFF) 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 Widget Settings. Changes go live immediately — no cache clear required.

Step 4 — License Key

EcomAiBridge uses a licence key to unlock Pro features and to receive plugin updates automatically through the WordPress updates system. Without an active licence, the plugin runs in Free mode with reduced functionality.

Activating Your Licence

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

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 plugin 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, use your live site key — 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 appear in the standard WordPress Admin → Dashboard → Updates screen just like any other plugin. We recommend keeping the plugin 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 plugin. 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. Example: Bella Boutique.
• Store Tagline: A one-sentence description of what your store sells and for whom. Example: "Contemporary womenswear for everyday style — sizes 6 to 22." This helps the AI stay on-topic and gives it quick context for ambiguous questions.
• Store URL: Your live storefront URL (auto-filled from WordPress settings, but verify it is correct).
• 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 30 days of purchase. Items must be unworn with tags attached. Refunds are processed within 5 business days to the original payment method."
• Shipping Policy: Delivery timelines, carriers used, free shipping threshold, international shipping availability. Example: "Free standard shipping on all orders over ₹1,500. Express delivery available. We ship to India and 15 international destinations."
• 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: Lila for a fashion boutique, 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: Specify your currency symbol and 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 plugin)
  • State unavailability only — does not recommend alternatives
• Scope Boundary: Define what happens when a customer asks a question completely outside your store's scope (e.g., general advice not related to your products). 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 offer gift wrapping?"
3. In the Answer field, write the full, customer-facing answer. Example: "Yes! We offer complimentary gift wrapping on all orders. Simply select 'Gift Wrap' at checkout and leave a personalised message in the order notes."
4. Add synonyms or alternate phrasings in the Trigger Phrases field to help the AI recognise variations of the same question: "gift wrap, gift packaging, gift option, wrapped present".
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 in chat sessions that referenced a product found in your synced catalogue. A low score indicates your catalogue sync may be failing or your product descriptions are too thin for the AI to match queries accurately.
• Chat-Assisted Add to Cart (Pro): When WooCommerce event tracking is enabled, this metric shows how many cart additions occurred within 10 minutes of a chat session — a strong proxy for assisted conversions.
• Chat-Assisted Revenue (Pro): Estimated revenue attributable to orders placed within a configurable attribution window (default: 30 minutes) after a chat session. This is the headline metric for measuring AI chat ROI.

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) and the page filter to segment performance by where on your site conversations are starting. You may find that product page conversations have a higher resolution rate than homepage conversations — useful insight for deciding where to prioritise the chat widget.

Exporting Data

Click Export CSV on any analytics table to download the full dataset for use in your own spreadsheets or reporting tools. The conversation log export includes anonymised session IDs, timestamps, message counts, outcomes, and products referenced — no personally identifiable customer data is included in exports.

---

Getting the Most from EcomAiBridge — Summary Checklist

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

• ☑ Plugin installed and activated with WooCommerce running
• ☑ AI provider connected and connection test passed
• ☑ First catalogue sync completed successfully
• ☑ 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 setup 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 WordPress Plugin page
• If you are running a custom PHP or non-WordPress store, explore the EcomAiBridge Standalone Middleware for a platform-agnostic installation path
• 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 plugin updated to access the latest improvements.