WordPress AI Agent Integration Guide
Complete technical reference for the BotVee WordPress Plugin (botvee-ai-agent). Learn how it operates, its core mechanics, and branding removal options.
1. What Does the BotVee Plugin Do? (Overview & Mechanics)
The BotVee WordPress Plugin (botvee-ai-agent) is a zero-code, one-click connector designed to link your WordPress site with your custom BotVee AI assistant. Instead of manually editing your website's header/footer code, this plugin automatically adds a premium, fully customized floating AI Agent widget to engage your visitors.
1Instant Floating AI Widget
Instantly loads a beautiful floating chat interface at the bottom corner of all your pages, welcoming visitors, answering questions, and collecting leads.
224/7 Smart Customer Engagement
Handles product inquiries, schedules client bookings, and collects real-time customer experience ratings automatically while keeping your brand active 24/7.
3WooCommerce & User Sync
Recognizes your logged-in users and syncs customer shopping history (orders and total spend) to give hyper-personalized responses.
4Lightning Fast & Non-Blocking
Loads completely asynchronously. The script only fires after your page structure is rendered, ensuring absolutely zero impact on page load speed.
5Typo-Tolerant AI Search
Automatically handles spelling mistakes and typos with an intelligent fuzzy search fallback when users query products or orders.
6Dynamic Pages Support
Dynamically fetches content from your standard WordPress pages (like Refund Policy, Terms, Contact) to answer user questions on the fly.
7Synced Product Catalog + Live Fallback
On connect, the plugin exports your full WooCommerce catalog to Botvee in gentle batches of 50 (via WP-Cron — your hosting is never strained), then instantly re-pushes any product whose price, stock, or details change. The AI answers product questions from this always-fresh mirror in milliseconds, with a live REST fallback for anything not yet synced. The plugin dashboard shows exactly how many of your products have transferred.
8Real-Time Order Tracking
Customers can securely track their own order status directly through the chat by providing an Order ID and associated billing email.
9Display Rules (Page Targeting)
Choose exactly where the AI Agent appears: every page, only selected pages, or everywhere except the pages you pick — plus one-click options to hide it on WooCommerce checkout and account pages.
10Activity Panel & Agent Health
See conversations, messages, and captured leads right inside wp-admin — and get warned instantly if your agent is untrained, paused, or was deleted on Botvee, so you always know why it might be silent.
11Cart Recovery & Browse Abandonment
Optional shopper tracking reports abandoned carts and product views to Botvee so recovery follow-ups can go out — and marks carts converted the moment checkout completes, so buyers never get a false reminder.
12Live Stock Alerts (Instant Restock Push)
The moment a product comes back in stock, the plugin pushes the restock to Botvee so waiting customers are notified immediately — and a dedicated stock endpoint double-checks real inventory first, so "back in stock" messages are only ever sent when it is actually true.
For Developers: Core Architecture & Code Mechanics
Under the hood, the plugin runs on optimized PHP execution parameters:
- Direct Footer Embedding: Automatically binds the script loading into the WordPress
wp_footeraction hook, enqueued async so it never blocks rendering. - Exclusions & Guards: Skip loading on administrative layouts (
is_admin()) and secure core pages likewp-login.phpto maintain dashboard isolation. - Regex Sanitization: Performs strict input sanitization on all stored AI Agent IDs utilizing
/^[a-zA-Z0-9_\-]1,128$/patterns to block potential security breaches. - Encrypted Credentials: The auth token and the WooCommerce proxy secret are stored AES-256 encrypted with HMAC integrity verification — never in plaintext — and both are wiped on disconnect and on uninstall.
- REST Proxy API: Registers
/wp-json/botvee/v1/endpoints for products, categories, orders, pages and live stock — each request authenticated against the shared secret with a timing-safe comparison. - Non-Blocking Telemetry: Shopper events (cart, product views) are sent with
blocking => false— a slow or unreachable API never delays your customer's page.
2. Installation & Smart Integrations (How to Setup)
A. The Purpose of Setup (Objective):
Connecting the plugin automates your visitor engagement. It automatically handles customer support, captures new leads, syncs live bookings, and answers inquiries without you having to write a single line of code.
B. Three Easy Steps to Activate (Setup):
- Download: Get your official plugin ZIP file from your BotVee Integrations tab.
- Upload & Activate: Go to your WordPress Admin Dashboard, click Plugins → Add New → Upload, select the ZIP file, and activate it.
- One-Click Connect: Simply click the "Connect" button. The plugin automatically authorizes your site and secures your JWT Auth Token using AES-256 encryption behind the scenes—no manual copy-pasting required!
C. Smart WooCommerce & User Sync:
Once activated, the plugin works behind the scenes to sync your customer profiles securely:
WP Profile Sync
Recognizes logged-in users and shares their name and email so the AI Agent can address them personally.
WooCommerce Integration
Syncs purchase history (order counts and total spent) so the AI acts as a smart ecommerce shopping assistant.
Shopper Activity Tracking (You Stay in Control)
Browse-abandonment and cart-recovery tracking can be switched on or off anytime from the plugin dashboard. Only shoppers who have shared an email or phone number are ever reported — anonymous visitors are never sent — and events are throttled so a page refresh never spams the API.
3. Smart Customer Feedback & Rating Triggers
To collect high-quality reviews without annoying your active website visitors, the plugin manages rating prompts using smart client-side rules:
No-Spam Session Guard
The system remembers if a customer has already given feedback during their visit. This completely stops duplicate or annoying popups when they browse different pages.
Smart Dismissal Retries
If a visitor closes the feedback popup, the system respects their choice and pauses the prompt, waiting for a gentle duration before suggesting it again.
Instant Exit Rating Trigger
The exact moment a visitor finishes the conversation and clicks "End Chat", the rating star dialogue opens instantly so you never miss out on valuable user feedback.
4. Branding Removal & Pro Plan Option
To keep a clean look and maintain your unique brand identity, BotVee allows you to remove the watermark footer from your chat widget.
| Feature | Free Plan | Pro Plan |
|---|---|---|
| Remove BotVee Watermark | Locked (Always Visible) | Unlocked (100% Hidden) |
Pro Plan Requirement
Branding removal is strictly restricted to active Pro Plan accounts. Once your plan is upgraded, simply go to your dashboard, navigate to Agent Settings → Pro Controls, and toggle the "Remove BotVee Branding" switch on to hide the watermark footer instantly.
Ready to connect?
Head over to the integrations panel to download the zip file.