=== ResponsePulsar ===
Contributors: thelogiclad
Donate link: https://thelogiclad.com
Tags: ai, autoresponder, contact form 7, wpforms, lead generation
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI lead assistant and form autoresponder. Captures leads, filters spam, and drafts contextual replies using website knowledge.

== Description ==

**ResponsePulsar** is an intelligent AI-powered response assistant and lead automation engine for WordPress forms.

Research shows that responding to an inbound customer lead within **5 minutes** increases conversion rates by **8x**. Standard confirmation auto-responders ("Thank you for your submission") are generic and fail to answer specific customer questions. 

ResponsePulsar connects your WordPress forms directly to cutting-edge AI models (Google Gemini, OpenAI GPT, and Anthropic Claude), reads your website pages and services to build a local context knowledge base, filters out spam bots, and generates draft replies ready for review in your WordPress dashboard.

[Upgrade to Pro](https://thelogiclad.com/responsepulsar)

---

### 🚀 Key Features (Free Version)

* **Instant Form Interception**: Seamlessly captures submissions from popular form builders:
  * Contact Form 7
  * WPForms
  * Elementor Pro Forms
  * Gravity Forms
  * Ninja Forms
* **Multi-Provider AI Engine**: Connect your own API key with support for:
  * **Google Gemini** (Gemini 2.5 Flash, Gemini 1.5 Flash, Gemini 1.5 Pro, Custom)
  * **OpenAI** (GPT-4o, GPT-4o-mini, GPT-3.5-Turbo, Custom)
  * **Anthropic Claude** (Claude 3.5 Sonnet, Claude 3 Haiku, Custom)
* **Intelligent Website Knowledge Base**: Automatically scans your published pages and posts into a local database index to feed accurate business details to the AI.
* **Lead Inbox & Review Station**: View leads, inspect AI draft replies, and edit responses before clicking "Send Email".
* **One-Click Tone Adjuster**: Dynamically re-draft replies inside the editor with a single click:
  * 👔 **Professional** (Formal & authoritative)
  * 😊 **Friendly** (Warm & conversational)
  * ⚡ **Shorten** (Concise 1-2 sentence core message)
  * 📅 **Request Meeting** (Adds consultation scheduling CTA)
* **AI Confidence Assessment**: Every draft includes a 0-100% confidence rating and a detailed explanation of why the AI generated the response.
* **Sentiment & Intent Classification**: Automatically labels leads with intent (`sales`, `support`, `refund`, `general`) and mood (`positive`, `neutral`, `frustrated`).
* **High-Speed Spam Filtering**: Automatically screens bot messages, SEO pitches, and phishing submissions before generating drafts.
* **Custom Business Rules & Guardrails**: Define custom negotiation boundaries, discount limits (e.g. "Max 10% discount on packages"), and booking links.
* **Reports & Analytics**: Track weekly inquiry volume, spam blocked percentages, and average response times with a visual 7-day trend chart.
* **API Rate Limiting Protection**: Built-in safeguard prevents spam flood attacks from exhausting your AI credits (caps automated calls at 30/hour).

---

### 💎 ResponsePulsar Pro (Available on Website)

Need fully autonomous operations or eCommerce integration? Upgrade to **ResponsePulsar Pro**:

* ⚡ **Fully Automated Mode**: Hands-free auto-send for replies exceeding your chosen confidence threshold (50% to 95%).
* 🛒 **WooCommerce Product Sync**: Ingests product catalogs, pricing, variation specs, stock levels, and store FAQs.
* 📬 **Bidirectional Email Reply Tracking**: Synchronize client email responses back into your WordPress lead timeline via **IMAP Polling** or **Inbound Webhooks**.
* 💬 **Multi-Turn Conversation Threads**: Manage ongoing customer negotiations directly from the WordPress Admin.

👉 [Learn More & Get ResponsePulsar Pro](https://thelogiclad.com/responsepulsar)

---

### 🔒 Privacy & Third-Party AI Services Disclosure

ResponsePulsar connects to external third-party Large Language Model (LLM) APIs to generate automated responses and classify spam. By entering your API key in the settings, the plugin communicates with your chosen provider:

1. **Google Gemini API** (Google LLC)
   * **Service Used**: Generative Language API (`https://generativelanguage.googleapis.com`)
   * **Data Sent**: Lead message, lead name (if provided), and relevant website context snippets.
   * [Google Privacy Policy](https://policies.google.com/privacy) | [Google Terms of Service](https://policies.google.com/terms) | [Gemini API Additional Terms](https://ai.google.dev/terms)

2. **OpenAI API** (OpenAI, LLC)
   * **Service Used**: Chat Completions API (`https://api.openai.com/v1/chat/completions`)
   * **Data Sent**: Lead message, lead name (if provided), and relevant website context snippets.
   * [OpenAI Privacy Policy](https://openai.com/policies/privacy-policy) | [OpenAI Terms of Use](https://openai.com/policies/terms-of-use)

3. **Anthropic API** (Anthropic, PBC)
   * **Service Used**: Messages API (`https://api.anthropic.com/v1/messages`)
   * **Data Sent**: Lead message, lead name (if provided), and relevant website context snippets.
   * [Anthropic Privacy Policy](https://www.anthropic.com/privacy) | [Anthropic Terms of Service](https://www.anthropic.com/terms)

*Note: No telemetry, analytics, or user tracking data is sent to ResponsePulsar or any external servers. Communication only occurs with your configured AI provider using your own API credentials.*

== Installation ==

1. Go to **Plugins > Add New** in your WordPress admin dashboard.
2. Search for `ResponsePulsar` or upload the `responsepulsar.zip` file.
3. Click **Install Now** and then **Activate**.
4. Navigate to the new **ResponsePulsar** menu in your admin sidebar.
5. Go to the **Settings** tab:
   * Select your preferred AI Provider (Google Gemini, OpenAI, or Anthropic).
   * Enter your API Key.
   * Choose your model and define any custom business rules.
6. Click **Save Settings**.
7. Go to the **Knowledge Base** tab and click **Scan Website** to index your published pages and posts.
8. Submissions from Contact Form 7, WPForms, Elementor, Gravity Forms, or Ninja Forms will now automatically appear in your **Lead Inbox** with AI drafts ready for review!

== Frequently Asked Questions ==

= Do I need an API key to use this plugin? =
Yes. You can use your own free or paid API key from Google Gemini (Google AI Studio), OpenAI, or Anthropic. Google Gemini offers a generous free tier for developers.

= Which form plugins are supported? =
ResponsePulsar supports Contact Form 7, WPForms, Elementor Pro Forms, Gravity Forms, and Ninja Forms out of the box with zero configuration required.

= Does ResponsePulsar email leads automatically? =
In the Free version, the plugin operates in **Draft & Approve** mode. When a form is submitted, the AI creates a draft in your WordPress Lead Inbox. You can review, edit, change the tone, and click "Send Email" when ready. Fully automated hands-free auto-sending is available in ResponsePulsar Pro.

= Does it work with WooCommerce? =
The free version scans public WordPress pages, posts, and custom fields. WooCommerce product catalog scanning (including pricing, availability, and attributes) is available in ResponsePulsar Pro.

= Will spam submissions drain my API credits? =
No. The plugin includes a built-in spam evaluator and a strict rate limiter (max 30 AI submissions/hour) to protect your API limits and budget.

== Screenshots ==

1. Main Dashboard & Activity Overview.
2. AI Provider Settings (Gemini, OpenAI, Anthropic).
3. Lead Inbox with AI draft replies & tone selector.
4. Custom AI suggestions and business context data.
5. Automated spam filter detection and bot shield.
6. IMAP Connection and inbound email sync settings.
7. Multi-conversation thread view & message timeline.
8. ResponsePulsar Pro advanced features overview.
9. Knowledge base crawler data & update indexing.
10. Automated response mode & confidence thresholds.
11. Final email response preview and delivery station.
12. Autonomous inbound & outbound communication flow.
13. Multi-turn customer follow-up communication.

== Changelog ==

= 1.0.1 =
* Fixed settings form submission issue caused by hidden IMAP input validation.
* Added novalidate attribute to configuration form and hardened AJAX settings save handler.

= 1.0.0 =
* Initial official release of ResponsePulsar.
* Added form integrations for Contact Form 7, WPForms, Elementor Forms, Gravity Forms, and Ninja Forms.
* Added support for Google Gemini, OpenAI, and Anthropic Claude LLM providers.
* Added pure PHP website database crawler for building local business context.
* Added One-Click Tone Adjuster (Professional, Friendly, Condensed, Meeting CTA).
* Added AI Confidence Assessment and Sentiment/Intent classification.
* Added Reports & Analytics dashboard with CSS weekly trend charts.
* Added API Rate Limiter and spam shield protection.

== Upgrade Notice ==

= 1.0.1 =
Includes fix for settings form saving and hardened client-side validation.

= 1.0.0 =
Welcome to ResponsePulsar! Install and activate to start automating your form lead responses.
