IntelliAgent AI transforms your WordPress site into a powerful, 24/7 sales and support agent. But to unlock its full potential, a proper setup is crucial. This guide provides a step-by-step walkthrough of the entire configuration process, from license activation to customizing your AI’s unique persona, ensuring your new digital employee is ready to assist customers and drive revenue from day one.
Based on the official v1.6 documentation, we’ll cover the exact sequence required to get your AI assistant live in minutes, ensuring seamless integration with your website and WooCommerce store.
Table of Contents
- The Correct 4-Step Setup Sequence
- Common Setup Issues & Solutions
- Step 1: Activate Your IntelliAgent AI License
- Step 2: Configure Your AI Engine & API Keys
- Step 3: Sync Your Website and WooCommerce Store
- Step 4: Define Your AI’s Persona
- Fine-Tuning Your AI Agent: Advanced Settings
- Key Configuration Areas at a Glance
- Frequently Asked Questions
The Correct 4-Step Setup Sequence
A successful launch requires following a specific order of operations. IntelliAgent AI’s setup is designed to be logical, building from authentication to intelligence. For a smooth and error-free installation, you must complete these steps in the exact sequence listed below.
Mandatory Order: License Activation → AI Engine Configuration → Website & Store Sync → AI Persona.
Completing these four core steps will result in a fully functional AI agent. After this, you can move on to customizing its appearance, notifications, and other advanced features.
Common Setup Issues & Solutions
Even with a straightforward process, you might encounter an issue. Here are solutions to the most common setup problems:
- What if my license won’t activate? First, ensure there are no leading or trailing spaces when you paste the key. If it still fails, the issue could be a firewall on your server blocking outbound connections. You may need to ask your hosting provider to whitelist our licensing server.
- Why is the AI not responding after entering my API key? This typically means the API key is invalid or lacks sufficient funds in your provider account. Double-check the key in your AI provider’s dashboard (e.g., OpenAI, Google) and confirm that your billing information is active and up-to-date.
Step 1: Activate Your IntelliAgent AI License
Action: Activate your license key to unlock all Pro features and enable the AI engine.
License activation is the first and most critical step. Without an active license, the AI engine cannot operate. Navigate to the License tab in your WordPress dashboard to begin.
- Paste the license key you received after purchase into the designated field.
- Click the Activate License button to verify your ownership.
- A successful validation will display an “Active” status, confirming that all Pro features are unlocked.
Step 2: Configure Your AI Engine & API Keys
Action: Connect to your preferred Large Language Model (LLM) by entering its API key.
The AI Engine is the brain of your assistant. In the AI Engine tab, you can connect to the model that best fits your performance and cost requirements. An API key is like a secure password that allows IntelliAgent AI to communicate with your chosen AI provider.
This version supports several flagship models, including:
- Grok: For advanced reasoning and logic.
- OpenAI: Access to powerful GPT models.
- Gemini: Google’s high-performance AI.
Simply select your preferred provider and input your secure API key. This connection enables the real-time conversational reasoning your agent uses to answer questions and assist customers.
Step 3: Sync Your Website and WooCommerce Store
Action: Sync your website content and WooCommerce products to build the AI’s knowledge base.
Your AI agent’s knowledge comes directly from your website. The Website Sync tab is where you build its knowledge base by scanning and indexing your site’s content. The system uses WP-Cron (the standard WordPress system for running scheduled background tasks) to keep your AI’s knowledge automatically up-to-date.
The sync process includes:
- WooCommerce Products: Full integration allows the AI to recommend products, provide order tracking assistance, and facilitate sales.
- Pages and Posts: All your public content is indexed to answer general questions.
Step 4: Define Your AI’s Persona
Action: Define your AI’s personality and brand voice using a custom system prompt.
How your AI interacts with customers is just as important as the information it provides. In the AI Persona tab, you define its personality and tone. For a quick and effective start, use the “Auto-Generate from Website Content” button, which creates a custom persona that understands your brand voice.
Experienced developers often add negative constraints for better performance. For best results, instruct your AI on what *not* to do. For example, add the line: `Never make up product details or policies. If you don’t know the answer, direct the user to our support team.` This prevents hallucinations and builds trust.
By crafting a detailed system prompt, you instruct the AI on how to handle sales inquiries, support questions, and general conversation, making it a valuable extension of your team.
Fine-Tuning Your AI Agent: Advanced Settings
Once the core setup is complete, you can refine the agent’s functionality and appearance. These settings allow for deep customization to match your specific business needs.
Visual Appearance and Branding
Under the Style tab, you can customize the chat interface to perfectly match your brand. The live preview sidebar lets you see changes instantly. Options include light and dark modes, custom avatars, and primary brand colors for the chat bubbles.
Document Training for Deeper Knowledge
For information not on your public pages, use the Document Training feature to upload specialized files. For example, an electronics store could upload product specification PDFs. A user can then ask, `What is the battery life of the Model-T drone?`, and the AI will pull the precise answer from the uploaded document.
FAQ Management for Guaranteed Accuracy
The FAQ Management tab allows you to build a verified database for critical information. Use this to create canonical answers for policy questions. For instance, input a question `What is your return policy?` with the answer `We offer a 30-day return policy on all unopened products.` The AI will always prioritize this exact text, preventing any ambiguity or incorrect responses.
Key Configuration Areas at a Glance
Here is a quick summary of the primary setup tabs and their functions within IntelliAgent AI.
| Setting Area | Primary Function | Key Action |
|---|---|---|
| License | Unlocks Pro features and the AI engine. | Enter and activate your license key. |
| AI Engine | Connects to a large language model. | Choose a provider (Grok, OpenAI, etc.) and enter your API key. |
| Website Sync | Builds the AI’s knowledge base. | Initiate the sync to import pages and WooCommerce products. |
| AI Persona | Defines the AI’s personality and voice. | Write a system prompt or use the auto-generate feature. |
| FAQ Management | Ensures accuracy on critical information. | Add verified answers for store policies and common questions. |
Frequently Asked Questions
What do I need before starting the setup?
Before you begin, you will need two key items: your IntelliAgent AI license key (received upon purchase) and an API key from your chosen AI provider (such as OpenAI, Google Gemini, or Grok).
How does the AI learn about my specific products?
The AI learns about your products through the Website & Store Sync feature. This process automatically scans and indexes all your WooCommerce product data, including descriptions, prices, and inventory. The sync runs automatically via WP-Cron to keep the information current.
Can I switch between different AI models?
Yes. IntelliAgent AI allows you to switch between supported AI models like Grok, OpenAI, and Gemini at any time from the AI Engine tab. This gives you the flexibility to choose a provider based on cost, performance, or specific reasoning capabilities.
How do I make the AI sound like it works for my brand?
You can define the AI’s voice and personality in the AI Persona tab. For the best results, use the “Auto-Generate from Website Content” feature, which analyzes your site to create a system prompt that aligns with your existing brand messaging.
By following this guide, you can confidently configure IntelliAgent AI to serve as an effective, knowledgeable, and brand-aligned assistant on your WordPress site. This powerful tool automates customer interactions, streamlines support, and ultimately helps turn conversations into conversions.
Ready to transform your WordPress site with a 24/7 AI assistant? Get your IntelliAgent AI license today and follow this guide to unlock automated sales and support. If you encounter any issues, our technical support team is ready to help.
