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
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/sharanvijaydev/wp-ai-lead-qualifier/archive/refs/heads/main.zipAI-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
- Activate in WordPress → Plugins
- Go to AI Leads → Settings
- Add your business description (helps AI score accurately)
- Choose AI provider and add API key
- Configure notification email
- 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
- Go to AI Leads → All Leads
- Filter by: 🔥 Hot / 🟡 Warm / 🔵 Cold / Category
- Sort by: Newest / Score / Oldest
- Search by name, email, or message content
- 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
- Website: thozhilnutpamtech.com
- GitHub: @sharanvijaydev
⭐ Support
If this plugin helps your business, give it a ⭐ on GitHub!