Vectralix PRO – Documentation
Official Documentation v1.0

Vectralix PRO Docs

Welcome to the official documentation for Vectralix AI Chat PRO. This guide will walk you through configuring your AI agent, setting up Pinecone Vector DB, and maximizing your store’s revenue through automated cart recovery.

Important Note: Ensure you have activated your License Key in the WP Admin > Vectralix > License menu before configuring these settings. Without an active license, the AI chat will not process visitor messages.

2. Appearance & Display Targeting

Vectralix allows you to perfectly match the chat widget to your brand’s identity and control exactly where it appears.

Advanced Appearance

  • Custom Icons: Choose from predefined icons (AI Robot, CS Support) or upload a Custom URL. Check “Make outer button background transparent” if using a custom PNG logo.
  • Colors & Fonts: Fully customize the Button BG, Tooltip Label, User Bubble, and AI Bubble colors. Select your preferred Font Family and Size for maximum readability.
  • Responsive Offsets: Prevent the widget from blocking your “Add to Cart” buttons. You can set specific Bottom and Right margins independently for Desktop, Tablet, and Mobile devices.
  • Audio & Tooltip: Enable new message sounds and set a Tooltip Delay (in seconds) to automatically greet passive visitors.

Position & Targeting

Use the Display Targeting rules to determine where the AI operates. You can enable it on All Pages, Homepage Only, or Specific URLs (e.g., only on `/checkout/` or `/shop/`).

3. Pre-Chat Form (Lead Generation)

Capture valuable visitor data before they even speak to the AI. This is crucial for building your contact list and enabling Cart Recovery.

  • WhatsApp Number: Captured by default to ensure you have a direct line to your leads.
  • Require Email (Optional): Check this box if you want to run dual-channel marketing (Email + WhatsApp) for abandoned carts.
  • Customize the Greeting Title, Description, and Start Button text to fit your local language.

4. AI Engines & Active Failsafe

Vectralix PRO features an enterprise-grade failover system to ensure your chatbot never goes offline.

Primary vs. Silent Fallback

Connect your preferred provider (Groq, OpenAI, Gemini, or DeepSeek) as the Primary Engine. Then, set a completely different provider as the Silent Fallback Engine.

If your Primary Engine hits a rate limit (Error 429) or goes offline, Vectralix will instantly reroute the visitor’s query to the Fallback Engine in milliseconds—with zero disruption to the user experience.

System Instructions (Prompt)

The System Prompt is the “brain and personality” of your AI. Use it to set strict behavioral guidelines.

// Example Prompt Structure [IDENTITY] You are the Virtual Assistant for my store. Be polite and concise.[ANTI-HALLUCINATION RULE] ONLY list products returned by the database. NEVER invent brands.CRITICAL RULE FOR ESCALATION: If the user asks for a human, append this code at the end: [ESCALATE_TO_HUMAN]

5. Universal Hybrid RAG & Pinecone DB

Stop standard AI hallucinations. Hybrid RAG allows your AI to read your actual website content and WooCommerce products using Semantic Vector Search.

Step-by-Step Pinecone Setup

  1. Enable Use Hybrid RAG (SQL + Pinecone) in the settings.
  2. Select your Embedding Engine (e.g., text-embedding-3-small for OpenAI).
  3. Enter your Pinecone API Key and Index Host URL.
  4. In the Sync Data Sources section, select which content to index (Products, Posts, Pages, PDFs).
  5. Click the Sync Content/Catalog to Vector DB button. Wait until the progress reaches 100%.
Critical Warning: If you ever change your Embedding Provider (e.g., switching from OpenAI to Gemini), you MUST delete your current Pinecone index on the Pinecone dashboard and create a new one with the matching dimension size.

6. Abandoned Cart Recovery

Turn missed opportunities into revenue. Vectralix monitors when an AI generates a smart-checkout link but the user doesn’t complete the purchase.

  • Multi-Channel Recovery: Send reminders via Email (SMTP) and WhatsApp (via Fonnte/Wati Gateway).
  • Dynamic Variables: Use {name} to output the visitor’s name and {cart_items} to list their abandoned products along with exact prices and direct links.
  • Smart 1-Hour Delay: The system intelligently waits exactly 1 hour (3600 seconds) after the cart is abandoned before sending the first reminder, ensuring we don’t spam active buyers.
  • Max Attempts: Set how many automated 1-hour follow-ups should be sent before the system permanently closes the session queue.

7. Omnichannel Telegram Handover

Take over the chat manually whenever an AI cannot resolve an issue or a user requests human assistance.

  1. Create a Telegram Bot via BotFather and retrieve your Bot Token.
  2. Add the Bot to a private Telegram Group and extract the Group ID (including the minus sign, e.g., -100123456).
  3. Toggle the Master Agent Switch to “AGENTS ARE ONLINE”.

When the AI triggers [ESCALATE_TO_HUMAN], the chat is forwarded to your Telegram group. Simply Reply to that message in Telegram, and your text will appear instantly in the visitor’s website chat widget!

8. Analytics & Live Agent Console

Vectralix tracks every interaction. Access your data directly from the WordPress Admin.

  • Unique Contacts (Leads): View all captured visitors (Name, WA Number, Email, Join Date). You can delete invalid leads or click Download CSV to export them to your CRM.
  • Chat History Logs: Review the exact transcripts of what customers are asking the AI to refine your System Prompt.
  • System Alerts: Input your Admin Email and WA Number to receive instant ping alerts if both Primary and Fallback engines fail simultaneously.
Chat With Us
Salin Kutipan 📋