Vatdi Documentation

Vatdi AI Chatbot is a powerful AI-powered customer support solution that works 24/7 on your website. It can answer customer questions, track orders, capture leads, and seamlessly hand over to human agents when needed.

What You Can Do With Vatdi

Quick Setup

Get your AI chatbot running in 5 minutes:

Supported Platforms

Vatdi integrates with major ecommerce platforms and any custom website.

WordPress & WooCommerce

Installation

Install directly from the official WordPress plugin repository with one click:

Option 1: Install from WordPress Admin (Recommended)

1. Go to WordPress Admin → Plugins → Add New
2. Search for "Vatdi AI Chat Agent"
3. Click Install Now
4. Click Activate

Option 2: Manual Installation

1. Download from WordPress.org
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload the zip file and click Install Now
4. Click Activate Plugin

One-Button Connect

Our WordPress plugin uses a seamless OAuth-style connection flow - no API keys to copy!

1. Go to Vatdi AI Chat in your WordPress admin menu
2. Click the "Connect to Vatdi" button
3. Log in to your Vatdi account (or create one)
4. You'll be automatically redirected back with the connection complete

WooCommerce Product Sync

If WooCommerce is installed, the plugin automatically syncs:

• All published products with descriptions, prices, and images
• Product categories and tags
• Product attributes and variations
• Product reviews and ratings
• Shipping methods and zones

Disconnecting

1. Go to Vatdi AI Chat → Settings
2. Click "Disconnect"
3. Confirm the disconnection

OpenCart Integration

We provide extensions for both OpenCart 3.x and 4.x with automatic product sync and order tracking.

OpenCart 4.x Installation

1. Download vatdi.ocmod.zip from OpenCart Marketplace or your Vatdi dashboard
2. Go to OpenCart Admin → Extensions → Installer
3. Click Upload and select the zip file
4. Go to Extensions → Extensions
5. Filter by Modules
6. Find Vatdi AI Chatbot and click Install
7. Click Edit to configure

OpenCart 3.x Installation

1. Download Vatdi-AI-Agent-OC-3x.ocmod.zip from OpenCart Marketplace or your Vatdi dashboard
2. Go to OpenCart Admin → Extensions → Installer
3. Upload the zip file
4. Go to Extensions → Modifications and click Refresh
5. Go to Extensions → Extensions → Modules
6. Find Vatdi AI Chat Agent and install it

One-Button Connect

1. Open the Vatdi module settings in OpenCart admin
2. Click "Connect to Vatdi"
3. Log in to your Vatdi account
4. You'll be redirected back with credentials automatically saved

What Gets Synced

• Products: Name, description, price, stock, images, attributes, options
• Categories: Full category tree with descriptions
• Manufacturers: Brand names and logos
• Information Pages: About Us, Terms, Privacy, etc.
• Shipping Methods: Available shipping options

Order Tracking

Customers can check their order status directly in the chat. The AI will:

• Ask for order ID and email for verification
• Display order status, items, and shipping info
• Show order history and tracking updates

Script Embed

Add the Vatdi chat widget to any website by pasting this code before the closing </body> tag:

<!--Start of Vatdi | AI Chat Agent Widget-->
<script type="text/javascript">
var VatdiWidget=VatdiWidget||{}, VatdiWidgetLoadStart=new Date();
(function(){
    var s1=document.createElement("script"),s0=document.getElementsByTagName("script")[0];
    s1.async=true;
    s1.src='https://vatdi.com/widget-loader.js';
    s1.charset='UTF-8';
    s1.setAttribute('crossorigin','*');
    s1.setAttribute('data-store-key','YOUR_STORE_KEY');
    s1.setAttribute('data-api-url','https://vatdi.com');
    s0.parentNode.insertBefore(s1,s0);
})();
</script>
<!--End of Vatdi | AI Chat Agent Widget-->

Configuration Options

Training Your AI

Vatdi uses RAG (Retrieval Augmented Generation) to learn from your content. The more you train it, the better it answers customer questions.

Training Methods

Best Practices

Processing Status

Widget Customization

Customize every aspect of the chat widget to match your brand identity.

Chat Button Settings

• Position: Bottom-right, bottom-left, or custom margins
• Style: Icon-only or bubble with text
• Size: Small, medium, or large
• Animation: Pulse, bounce, or none
• Colors: Solid or gradient with custom colors
• Custom Icon: Upload your own icon or avatar

Chat Window Settings

• Header: Logo, agent name, and tagline
• Colors: Header background, message bubbles, accents
• Fonts: Choose from 15+ Google Fonts
• Welcome Message: Greeting shown when chat opens
• Preset Questions: Quick-start buttons for common queries

Pre-Chat Form

Collect visitor information before the chat starts:

• Name, email, phone (toggleable fields)
• Subject and message
• Company name (for B2B)

AI Behavior Settings

Fine-tune how your AI assistant responds to customers.

Tone & Style

• Tone: Friendly, Professional, Casual, or Formal
• Response Length: Brief, Standard, or Detailed
• Emoji Usage: None, Few, Moderate, or Lots
• Primary Language: Set default language for responses

E-commerce Settings

• Product Suggestions: How many products to recommend (1-5)
• Show Out-of-Stock: Include unavailable products or not
• Order Tracking: Enable customers to check order status
• Show Prices: Display product prices in responses
• Show Images: Include product images in responses

Coupon & Promotions

• Enable coupon offers during conversations
• Set custom coupon codes
• Customize the offer message

Human Handover

• Set agent availability hours per day
• Configure timezone
• Customize handover messages

Dashboard Overview

Your command center with real-time metrics and management tools.

Main Dashboard

• Total conversations (today, this month, all-time)
• Leads captured and qualified
• 7-day trend charts for conversations and leads
• Recent activity feed

Conversations

View and manage all customer conversations:

• Filter by status: AI chat, live agent, ended
• Search by visitor ID, session, or domain
• View full conversation transcripts
• Export conversations to CSV

Leads Management

Manage captured leads:

• View all lead submissions with details
• Rate and qualify leads (1-5 stars)
• Trust score calculation
• Export leads to CSV

Analytics

Gain insights into AI performance:

• Chat volume over time
• AI accuracy and ratings
• Top questions asked
• Missed questions (AI couldn't answer)
• Response time metrics

REST API

For developers and custom integrations.

Authentication

All API requests require authentication via headers:

X-Store-Key: your_store_key
X-Store-Secret: your_store_secret

Endpoints

Knowledge Sync

Store Management

Webhooks

Receive real-time notifications for events in your Vatdi account.

Frequently Asked Questions

Getting Help