manifest / integrations / wp-lead-ai-bridge

WP Lead AI Bridge

WordPress plugin — captures CF7/WPForms submissions, logs to MySQL, forwards JSON to n8n for AI classification and routing

by Muhammad Faheem Khan · github.com/faheembukshprog/wp-lead-ai-bridge · website

★ 0stars

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/faheembukshprog/wp-lead-ai-bridge/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/faheembukshprog/wp-lead-ai-bridge ↗

A working demo that connects a WordPress/WooCommerce store to an AI automation pipeline: every lead submitted through the site's contact form is logged, forwarded to n8n, classified by an LLM, and routed to a spreadsheet and a notification — automatically, with no manual work.

This is a self-directed portfolio project built to demonstrate WordPress development combined with AI automation. It is not a client project; no client data or testimonials are used.

Architecture

 [WooCommerce Store + Contact Form]
              |
              v
 [WP Lead AI Bridge plugin]
   - validates + sanitizes input
   - logs to a custom DB table
   - forwards JSON to n8n webhook
              |
              v
        [n8n Webhook]
              |
              v
   [Validate & Clean (Function)]
              |
              v
  [Classify Lead: type, urgency,
   suggested reply (Mock or LLM)]
             / \
            /   \
           v     v
  [Google Sheet]  [Email / Telegram
   (lead record)   notification]

flowchart LR
    A[WooCommerce Store<br/>Contact Form] --> B[WP Lead AI Bridge Plugin]
    B -->|log| C[(Custom DB Table)]
    B -->|POST JSON| D[n8n Webhook]
    D --> E[Validate and Clean]
    E --> F[Classify Lead<br/>Mock or LLM]
    F --> G[Google Sheet]
    F --> H[Email / Telegram Notification]
    H -.optional.-> I[Confirm back to WordPress]

Why it matters

Most junior WordPress developers can build a site. Fewer can make the site do something after a lead comes in — automatically triage it, log it, and get the right person notified with useful context instead of a raw form email. That's the gap this project closes: it pairs core WordPress/WooCommerce skills with a real automation pipeline (webhooks, REST APIs, and an LLM classification step), the same pattern used in production lead-routing and support-triage systems.

What's in this repo

Path	What it is
`wp-lead-ai-bridge.php`	The WordPress plugin: settings page, DB log table, CF7/WPForms hooks, public REST endpoint, admin log viewer
`includes/class-lead-log-list-table.php`	Native wp-admin table (`WP_List_Table`) that displays every logged submission
`n8n-workflow/lead-ai-pipeline.json`	Importable n8n workflow — webhook, validation, mock/LLM classification, Google Sheets + email branches
`SETUP.md`	Step-by-step setup, from a blank XAMPP install to a live tested pipeline

Fails gracefully, on purpose

If n8n is offline or the webhook URL is wrong, the form's own email still sends (the plugin only adds a side effect after the form plugin has already done its job), and the log records exactly what went wrong instead of failing silently. This was tested by stopping n8n mid-demo and confirming the site kept working.

Screenshots

(placeholders — replace with real screenshots once the live demo is up)

screenshots/lead-log.png — the admin Lead Log table
screenshots/n8n-workflow.png — the workflow canvas in n8n
screenshots/sheet-output.png — a classified lead landing in Google Sheets

Watch it run

(placeholder — will embed a short Loom walkthrough here: submitting a lead on the live site, then switching to n8n and the Google Sheet to show it arriving classified in real time)

[Loom link goes here]

Stack

WordPress, WooCommerce, Elementor, Contact Form 7 / WPForms, PHP, MySQL, WordPress REST API, n8n, LLM (OpenAI-compatible), Google Sheets.