Description
Turn Your WordPress Site Into a 24/7 AI Sales Assistant
AI chatbot for WordPress that answers questions, recommends products, and captures leads automatically.
Unlike generic chatbots, Promptor learns directly from your website content. It understands what you offer, provides accurate answers based on your pages and posts, and guides visitors toward taking action—whether that’s requesting a quote, asking about a service, or making a purchase.
Works with all major WordPress themes including Astra, Kadence, GeneratePress, Neve, and WooCommerce stores.
See Promptor in action — Watch how AI engages visitors, answers questions, and captures leads in real-time.
Who Promptor Is For:
- Business Owners who lose leads to slow response times or confusing navigation
- Founders who need to qualify and capture leads outside business hours
- Agencies looking to add AI-powered engagement to client websites
- WooCommerce Stores wanting to recommend products through conversation (Pro)
How It Works:
- Connect your OpenAI API key
- Select up to 3 pages or posts for your free knowledge base
- Add the chat widget to your site with a shortcode
- Visitors ask questions, get instant answers, and can submit their details as leads
Perfect For
- SaaS websites
- Agencies
- WooCommerce stores
- Service businesses
- Local businesses
- AI-powered customer support
The free version is fully functional and ready to use. Pro unlocks scaling features like unlimited knowledge base items, WooCommerce integration, analytics, and automation.
Free Features
✓ AI Chat Widget — Engage visitors with natural AI conversation on any page
✓ Lead Capture — Collect visitor contact information directly inside the chat
✓ Knowledge Base (3 items) — Train AI on up to 3 pages or posts from your site
✓ Quick Start Guide — Step-by-step onboarding to get you running in minutes
✓ Lead Inbox — View recent inquiries submitted through the chat
✓ AI Cost Guardrails — Set daily and monthly spending limits, automatic model fallback, and email alerts to control API costs
✓ Customization — Adjust colors, heading, and subtitle to match your brand
✓ Shortcode Display — Place [promptor_search] anywhere on your site
✓ Dark Mode — Choose between Dark, Light, or Auto theme for the admin interface
Pro Features (Available with Upgrade)
Scale Your AI Assistant:
✓ Unlimited Knowledge Base — Train AI on unlimited pages, posts, products, and PDFs
✓ Website Crawler — Automatically index your entire site from sitemap
✓ Popup Widget — Floating chat button that follows visitors across pages
WooCommerce Integration:
✓ Product Recommendations — AI suggests products with images and pricing
✓ Add to Cart — Visitors add products directly from chat conversation
✓ Inventory-Aware AI — Prioritizes in-stock products, warns about low stock and unavailability
✓ Product Comparison Table — Side-by-side comparison when multiple products are recommended
✓ Stock Badges — Visual Out of Stock / Low Stock indicators on product cards
✓ Cart Reminder — Gentle nudge when visitors have abandoned items in their cart
✓ WooCommerce Display Settings — Toggle comparison, stock badges, and cart reminder from admin
Analytics & Optimization:
✓ Performance Dashboard — Track queries, leads, conversion rates, and revenue
✓ AI Lead Scoring — Automatically score leads with Hot/Warm/Cold classification
✓ Most Asked Questions — Identify content gaps and common visitor needs
✓ Diagnostics Panel — System health dashboard with API and webhook monitoring
Automation & Notifications:
✓ Email & Slack Alerts — Instant notifications when new leads arrive
✓ Branded Email Templates — Professional HTML notifications with your site branding
✓ Webhook Support — Connect to Zapier, Make, or custom automation with HMAC security
Lead Management:
✓ Advanced Lead Management — Track lead status (Pending, Contacted, Converted)
✓ Submissions Archive & Filters — Organize leads with archive, date range, and score filters
Professional Features:
✓ Full UI Customization — Complete control over colors, fonts, avatars, and widget position
✓ White Label — Remove “Powered by Promptor” branding
✓ Priority Support — Faster response from our team
Upgrade to Promptor Pro to unlock unlimited knowledge bases, WooCommerce product recommendations, analytics dashboards, and automation tools. Learn more
Privacy & Data Handling
OpenAI API (Required):
Promptor requires an OpenAI API key to function. User queries and selected content are sent to OpenAI to generate responses. Review OpenAI’s Terms of Use and Privacy Policy.
Telemetry (Optional, Free Only):
The free version includes optional anonymous telemetry to help improve plugin stability. Telemetry is disabled by default and requires explicit opt-in. When enabled, we collect only aggregate usage statistics (setup completion, KB counts, query totals) and no personally identifiable information. Pro users are not subject to telemetry.
See our Privacy Policy for full details.
External Services
This plugin connects to external services to provide its functionality. By using Promptor, you agree to the terms and privacy policies of these services.
1. OpenAI API (Required)
- Purpose: Generate AI chat responses and create semantic embeddings for knowledge base
- Data Sent: User queries, selected page/post content, your OpenAI API key
- When: Every chat interaction and when syncing knowledge base
- Terms: OpenAI Terms of Use
- Privacy: OpenAI Privacy Policy
2. Promptor Telemetry API (Optional, Disabled by Default)
- Purpose: Collect anonymous usage statistics to improve the free version
- Data Sent: Setup status, KB counts, query/lead totals (numbers only), plugin/WP/PHP versions, anonymous UUID
- Data NOT Sent: Site URLs, IP addresses, emails, content, queries, or any PII
- When: Twice daily via WP-Cron, only when you explicitly enable it
- Control: Enable/disable anytime in Settings > Telemetry
- Privacy: Promptor Privacy Policy
Screenshots
AI Chat Widget — Interactive chat interface that answers questions and guides visitors to take action 
Lead Capture Inside Chat — Collect contact information directly inside the conversation 
Quick Start Onboarding — Step-by-step setup guide gets you running in minutes 
Knowledge Base Selection — Choose which pages and posts to train your AI assistant on 
Lead Inbox — View recent inquiries and captured leads in the WordPress admin 
AI Cost Guardrails — Control usage with limits, alerts, and automatic fallback settings 
(Pro) WooCommerce Product Recommendations — AI suggests products with images, pricing, and add-to-cart 
(Pro) Analytics Dashboard — Track queries, leads, conversion rates, and AI-driven revenue
Installation
Automatic Installation (Recommended):
- Go to ‘Plugins’ > ‘Add New’ in your WordPress dashboard
- Search for ‘Promptor’
- Click ‘Install Now’ then ‘Activate’
- Follow the Quick Start Guide in the ‘Promptor’ menu
Manual Installation:
- Download the plugin .zip file from WordPress.org
- Go to ‘Plugins’ > ‘Add New’ > ‘Upload Plugin’
- Choose the .zip file and click ‘Install Now’
- Activate the plugin and configure your OpenAI API key
First-Time Setup:
- Get your OpenAI API key from platform.openai.com
- Go to Promptor > Settings > API Settings
- Enter your API key and save
- Select 3 pages/posts to train your AI (Knowledge Base)
- Add
[promptor_search]to any page or post
FAQ
-
What do I need to get started?
-
You need an OpenAI API key. Create a free account at platform.openai.com and generate an API key. OpenAI charges based on usage—typically $0.01-$0.10 per conversation depending on length and complexity.
-
How do I display the chat on my site?
-
Use the shortcode
[promptor_search]on any page or post. The Pro version also includes a floating popup widget that appears on all pages. -
Does this work with my WordPress theme?
-
Yes. Promptor is designed to work with any standard WordPress theme, including Neve, Astra, GeneratePress, Kadence, and default WordPress themes. We use CSS isolation techniques to prevent theme conflicts.
-
How many leads can I capture with the free version?
-
Unlimited. The free version has no restrictions on lead capture. You can view recent leads in the admin panel. Pro adds advanced lead management with status tracking and filtering.
-
What’s the difference between Free and Pro?
-
The free version is fully functional with AI chat, lead capture, and up to 3 knowledge base items. Pro removes limits, adds WooCommerce integration, analytics, automations, and white-label branding. Think of Free as “getting started” and Pro as “scaling and optimizing revenue.”
-
What are AI Cost Guardrails?
-
AI Cost Guardrails help you control your OpenAI spending. Set daily and monthly token limits, and the plugin alerts you by email when you reach 80%, 90%, or 100% of your budget. If a limit is exceeded, the plugin can automatically switch to a more affordable AI model to keep costs under control. Configure it in Settings > AI Usage. This feature is available in both Free and Pro.
-
Can Promptor replace a contact form?
-
Yes. Many sites use Promptor as a conversational alternative to traditional contact forms. Visitors can ask questions naturally, receive instant answers, and leave their contact details directly inside the chat — resulting in higher engagement and more qualified leads.
-
Why does the free version have telemetry?
-
Telemetry is optional, disabled by default, and helps us understand which features are most valuable so we can prioritize bug fixes and improvements. Pro users provide feedback through direct support channels, so telemetry isn’t needed. You can enable or disable it anytime in Settings > Telemetry.
-
What data does telemetry collect?
-
Only aggregate, anonymous statistics: setup completion status, knowledge base counts, total queries/leads (numbers only), and plugin/WordPress/PHP versions. We explicitly do NOT collect: site URLs, domain names, IP addresses, email addresses, content, message text, or any personally identifiable information. View our Privacy Policy
-
Can the AI recommend WooCommerce products?
-
Yes, but only in Pro. The Pro version includes deep WooCommerce integration where the AI can recommend products with images and pricing, and visitors can add items to cart directly from chat.
-
Does Promptor support dark mode?
-
Yes. As of version 1.3.0, you can choose between Dark, Light, or Auto (follows your system setting) from Settings > UI Settings. All admin pages are fully styled in both themes.
-
Is it safe to update to the latest version?
-
Yes. All Promptor updates are fully backward compatible. Your settings, knowledge bases, and lead data are preserved during updates. Version 1.3.0 includes 111 automated tests to ensure stability.
-
What languages does Promptor support?
-
The AI automatically responds in the visitor’s language. All admin interface text can be translated using standard WordPress translation tools (.po/.mo files).
-
Can I try Pro before purchasing?
-
Pro offers a 14-day money-back guarantee. Install the free version first to test compatibility with your site, then upgrade to Pro if you need advanced features. Learn more about Pro
Reviews
Contributors & Developers
“Promptor” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Promptor” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.3.5
Release Date: March 17, 2026
New Features (Pro):
* Inventory-Aware AI Recommendations — AI now knows product stock status and prioritizes in-stock items
* Product Comparison Table — Side-by-side comparison table when AI recommends 2+ products
* Stock Badges — “Out of Stock” and “Low Stock” badges on product cards
* Cart Reminder — Nudge visitors to complete purchases when they have items in cart
* WooCommerce Display Settings — Admin controls for comparison, stock badges, and cart reminder
Chat UX Improvements:
* Message Timestamps — Each message now shows a relative time indicator (“2 min ago”, “just now”)
* Copy Message Button — One-click copy icon on AI responses for easy sharing
* Modern Thinking Indicator — Replaced bouncing dots with a sleek “Promptor is thinking…” pulse animation
Accessibility:
* Full Keyboard Navigation — Tab through example questions, arrow keys to navigate, Enter to select
* ARIA Labels — Screen reader support for chat log, input field, send button, and all interactive elements
* Focus Trap — In popup mode, Tab focus stays within the chat widget
* Focus-visible Styles — Clear keyboard focus indicators on all interactive elements
Mobile UX:
* Input Auto-Resize — Textarea automatically grows as you type longer messages (max 120px)
* Consistent Touch Targets — 44px minimum touch target on all buttons and interactive elements
Performance:
* Debounced Input — Prevents unnecessary re-renders during fast typing
Bug Fixes:
* Fixed price display showing raw HTML entities instead of proper currency symbols
Improvements:
* Redesigned comparison table with better spacing, color-coded cells, and star ratings
* Redesigned cart reminder with improved layout and styling
1.3.0
Release Date: March 6, 2026
New Features:
* AI Cost Guardrails — Never worry about surprise API bills again. Set daily and monthly spending limits, receive email alerts at 80%, 90%, and 100% usage, and let the plugin automatically switch to a more affordable model when you approach your budget. Configure everything from the new Settings > AI Usage tab.
* Dark Mode — Work the way you prefer. Choose between Dark, Light, or Auto (follows your system setting) from UI Settings. Every admin page is beautifully styled in both themes.
* (Pro) Branded Email Notifications — All notification emails now feature a professional, branded HTML template with your site name, color-coded headers, and a polished layout that looks great in every email client.
* (Pro) Submissions Archive & Filters — Keep your leads organized with archive/unarchive actions, date range filtering, and score-based filtering (High/Medium/Low). Toggle between Active and Archived views just like your email inbox.
Improvements:
* Refreshed Admin Interface — Every settings page has been polished with consistent styling, clear section icons, and an improved visual hierarchy. The admin area now feels modern and cohesive.
* Modern Toast Notifications — No more jarring browser popups. All admin notifications now appear as sleek, non-intrusive toast messages.
* Smarter Error Messages — When something goes wrong, both you and your visitors see clear, helpful messages instead of cryptic errors.
* Knowledge Base Management — Improved action buttons with helpful tooltips and better layout make managing your knowledge bases easier than ever.
* Under-the-Hood Reliability — Extensive code modernization with 111 automated tests ensures rock-solid stability. Your chat widget is now faster, more reliable, and thoroughly tested.
* Full WordPress Plugin Check compliance for security and coding standards
1.2.2
Release Date: February 12, 2026
New Features:
* Single-screen Setup Wizard – New guided onboarding flow for faster first-time setup, accessible on first activation
Bug Fixes:
* Fixed PHP 8.1 compatibility warnings for a smoother, warning-free experience
* Fixed activation redirect issues that could cause errors on first install
* Fixed potential errors on fresh installs before the database was fully initialized
1.2.1
Release Date: February 3, 2026
New Features:
* Step-Based Onboarding – Guided 3-step setup process for first-time users
* Test Chat Feature – Try your AI assistant with suggested questions after setup
* Optional Anonymous Telemetry – Opt-in usage analytics for free version (disabled by default, no PII)
* WordPress.org Review Prompt – Smart review request that appears only after delivering value
* Modern 3-Column Onboarding Grid – Card-based layout with dismissable progress tracking
Improvements:
* Better First-Time Experience – Reduced distraction during setup with focused UI
* Enhanced Welcome Page – Redesigned with progress tracking and contextual guidance
* Admin Visit Tracking – Enables smart timing for review prompts
* Improved Pro Upsell Timing – Less intrusive, more contextual upgrade messaging
Bug Fixes:
* Frontend UI Settings – Colors and fonts now apply correctly to shortcode widget
* Universal Theme Compatibility – Complete CSS isolation prevents conflicts with Neve, Astra, and all major themes
* Shortcode Display – Free version correctly shows [promptor_search] for default knowledge base
* PluginCheck Compliance – All queries use prepared statements, proper nonce verification, translator comments added
Technical:
* Telemetry Auto-Sync – Existing installations sync current state when telemetry first enabled
* Enhanced CSS Architecture – Theme-proof styling with maximum specificity and explicit element styles
1.2.0
- Improved code quality and WordPress.org compliance
- Enhanced documentation and compatibility
- Performance optimizations
- (Pro) New Lead Scoring System
- (Pro) Webhook Integrations
- (Pro) Diagnostics Panel
1.1.1
- Fixed: Translation system completely rebuilt for reliable multilingual support
- Fixed: All UI text now translates correctly regardless of plugin folder name
- Fixed: “Request Quote” buttons and confirmation dialogs translate properly
- Improved: Faster translation loading with embedded translations
- Improved: Works with Freemius folder renaming
1.1.0
- New: Conversation Memory – Chat history persists across page navigations
- New: “New Conversation” button for clearing chat history
- New: Improved AI responses with clarifying questions and fallback messages
- New: Better empty state handling with clear error messages
- New: (Pro) Most Asked Questions analytics report
- Enhanced: Unified service conversation UI
- Enhanced: Multi-description support for services
- Enhanced: Full-width quote form on desktop
- Enhanced: (Pro) PDF cards with file size and download button
- Improved: Mobile chat experience with smooth animations
- Fixed: Quote form width and duplication issues
- Fixed: (Pro) PDF Files tab visibility in Knowledge Base
1.0.1
- Added: Smart pagination for Knowledge Base content management
- Added: Real-time selection counter and bulk selection tools
- Enhanced: AI-powered example questions generator for multilingual content
- Fixed: Frontend translations now display correctly
- Fixed: Critical – Save preserves previously selected items when using Load More
- Optimized: Better performance with large content libraries
1.0.0
- Initial release
- Core AI Chat powered by OpenAI
- Knowledge Base from Pages, Posts, (Pro) Products & PDFs
- Service and product recommendations
- Built-in lead generation
- (Pro) Performance Dashboard
- (Pro) Advanced Lead Management