Qonvor logoQonvor.com

Documentation

Everything you need to get started with Chat Assist for WooCommerce.

Getting Started

What is Chat Assist?

Chat Assist for WooCommerce adds an intelligent chat widget to your online store. Customers can search for products, ask about shipping and returns, get cart help, and even talk to your store using voice — all without leaving the page they are on.

The plugin works in two modes:

  • Free Mode — A built-in rules-based chat that runs entirely on your WordPress site. No external service needed. Customers can search products, browse categories, and get answers from your FAQs and store policies.
  • AI Mode — Connect to the Qonvor backend for natural language understanding, context-aware product recommendations, and real-time voice chat. Available on paid plans.

Requirements

  • WordPress 6.0 or higher
  • WooCommerce 7.0 or higher
  • PHP 7.4 or higher
  • An active WooCommerce store with published products

Installation

  1. Download the Chat Assist for WooCommerce plugin from your Qonvor dashboard.
  2. Go to Plugins → Add New → Upload Plugin in your WordPress admin.
  3. Upload the .zip file and click Install Now.
  4. Click Activate.
  5. Navigate to Chat Assist in your admin sidebar to begin setup.

Quick Setup (5 Minutes)

  1. Enable the widget — Go to Chat Assist → General and check "Auto-inject Widget". This displays the chat on every page. Alternatively, use the [chat_assist] shortcode or the Chat Assist Gutenberg block on specific pages.
  2. Set up Free Chat — Go to Chat Assist → Free Chat. Add custom FAQs, select knowledge pages (like your Shipping or Returns page), and enter a brief store policy summary.
  3. Customize appearance — Go to Chat Assist → Appearance. Pick a primary color that matches your brand.
  4. Connect AI (optional) — If you have a paid plan, go to Chat Assist → Backend Connection. Enter your Backend URL and Site Token from your Qonvor dashboard.

Features

Free Chat (Built-in)

The free chat works out of the box with zero configuration. It uses keyword matching and rules to handle common customer questions.

What it can do:

  • Search your WooCommerce products by name, category, or keyword
  • Show product cards with images, prices, and links
  • Answer questions about the product the customer is currently viewing
  • Display cart contents and totals
  • Respond with your store's shipping, return, and payment policies
  • Match custom FAQs you configure in the admin

AI Text Chat (Starter, Business, Pro)

AI text chat connects to the Qonvor backend for real conversational ability. The AI understands the customer's intent, remembers the conversation context, and can handle complex product queries.

  • Natural language understanding
  • Context awareness — the AI knows which product or category the customer is viewing
  • Product recommendations based on the customer's needs
  • Multi-turn conversations with memory
  • Smart fallback to free chat if AI quota is exhausted

AI Voice Chat (Business, Pro)

Voice chat is the standout feature of Chat Assist. Customers click the microphone button and speak naturally. The AI responds with a human-like voice in real-time.

Powered by Deepgram Nova-3 for speech recognition and Aura-2 for text-to-speech. Nova-3 provides real-time multilingual transcription, so the system automatically detects which language the customer is speaking.

Voice settings you can customize:

  • Accent — Australian, British, or American English
  • Voice style — Warm & Friendly, Professional, or Gentle
  • Voice gender — Female or Male
  • Languages — English (all plans), German/French/Spanish (Business), Italian/Dutch/Japanese (Pro)

Each language has its own set of natural-sounding voices. For example, German offers three female voices (Aurelia, Elara, Lara) and Spanish offers six voices across both genders. The voice is selected based on your style and gender settings in the admin panel.

Knowledge Base (Starter, Business, Pro)

Upload PDF or CSV files to give the AI additional knowledge about your business — product specifications, warranty documents, size guides, or detailed company policies.

Configuration

Backend Connection

To use AI features, connect to the Qonvor backend:

  1. Sign up at qonvor.com/signup and choose a plan.
  2. Copy your Backend URL and Site Token from your confirmation email.
  3. Paste them into Chat Assist → Backend Connection in your WordPress admin.
  4. Click Test Connection to verify.

Free Chat Setup

Go to Chat Assist → Free Chat to configure the rules-based chat:

  • Include Pages — Select WordPress pages whose content the chat can reference (e.g., Shipping Policy, Returns, About Us, FAQ).
  • Custom FAQs — Add question/answer pairs the chat can match against.
  • Store Policies — Enter a brief summary of your key policies for shipping, return, and payment questions.

Embedding the Widget

  • Auto-inject (Recommended) — Enable "Auto-inject Widget" in General Settings. The chat widget appears on every page.
  • Shortcode — Place [chat_assist] on specific pages or posts.
  • Gutenberg Block — Search for "Chat Assist" in the block inserter.

Troubleshooting

Chat widget does not appear

  1. Check that "Auto-inject Widget" is enabled in General Settings.
  2. If using a shortcode or block, ensure it is placed on a published page.
  3. Check for JavaScript errors in your browser console (F12 → Console tab).
  4. Verify WooCommerce is active — the plugin requires WooCommerce.

AI features not working

  1. Go to Backend Connection and click "Test Connection".
  2. Verify your Backend URL starts with https:// and has no trailing slash.
  3. Confirm your Site Token is correct (copy it fresh from your confirmation email).
  4. Check that your plan is set correctly in General Settings.

Voice chat not available

  1. Voice chat requires a Business or Pro plan.
  2. Ensure your browser allows microphone access (check the address bar for the mic icon).
  3. Voice chat requires HTTPS — it will not work on http:// sites.
  4. Check your quota in AI Features → Current Usage.

Widget overlaps other elements

Adjust the widget position in General Settings (bottom-right, bottom-left) or add custom CSS:

#wca-chat-widget {
    bottom: 80px !important;
    right: 20px !important;
}

Support

Need more help? Contact us at support@qonvor.com.