{"id":309620,"date":"2026-06-02T06:25:17","date_gmt":"2026-06-02T06:25:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ai-lead-intent-scorer\/"},"modified":"2026-06-25T14:20:55","modified_gmt":"2026-06-25T14:20:55","slug":"formscout-ai-smart-lead-scoring","status":"publish","type":"plugin","link":"https:\/\/test.wordpress.org\/plugins\/formscout-ai-smart-lead-scoring\/","author":21177684,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"FormScout AI: Smart Lead Scoring","header_author":"Umesh Ladumor","header_description":"Automatically score and classify form leads as HOT, WARM, COLD, or SPAM using AI (Google Gemini, OpenAI) or built-in keyword analysis. Works with Contact Form 7, Gravity Forms, and WPForms.","assets_banners_color":"2e5968","last_updated":"2026-06-25 14:20:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/profiles.wordpress.org\/umeshladumor\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":122,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"umeshladumor","date":"2026-06-02 06:24:44"},"1.1.0":{"tag":"1.1.0","author":"umeshladumor","date":"2026-06-25 14:20:55"}},"upgrade_notice":{"1.1.0":"<p>Adds phone capture, smarter field detection, and Lead Logs filters. No manual steps needed \u2014 the database upgrades automatically.<\/p>","1.0.0":"<p>Initial release of FormScout AI.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3557527,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3557527,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3557527,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3557527,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3586270,"resolution":"1","location":"assets","locale":"","width":1440,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3586270,"resolution":"2","location":"assets","locale":"","width":1440,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3586270,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3586270,"resolution":"4","location":"assets","locale":"","width":1440,"height":900}},"screenshots":{"1":"Settings page \u2014 General settings, form integrations, and scoring engine selection.","2":"Scoring engine \u2014 Choose between Google Gemini (free), OpenAI, or rule-based scoring.","3":"Lead Logs \u2014 Dashboard showing all scored leads with stats, signals, and message preview.","4":"Lead Logs filters \u2014 Filter scored leads by score, form source, and date range."}},"plugin_section":[],"plugin_tags":[2353,1152,1655,45446,130711],"plugin_category":[],"plugin_contributors":[234948],"plugin_business_model":[],"class_list":["post-309620","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-contact-form-7","plugin_tags-gravity-forms","plugin_tags-lead-scoring","plugin_tags-wpforms","plugin_contributors-umeshladumor","plugin_committers-umeshladumor"],"banners":{"banner":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/banner-772x250.png?rev=3557527","banner_2x":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/banner-1544x500.png?rev=3557527","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/icon-128x128.png?rev=3557527","icon_2x":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/icon-256x256.png?rev=3557527","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/screenshot-1.png?rev=3586270","caption":"Settings page \u2014 General settings, form integrations, and scoring engine selection."},{"src":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/screenshot-2.png?rev=3586270","caption":"Scoring engine \u2014 Choose between Google Gemini (free), OpenAI, or rule-based scoring."},{"src":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/screenshot-3.png?rev=3586270","caption":"Lead Logs \u2014 Dashboard showing all scored leads with stats, signals, and message preview."},{"src":"https:\/\/ps.w.org\/formscout-ai-smart-lead-scoring\/assets\/screenshot-4.png?rev=3586270","caption":"Lead Logs filters \u2014 Filter scored leads by score, form source, and date range."}],"raw_content":"<!--section=description-->\n<p><strong>FormScout AI<\/strong> automatically analyzes your form submissions and classifies every lead as <strong>\ud83d\udd25 HOT<\/strong>, <strong>\ud83d\udfe1 WARM<\/strong>, <strong>\ud83d\udd35 COLD<\/strong>, or <strong>\u26a0\ufe0f SPAM<\/strong> \u2014 so you know which leads to follow up first.<\/p>\n\n<p>Works with <strong>Contact Form 7<\/strong>, <strong>Gravity Forms<\/strong>, and <strong>WPForms<\/strong>.<\/p>\n\n<h4>Three Scoring Modes<\/h4>\n\n<ol>\n<li><strong>Google Gemini (Free)<\/strong> \u2014 Uses the Gemini API free tier. No credit card required.<\/li>\n<li><strong>OpenAI<\/strong> \u2014 Uses GPT-4o-mini or other OpenAI models (paid API key required).<\/li>\n<li><strong>Without AI<\/strong> \u2014 Built-in rule-based keyword scoring. No API key needed. Works completely offline.<\/li>\n<\/ol>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>Automatic lead classification<\/strong> \u2014 HOT, WARM, COLD, or SPAM on every submission.<\/li>\n<li><strong>Smart field detection<\/strong> \u2014 Automatically finds name, email, phone, company, and budget fields regardless of how your form labels them, and folds any extra custom fields (e.g. \"Service Interested In\", \"Timeline\") into the analysis so no signal is lost.<\/li>\n<li><strong>Email subject tagging<\/strong> \u2014 Prepends [\ud83d\udd25 HOT LEAD], [\ud83d\udfe1 WARM LEAD], etc. to notification emails.<\/li>\n<li><strong>Lead logs dashboard<\/strong> \u2014 View all scored leads with score, confidence, reason, signals, and message preview, with filters for score, form source, and date range.<\/li>\n<li><strong>Integration toggles<\/strong> \u2014 Choose which form plugins to integrate with from the settings page.<\/li>\n<li><strong>Fallback protection<\/strong> \u2014 If AI fails, automatically falls back to rule-based scoring. Never blocks form submissions.<\/li>\n<li><strong>Privacy-first<\/strong> \u2014 No data sent to external APIs unless you explicitly configure and enable an AI provider.<\/li>\n<li><strong>WordPress standards<\/strong> \u2014 OOP architecture, proper sanitization, escaping, nonces, capability checks, and prepared SQL queries.<\/li>\n<\/ul>\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>A visitor submits a form (CF7, Gravity Forms, or WPForms).<\/li>\n<li>The plugin intercepts the submission and pulls out name, email, phone, company, budget, and message \u2014 plus any other field the form collects.<\/li>\n<li>The scoring engine classifies the lead based on keywords, budget mentions, urgency signals, phone\/company presence, email domain, and message quality.<\/li>\n<li>The email notification subject is tagged with the lead score.<\/li>\n<li>The scored lead is logged in a custom database table and visible in the admin dashboard, where you can filter by score, form source, or date.<\/li>\n<\/ol>\n\n<h4>Scoring Criteria<\/h4>\n\n<ul>\n<li><strong>HOT<\/strong> \u2014 Strong buying intent: budget mentioned, timeline\/deadline, urgency keywords, ready to proceed.<\/li>\n<li><strong>WARM<\/strong> \u2014 Genuine interest: exploring options, asking about services\/solutions, requesting more information.<\/li>\n<li><strong>COLD<\/strong> \u2014 Vague or minimal: short messages, no intent signals, generic greetings.<\/li>\n<li><strong>SPAM<\/strong> \u2014 Promotional or irrelevant: SEO offers, link building, casino\/crypto spam, disposable emails.<\/li>\n<\/ul>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WordPress 5.8 or higher<\/li>\n<li>PHP 7.4 or higher<\/li>\n<li>At least one supported form plugin: Contact Form 7, Gravity Forms, or WPForms<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>This plugin can optionally connect to third-party AI services to classify form leads. <strong>No data is sent to any external service unless you explicitly configure and enable an AI provider in the plugin settings.<\/strong><\/p>\n\n<h4>Google Gemini API<\/h4>\n\n<p>When the \"Google Gemini\" scoring engine is selected and an API key is configured, this plugin sends the following lead data to Google's Generative Language API:<\/p>\n\n<ul>\n<li>Submitter's name, email address, company name, budget, phone number, and message \u2014 including any extra form fields the plugin folded into the message (from the form submission).<\/li>\n<li>Data is sent each time a supported form is submitted while the plugin is active and the Gemini provider is enabled.<\/li>\n<\/ul>\n\n<p>This service is provided by Google LLC.<\/p>\n\n<ul>\n<li>Service URL: https:\/\/generativelanguage.googleapis.com\/<\/li>\n<li>Terms of Service: https:\/\/policies.google.com\/terms<\/li>\n<li>Privacy Policy: https:\/\/policies.google.com\/privacy<\/li>\n<\/ul>\n\n<h4>OpenAI API<\/h4>\n\n<p>When the \"OpenAI\" scoring engine is selected and an API key is configured, this plugin sends the following lead data to the OpenAI API:<\/p>\n\n<ul>\n<li>Submitter's name, email address, company name, budget, phone number, and message \u2014 including any extra form fields the plugin folded into the message (from the form submission).<\/li>\n<li>Data is sent each time a supported form is submitted while the plugin is active and the OpenAI provider is enabled.<\/li>\n<\/ul>\n\n<p>This service is provided by OpenAI, L.L.C.<\/p>\n\n<ul>\n<li>Service URL: https:\/\/api.openai.com\/<\/li>\n<li>Terms of Service: https:\/\/openai.com\/policies\/terms-of-use<\/li>\n<li>Privacy Policy: https:\/\/openai.com\/policies\/privacy-policy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>formscout-ai-smart-lead-scoring<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory, or install directly from the WordPress plugin screen.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu in WordPress.<\/li>\n<li>Go to <strong>Lead Scorer \u2192 Settings<\/strong> to configure:\n\n<ul>\n<li>Enable\/disable the plugin<\/li>\n<li>Choose which form integrations to activate<\/li>\n<li>Select a scoring engine (Gemini, OpenAI, or Without AI)<\/li>\n<li>Enter your API key if using an AI provider<\/li>\n<\/ul><\/li>\n<li>Submit a test form to verify scoring is working.<\/li>\n<li>View scored leads under <strong>Lead Scorer \u2192 Lead Logs<\/strong>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20work%20without%20an%20ai%20api%20key%3F\"><h3>Does this plugin work without an AI API key?<\/h3><\/dt>\n<dd><p>Yes! Select \"Without AI\" as the scoring engine and the plugin uses built-in keyword analysis to classify leads. No API key required.<\/p><\/dd>\n<dt id=\"is%20the%20google%20gemini%20api%20really%20free%3F\"><h3>Is the Google Gemini API really free?<\/h3><\/dt>\n<dd><p>Yes. Google offers a free tier for the Gemini API. Get your key at <a href=\"https:\/\/aistudio.google.com\/apikey\">Google AI Studio<\/a> \u2014 no credit card required.<\/p><\/dd>\n<dt id=\"will%20this%20plugin%20slow%20down%20my%20form%20submissions%3F\"><h3>Will this plugin slow down my form submissions?<\/h3><\/dt>\n<dd><p>No. The AI API call has a short timeout (5-10 seconds), and if it fails, the plugin silently falls back to rule-based scoring. Form submissions are never blocked.<\/p><\/dd>\n<dt id=\"what%20data%20is%20sent%20to%20the%20ai%20api%3F\"><h3>What data is sent to the AI API?<\/h3><\/dt>\n<dd><p>Only the form submission fields (name, email, company, budget, phone, message, and any extra fields the form includes) are sent to the configured API. No data is sent unless you explicitly configure and enable an AI provider.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20store%20personal%20data%3F\"><h3>Does this plugin store personal data?<\/h3><\/dt>\n<dd><p>Yes, the plugin stores lead data (name, email, phone, message, score) in a custom database table for the lead logs feature. This data is only accessible to administrators.<\/p><\/dd>\n<dt id=\"can%20i%20delete%20the%20stored%20lead%20data%3F\"><h3>Can I delete the stored lead data?<\/h3><\/dt>\n<dd><p>Yes. Individual log entries can be deleted from the Lead Logs page. All data is also removed when you uninstall (delete) the plugin.<\/p><\/dd>\n<dt id=\"which%20form%20plugins%20are%20supported%3F\"><h3>Which form plugins are supported?<\/h3><\/dt>\n<dd><p>Contact Form 7, Gravity Forms, and WPForms (including WPForms Lite).<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added phone number capture and scoring across Contact Form 7, Gravity Forms, and WPForms.<\/li>\n<li>Custom\/unmapped form fields (e.g. \"Service Interested In\", \"Timeline\") are now consistently folded into the message for all three form integrations, so no signal is lost regardless of field naming.<\/li>\n<li>Added Score, Form Source, and Date Range filters to the Lead Logs admin page.<\/li>\n<li>Rewrote the AI scoring prompt with a concrete rubric and examples for more consistent HOT\/WARM\/COLD\/SPAM decisions.<\/li>\n<li>Improved rule-based confidence scoring to account for quality signals (phone, company, business email).<\/li>\n<li>Fixed provider-card and integration-toggle selection on the Settings page (JS function name mismatch).<\/li>\n<li>Renamed the main plugin file and text domain to match the plugin slug.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Contact Form 7, Gravity Forms, and WPForms integration.<\/li>\n<li>Google Gemini and OpenAI AI scoring support.<\/li>\n<li>Rule-based keyword scoring (Without AI mode).<\/li>\n<li>Admin settings page with provider selection and integration toggles.<\/li>\n<li>Lead logs dashboard with stats, signals, and message preview.<\/li>\n<li>Email subject line tagging with lead score labels.<\/li>\n<li>Custom database table for lead log storage.<\/li>\n<\/ul>","raw_excerpt":"Automatically score and classify form leads as HOT, WARM, COLD, or SPAM using AI or built-in keyword analysis.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/309620","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=309620"}],"author":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/umeshladumor"}],"wp:attachment":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=309620"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=309620"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=309620"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=309620"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=309620"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=309620"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}