WP Manifestindependent plugin directory
manifest / ai / wp-ai-lead-qualifier

AI Lead Qualifier

AI-powered lead scoring for WordPress contact forms — scores Hot/Warm/Cold, suggests replies

by Sharanvijay · github.com/sharanvijaydev/wp-ai-lead-qualifier · website

★ 2stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/sharanvijaydev/wp-ai-lead-qualifier/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/sharanvijaydev/wp-ai-lead-qualifier ↗

AI-powered lead scoring and qualification for WordPress contact forms. Auto-scores leads as Hot/Warm/Cold, detects urgency & budget, generates smart reply suggestions. Works with Contact Form 7, WPForms, Gravity Forms, Fluent Forms & Formidable.

❌ The Problem

  • Small business owners receive contact form submissions but can't tell which leads are worth pursuing
  • Hot leads get the same response time as spam — losing potential clients
  • No way to see submission patterns, urgency, or budget signals at a glance
  • Writing personalized replies to every inquiry is time-consuming

✅ The Solution

This plugin automatically intercepts contact form submissions, sends them to AI for scoring, and presents a clean Lead Intelligence dashboard with prioritized leads, reply suggestions, and instant email notifications for hot leads.

✨ Features

  • 🔥 AI Lead Scoring — Scores each lead 0-100 as Hot / Warm / Cold
  • 📊 Lead Intelligence Dashboard — All leads in one place with filters & sorting
  • 🏷️ Auto-Categorization — Pricing inquiry, project, support, partnership, spam
  • ⚡ Urgency Detection — Detects deadline mentions, ASAP language
  • 💰 Budget Detection — Extracts budget indicators from messages
  • ✉️ AI Reply Suggestions — Personalized reply drafts you can copy or email
  • 📧 Instant Notifications — Email alerts for hot leads
  • 📱 Single Lead View — Detailed analysis with signals, summary & reply
  • 📈 Dashboard Widget — Quick stats on your WordPress dashboard
  • 🔌 5 Form Plugins — CF7, WPForms, Gravity Forms, Fluent Forms, Formidable
  • 🔌 5 AI Providers — OpenAI, Gemini, Claude, OpenRouter, Ollama
  • 🆓 Free Options — Gemini free tier, OpenRouter free models, Ollama

🔌 Supported Form Plugins

Form Plugin Auto-Detected Configuration Needed
Contact Form 7 ✅ None
WPForms ✅ None
Gravity Forms ✅ None
Fluent Forms ✅ None
Formidable Forms ✅ None
Any form (via wp_mail) ✅ None (basic)

Zero configuration — the plugin auto-detects active form plugins and hooks in.

🔌 Supported AI Providers

Provider Free Tier Models Get Key
Google Gemini ✅ Yes Gemini 2.0 Flash, 2.5 Pro aistudio.google.com
OpenRouter ✅ Free Llama 3.3 70B, Qwen 2.5 72B openrouter.ai
Ollama ✅ Free llama3.3, mistral ollama.com
OpenAI ❌ Paid GPT-4o Mini, GPT-4o, o3-mini platform.openai.com
Claude ❌ Paid Claude 3.5 Haiku, 3.7 Sonnet console.anthropic.com

🚀 Installation

cd /path/to/wordpress/wp-content/plugins/
git clone https://github.com/sharanvijaydev/wp-ai-lead-qualifier.git
  1. Activate in WordPress → Plugins
  2. Go to AI Leads → Settings
  3. Add your business description (helps AI score accurately)
  4. Choose AI provider and add API key
  5. Configure notification email
  6. Save settings — done!

Form submissions will now be automatically captured and scored.

📖 Usage

Automatic Flow

Visitor submits form → Plugin intercepts → AI scores lead → 
Dashboard shows result → Hot lead? → Email notification sent

Lead Dashboard

  1. Go to AI Leads → All Leads
  2. Filter by: 🔥 Hot / 🟡 Warm / 🔵 Cold / Category
  3. Sort by: Newest / Score / Oldest
  4. Search by name, email, or message content
  5. Click View → for detailed analysis

Single Lead View

  • See AI score, category, urgency, budget detection
  • Read key signals that influenced the score
  • Copy AI-suggested reply or open in email client
  • Mark as replied for tracking
  • Regenerate reply if needed

Dashboard Widget

  • Quick overview: Hot / Warm / Cold counts
  • Average lead score
  • Today's and this week's leads
  • Unreplied count (urgency indicator)

🧠 How AI Scoring Works

SCORE 90-100: Ready to buy
├── Mentions specific budget
├── Has a deadline or timeline
├── Describes clear requirements

SCORE 70-89: Strong interest
├── Asks about pricing or availability
├── Mentions specific service/product

SCORE 50-69: Genuine but vague
├── General interest
├── Needs more information

SCORE 30-49: Casual inquiry
├── Comparing options
├── No urgency signals

SCORE 0-29: Low priority
├── Very vague or generic
├── Informational only
├── Possible spam

📋 Changelog

1.0.0

  • Initial release
  • AI lead scoring (0-100, Hot/Warm/Cold)
  • Auto-categorization (8 categories)
  • Urgency & budget detection
  • AI reply suggestions with regeneration
  • Lead Intelligence dashboard with filters
  • Single lead detail view
  • Dashboard widget
  • Email notifications for hot leads
  • 5 form plugin integrations (CF7, WPForms, Gravity, Fluent, Formidable)
  • wp_mail fallback for other forms
  • Multi-provider AI support (5 providers)
  • Duplicate submission prevention

🗺️ Roadmap

  • [ ] Lead export (CSV/PDF)
  • [ ] Weekly digest email report
  • [ ] Lead assignment (multi-user)
  • [ ] CRM integration (HubSpot, Zoho)
  • [ ] Conversion tracking
  • [ ] Auto-responder mode
  • [ ] Lead scoring history/timeline

📄 License

GPL v2 or later

👨‍💻 Author

Sharanvijay

⭐ Support

If this plugin helps your business, give it a ⭐ on GitHub!