Promptor

Turn Your WordPress Site Into a 24/7 AI Sales Assistant Promptor helps founders, businesses, and agencies convert more visitors into leads by answering questions instantly, recommending products or services, and capturing contact information—all through natural conversation powered by AI. 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. 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:

1. Connect your OpenAI API key (required for AI functionality)
2. Select which pages, posts, or products to train the AI on
3. Add the chat widget to your site with a shortcode
4. Visitors ask questions, get instant answers, and become leads

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 — Interactive chat interface powered by OpenAI's latest models ✓ Knowledge Base (3 items) — Train AI on up to 3 pages or posts from your site ✓ Lead Capture — Collect visitor contact information directly inside the chat ✓ AI Cost Guardrails — Set daily and monthly spending limits, automatic model fallback, and email alerts to control API costs ✓ Dark Mode — Choose between Dark, Light, or Auto theme for the admin interface ✓ Customization — Adjust colors, heading, and subtitle to match your brand ✓ Shortcode Display — Place [promptor_search] anywhere on your site ✓ Lead Inbox — View recent inquiries submitted through the chat ✓ Quick Start Guide — Step-by-step onboarding to get you running in minutes 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 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.

Automatic Installation (Recommended):

1. Go to 'Plugins' > 'Add New' in your WordPress dashboard
2. Search for 'Promptor'
3. Click 'Install Now' then 'Activate'
4. Follow the Quick Start Guide in the 'Promptor' menu

Manual Installation:

1. Download the plugin .zip file from WordPress.org
2. Go to 'Plugins' > 'Add New' > 'Upload Plugin'
3. Choose the .zip file and click 'Install Now'
4. Activate the plugin and configure your OpenAI API key

First-Time Setup:

1. Get your OpenAI API key from platform.openai.com
2. Go to Promptor > Settings > API Settings
3. Enter your API key and save
4. Select 3 pages/posts to train your AI (Knowledge Base)
5. Add [promptor_search] to any page or post

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