Documentation

Installation

Getting Fab AI Assistant up and running on your WordPress site takes just a few minutes. Follow these steps to install and activate the plugin.

1. Download the plugin from our website or receive it via email after registering for a free trial.
2. In your WordPress Dashboard, go to Plugins → Add New → Upload Plugin.
3. Click "Choose File" and select the fab-ai-assistant.zip file you downloaded.
4. Click "Install Now" and wait for the installation to complete.
5. Click "Activate Plugin" to enable Fab AI Assistant on your site.

Once activated, a new "Fab AI Assistant" menu item will appear in your WordPress admin sidebar. Click on it to open the plugin dashboard and begin setup.

API Key Setup

Your API key connects your WordPress site to the Fab AI Assistant backend. Without it, the plugin cannot communicate with the AI engine.

1. Navigate to Fab AI Assistant → Settings in your WordPress admin.
2. Enter your API Key in the designated field. You received this key via email after registering for a trial or purchasing a plan.
3. Click "Save" to store your key.
4. Click "Test Connection" to verify that the plugin can reach the backend.
5. A green checkmark confirms a successful connection. If you see a red error, double-check that the key is entered correctly and that your server can make outbound HTTPS requests.

First Steps

After connecting your API key, follow these steps to get your AI assistant up and running.

• Crawl your content — Go to the Knowledge Base tab and click "Crawl Now" to scan your website content (pages, posts, and product descriptions). The process typically completes within a few minutes.
• AI learning — As content is crawled, it is processed, embedded, and stored in the knowledge base. The AI uses this data to answer visitor questions accurately.
• Widget appears — After crawling, the chat widget appears on your website's frontend. Visitors can start chatting with the AI right away.
• Test it yourself — Visit your website's frontend and try asking the AI questions about your business, products, or services. This helps you verify that the AI is responding correctly.
• Customize the widget — Head to the Appearance tab in the plugin dashboard to customize colors, position, welcome messages, and more to match your brand.

Conversations

The Conversations tab gives you full visibility into every interaction between your visitors and the AI assistant. Use it to monitor quality, understand visitor needs, and identify areas for improvement.

• View all conversations — See a chronological list of all visitor conversations, sorted by most recent first.
• Search and filter — Search conversations by visitor name, email, or keywords. Filter by date range or conversation status.
• Full message history — Click any conversation to see the complete message exchange between the visitor and the AI, including timestamps for each message.
• Visitor information — Each conversation displays the visitor's name (if provided), email, language, message count, and the page they were on when they started chatting.
• Satisfaction ratings — If satisfaction rating is enabled, you can see whether visitors rated the AI's responses positively or negatively.
• Delete conversations — Remove old or irrelevant conversations to keep your dashboard clean and organized.

Knowledge Base

The Knowledge Base is the foundation of your AI assistant. It contains all the information the AI uses to answer visitor questions. The more comprehensive and accurate your knowledge base, the better the AI performs.

Auto Crawl

The plugin automatically crawls your website to keep the knowledge base up to date.

• Scheduled crawling — Choose how often the plugin crawls your site: every 12 hours, daily, every 3 days, or weekly.
• Manual trigger — Click "Crawl Now" to trigger an immediate crawl whenever you have updated your website content.
• Crawl status — View detailed statistics including: last crawl date, total pages found, pages excluded by rules, and knowledge base entries created.
• Content types — The crawler processes pages, posts, and custom post types. WooCommerce products are handled separately by the E-shop module.

Manual Entries

Add custom knowledge entries that are not available on your website but that the AI should know about.

• Click "Add Entry" in the Knowledge Base tab.
• Fill in the title, content, language, and optionally a category.
• Use manual entries for: internal policies, special instructions, seasonal announcements, or any information the AI should reference that isn't published on your site.

CSV Import

Import multiple knowledge base entries at once using a CSV file.

• Prepare a CSV file with the following columns: title, content, language, category.
• Click "Import CSV" and upload your file.
• The plugin will process each row and create a knowledge base entry for it.
• This is especially useful for bulk-importing FAQs, product specifications, or documentation.

Exclusion Rules

Control which pages the crawler should skip to keep your knowledge base clean and relevant.

• Exclude by slug — Enter page slugs separated by commas (e.g., privacy-policy, terms-of-service).
• Exclude post types — Skip certain post types entirely (e.g., revision, attachment).
• Exclude by keywords — Skip pages whose title or content contains specific keywords.
• Automatic exclusions — Shop, cart, checkout, and my-account pages are excluded automatically to avoid irrelevant content in the knowledge base.

Widget Customization

Make the chat widget look and feel like a natural part of your website. Customize every visual aspect from colors to messages to match your brand identity.

Appearance & Colors

• Header color — The primary color used in the widget header and action buttons. Choose a color that matches your brand.
• Header text color — Set the text color for the header area (typically white or dark, depending on your header color).
• Bot message bubble color — Background color for messages from the AI assistant.
• User message bubble color — Background color for messages from the visitor.
• Button accent colors — Colors for action buttons like "Send", quick replies, and product cards.

Position & Layout

• Widget position — Choose where the widget appears: bottom-right (default), bottom-left, top-right, or top-left.
• Custom trigger button image — Replace the default chat icon with your own image by entering a URL.
• Custom trigger button text — Add text next to the trigger button (e.g., "Chat with us").
• Avatar image — Set a custom avatar URL that appears in the widget header.

Welcome Message

• Greeting text — Set the welcome message visitors see when they open the chat. Supports all languages.
• Input placeholder — Customize the placeholder text in the message input field for each language.
• Business name — The name displayed in the widget header (e.g., "Acme Support").
• Offline message — Optionally display a message when your business is outside operating hours.

Quick Replies

• Add predefined quick reply buttons that appear below the welcome message in the chat widget.
• Visitors can click these buttons to instantly send a pre-set message, making it easy to start a conversation.
• Great for common questions like: "What are your hours?", "Where are you located?", "Do you offer free shipping?"
• Quick replies can be configured per language.

Display Mode

• Auto (all pages) — The widget appears on every page of your website automatically. This is the default and recommended setting.
• Shortcode only — Use the shortcode [fab_ai_assistant] to place the widget on specific pages only. Useful if you want the AI assistant on selected landing pages rather than the entire site.

Engagement Features

Increase visitor interaction with your AI assistant using proactive engagement tools. These features help draw attention to the chat widget and encourage visitors to start a conversation.

Proactive Message

A tooltip bubble appears near the chat button after a configurable delay, inviting visitors to chat.

• Custom message — Set the message text in multiple languages (EN and EL).
• Delay — Configure how many seconds after page load the bubble appears (e.g., 10 seconds).
• Sound notification — A subtle notification sound plays when the bubble appears, drawing the visitor's attention.
• Session-aware — The bubble is dismissed per session, so it won't annoy returning visitors who have already dismissed it or started chatting.

Notification Badge

A red notification badge with the number "1" appears on the chat button, signaling to visitors that there is a message waiting.

• Draws attention to the chat widget without being intrusive.
• Automatically hidden when the visitor opens the chat.
• Enable or disable in the Appearance settings.

Satisfaction Rating

Allow visitors to rate the AI's responses with thumbs up or thumbs down buttons.

• Rating buttons appear after each AI response.
• Track overall satisfaction in the Analytics dashboard.
• Negative ratings automatically feed into the Unanswered Questions tab, helping you identify responses that need improvement.
• Enable or disable per widget in the settings.

Analytics

The Analytics dashboard provides comprehensive insights into how visitors interact with your AI assistant. Use these metrics to measure performance, identify trends, and optimize your knowledge base.

• Overview cards — At-a-glance metrics including today's conversations, monthly conversations, total leads captured, and handoff rate.
• Daily conversations chart — A line chart showing conversation volume over the last 30 days, with comparison to the previous month for trend analysis.
• Language distribution — A pie chart showing which languages your visitors use most frequently.
• Peak hours & busiest days — Bar charts revealing when your visitors are most active, helping you plan staffing and support coverage.
• Popular questions — A list of the most frequently asked topics, generated using semantic clustering of visitor queries.
• Lead intent breakdown — Categorization of detected intents (booking, complaint, information, question) to understand what visitors want.
• Average similarity score — A RAG quality indicator showing how well your knowledge base matches visitor questions. Higher scores mean more accurate answers.
• Bounce rate & conversation duration — Metrics on how long conversations last and how often visitors leave without completing a conversation.

Notifications

Stay informed about important events happening in your AI assistant. Receive real-time notifications via email or Telegram whenever a lead is captured, a handoff is requested, or stock alerts are triggered.

Email Notifications

• Lead capture alerts — Get notified immediately when a visitor submits their contact information through the chat.
• Handoff requests — Receive an alert when a visitor requests to speak with a human agent.
• Stock notifications — For WooCommerce stores, get notified when visitors ask about out-of-stock products.
• Custom email address — Set a specific email address for notifications, or use your default WordPress admin email.

Telegram Notifications

Connect a Telegram bot for instant, mobile-friendly notifications.

• Enter your Telegram bot token in the notification settings.
• Click "Verify" to confirm the connection.
• Send a test message to make sure notifications are working correctly.
• Supports the same triggers as email: leads, handoffs, and stock alerts.

Lead Capture

Fab AI Assistant automatically identifies visitors who show contact intent and prompts them to share their information. This happens naturally within the conversation flow, without disrupting the experience.

• Automatic detection — After 4 or more messages, the AI analyzes the conversation for contact intent (e.g., "I'd like a quote", "Can you call me?", "I want to book").
• Lead form — When intent is detected, a subtle lead form appears within the chat, asking for the visitor's name and phone number.
• Leads tab — All captured leads are listed in the Leads section of the plugin dashboard, with name, phone, intent, and timestamp.
• Opt-out option — A "No thanks" option is always available for visitors who prefer not to share their information.
• Once per conversation — The lead form is shown at most once per conversation to avoid being intrusive.
• Multilingual detection — Contact intent is detected in all languages.

E-shop / WooCommerce PRO

The E-shop module supercharges your WooCommerce store with AI-powered product discovery. Visitors can describe what they are looking for in natural language and instantly find the right products.

Setup

• Navigate to the WooCommerce tab in the plugin dashboard.
• Enter your WooCommerce REST API consumer key and consumer secret.
• These credentials are generated in WooCommerce → Settings → Advanced → REST API. Create a new key with "Read" permissions.
• Set a sync interval: every 10 minutes, every 2 hours, daily, every 3 days, or weekly.

Product Sync

• Click "Sync Products Now" for an immediate synchronization of your product catalog.
• Products are synced in batches of 100 for reliability and performance.
• A progress bar shows real-time sync status, including the number of products processed.
• Supports catalogs with 20,000+ products with automatic memory management.
• Extracted data includes: name, description, price, sale price, stock status, variations, images, categories, attributes, and tags.
• Retry logic: if a batch fails, the plugin retries up to 3 times with increasing delays (5s, 15s, 30s).

Features

• Semantic product search — Visitors describe what they want in natural language ("I'm looking for a modern grey sofa for a small living room") and the AI finds matching products using vector similarity search.
• Product cards — Results appear as rich cards in the chat with product image, name, price, stock status, and "View" and "Add to Cart" buttons.
• Stock awareness — The AI knows what's in stock and can proactively suggest alternatives when a requested product is unavailable.
• Discount Rules integration — Automatically calculates discounted prices from the Flycart "Discount Rules for WooCommerce" plugin. The AI shows both the original and discounted price.
• Out-of-stock filtering — Optionally skip out-of-stock products during sync to keep the knowledge base focused on available items.
• WPML support — Products are synced in all active WPML languages, so visitors get results in their preferred language.

Hotel Concierge PRO

Transform your website into a 24/7 virtual concierge. The Hotel module gives the AI real-time knowledge about weather, nearby places, room availability, and travel logistics — everything a guest needs before and during their stay.

Location Setup

• Set your hotel's coordinates (latitude and longitude) and city name in the Hotel tab.
• Choose a weather provider: OpenWeatherMap (requires an API key) or Open-Meteo (free, no key required).
• The location data is used for weather forecasts, nearby place searches, and distance calculations.

Weather & 15-Day Forecast

The AI answers weather-related questions with real-time data, helping guests plan their activities.

• Current conditions — Temperature, humidity, wind speed, and "feels like" temperature.
• 15-day forecast — Daily highs and lows with weather descriptions.
• Seasonal suggestions — The AI recommends activities based on the season and current weather (beaches in summer, hiking in spring, indoor activities during rain).

Nearby Places & Attractions

The AI provides personalized recommendations for dining, entertainment, and sightseeing near your hotel.

• Powered by Google Places data for accurate, up-to-date information.
• Guests receive recommendations with ratings, addresses, and price levels.
• 6 categories supported: restaurants, beaches, museums, bars, cafes, and tourist attractions.
• Results are tailored to your hotel's specific location.

Room Availability

• Connect your availability feed from Booking.com, Airbnb, or a custom source.
• The AI checks real-time room availability for the dates requested by the guest.
• Displays available room types, prices per night, and total cost.
• Guests see accurate pricing instantly without leaving the chat.

Booking Requests

• The AI guides guests through the booking request process directly in the chat.
• Collects: name, contact details, and preferred dates.
• The request is submitted to your team for confirmation.
• Clear distinction: the AI says "request submitted" rather than "booked" — your team always has the final say.

Transfer Arrangements

• Guests can request airport or port transfers via the chat.
• The AI collects: arrival date, time, number of guests, and flight or ferry number.
• The request is forwarded to your front desk for processing.

Travel Itineraries

• Guests ask questions like "We're staying 5 days, what should we do?"
• The AI builds day-by-day plans based on the season, current weather, and local attractions.
• Personalized recommendations include restaurants, activities, beaches, and cultural sites.

Distance & Directions

• "How far is the airport?" — The AI responds with driving distance and estimated time.
• Public transport directions with bus lines, metro stops, and walking segments.
• Powered by Google Maps real-time data for accurate, up-to-date travel information.

AI Vision PRO

AI Vision brings product visualization into the chat experience. Visitors upload a photo of their space — a room, a selfie, or any environment — and the AI generates a realistic rendering showing how your products would look in that setting.

Overview

• AI-powered product visualization — Guests upload a photo and see your products placed in their space with photorealistic quality.
• Multiple modes — Furniture (room visualization), fashion (virtual try-on), jewelry, and a generic mode for other product types.
• Rate limited — 3 renders per day per user to manage costs and prevent abuse.
• Watermarked output — Generated images include your business logo as a watermark for brand reinforcement.

Provider Setup

• Choose between two AI providers: Gemini (Google) or FLUX.2 Pro (Black Forest Labs).
• FLUX offers significantly higher quality for room visualizations and is the recommended provider.
• Custom API keys — If your plan supports it, you can use your own provider API key for direct billing. When using your own key, renders are tracked but incur no platform charges.

Vision in Chat

• A camera button appears in the chat widget header when AI Vision is enabled.
• The guest uploads a room photo (or selfie for fashion mode), then selects a product to visualize.
• The AI generates the visualization and displays the result directly in the chat, complete with a lightbox for full-size viewing.
• Results persist across page navigation via session storage.

Product Page Button (WooCommerce)

• A configurable "Visualize this product" button can be added to WooCommerce product pages.
• Clicking the button opens the chat widget and starts the vision flow for that specific product.
• Fully customizable: color, text color, font size, and border radius.
• Button placement: above or below the "Add to Cart" button.
• Button text automatically adapts to the vision mode (e.g., "See it in your room" for furniture, "Try it on" for fashion).

FAQ Management PRO

FAQ Management lets you create precise question-and-answer pairs to train the AI. This is the most direct way to control how the AI responds to specific topics.

• Create Q&A pairs — Write a question and its ideal answer. The AI will use this as a reference when visitors ask similar questions.
• Semantic matching — Questions are embedded for semantic similarity search. The AI does not require an exact match — it understands meaning and variations.
• Precise responses — FAQ entries take priority in the AI's response generation, ensuring controlled and accurate answers for important topics.
• Full CRUD — Add, edit, and delete FAQ entries at any time.
• Multi-language support — Create FAQ entries in multiple languages to serve international visitors.

Corrections PRO

When the AI gives an incorrect or suboptimal response, you can correct it. Corrections feed directly back into the knowledge base, improving future responses.

• Review AI responses — Browse conversations and identify responses that need improvement.
• Submit corrections — Write the correct answer for a specific question. The correction is stored and linked to the original conversation.
• Continuous learning — The AI references corrections when answering similar questions in the future, providing increasingly accurate responses over time.
• Linked history — Each correction is linked to the original conversation and message, so you can always trace why a correction was made.

Lead Management PRO

The Lead Management tab gives you a centralized view of all leads captured through the AI assistant, with tools to track follow-ups and export data.

• Lead list — View all captured leads with name, email, phone, detected intent, and timestamp.
• Status tracking — Mark leads as "contacted" to track your follow-up progress.
• CSV export — Export your leads to a CSV file for use in CRM systems, email marketing tools, or spreadsheets.
• Filters — Filter leads by status: new, contacted, or all.
• Bulk actions — Select multiple leads to mark as contacted or delete in one action.
• Intent categories — Each lead shows the detected intent: booking, complaint, information request, or general question.

Unanswered Questions PRO

The Unanswered Questions tab helps you identify gaps in your knowledge base. It collects questions that the AI could not answer confidently, giving you clear direction on what content to add.

• Automatic collection — Questions with low similarity scores (below 0.3) are automatically flagged, as well as questions that received negative satisfaction ratings from visitors.
• Add answers — Write answers directly from this tab to improve the AI's knowledge base.
• Convert to FAQ — Turn unanswered questions into FAQ entries with one click, ensuring precise responses in the future.
• Knowledge base gaps — Use the unanswered questions list as a roadmap for improving your content. Recurring topics indicate areas where your knowledge base needs expansion.

White Label ENTERPRISE

White Label mode removes all Fab AI Assistant branding from the chat widget, making it appear as your own custom-built solution.

• No third-party attribution — The "Powered by Fab AI Assistant" text is completely removed from the widget.
• Your brand, your widget — Combined with custom colors, avatar, and business name, the widget becomes a seamless part of your brand experience.
• Perfect for agencies — Agencies and resellers can offer the AI assistant to their own clients without any reference to Fab AI Assistant.
• Enterprise-only — White Label is exclusively available on the Enterprise plan as a premium feature.