=== FormBeep — Instant Form Alerts to Your Phone ===
Contributors: rishikeshs
Tags: whatsapp, form notifications, contact form, whatsapp notifications, lead notifications
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Instant WhatsApp alerts for every form submission. Works with Contact Form 7, WPForms, Gravity Forms, Elementor, and any HTML form.

== Description ==

**Get notified immediately when someone submits a form on your site — and reply before they move on.**

FormBeep sends you a WhatsApp notification the moment someone hits submit. No checking inboxes. No leads going cold. You know instantly, so you can respond in seconds.

= How It Works =

1. Sign up at [FormBeep](https://formbeep.com) and verify your WhatsApp number (takes 2 minutes)
2. Add your domain in the FormBeep dashboard
3. Enter your API key in the plugin settings
4. Done — form submissions go straight to your WhatsApp

No form rebuilding. No plugin conflicts. No changing your existing forms.

= Works With Every Form Plugin =

FormBeep works with any HTML form on your WordPress site, including:

* **Contact Form 7**
* **WPForms**
* **Gravity Forms**
* **Elementor Forms**
* **Ninja Forms**
* **Formidable Forms**
* Any custom HTML form

= Why WhatsApp Instead of Email? =

Email notifications get buried, filtered to spam, or checked hours later. WhatsApp is on your phone, always open.

* Instant delivery — no spam folder, no inbox delay
* You see it the moment it arrives — same as any other message
* Works with your regular WhatsApp number — no Business account required

= Privacy First =

FormBeep is built with privacy in mind. Form submission data is temporarily stored on FormBeep's servers only until you view the notification. Once you tap "View Details" on WhatsApp, the data is permanently deleted. If you don't view it, it auto-deletes after 7 days. No archives, no backups of your visitors' data.

= Features =

* One-line installation via plugin settings — no code editing needed
* Works with all major form plugins and custom HTML forms
* Instant WhatsApp notifications on every form submission
* Optional custom success message for visitors
* Pause and resume notifications from the FormBeep dashboard
* Submission logs in your FormBeep dashboard
* Multiple WhatsApp recipients (Pro plan and above)
* Multi-domain support (Pro plan and above)
* Privacy-first: data permanently deleted after viewing

= External Service =

This plugin connects to the FormBeep API (api.formbeep.com) to deliver WhatsApp notifications. When a form is submitted on your site, the form data is sent to FormBeep's servers to process and forward to your WhatsApp number.

* [FormBeep Website](https://formbeep.com)
* [Privacy Policy](https://formbeep.com/privacy.html)
* [Terms of Service](https://formbeep.com/terms.html)

A free FormBeep account is required to use this plugin. The free plan includes 15 notifications per month.

== Installation ==

= Automatic Installation =

1. Go to **Plugins → Add New** in your WordPress admin
2. Search for **FormBeep**
3. Click **Install Now**, then **Activate**
4. Go to **Settings → FormBeep** and enter your API key

= Manual Installation =

1. Download the plugin zip file
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the zip file and click **Install Now**
4. Activate the plugin
5. Go to **Settings → FormBeep** and enter your API key

= Getting Your API Key =

1. Sign up at [accounts.formbeep.com/sign-up](https://accounts.formbeep.com/sign-up)
2. Verify your WhatsApp number by scanning a QR code
3. Add your website domain (e.g. `example.com`) in the dashboard
4. Copy your API key from **Settings** in the FormBeep dashboard

== Frequently Asked Questions ==

= Do I need a WhatsApp Business account? =

No. FormBeep works with your regular WhatsApp number. No Meta Business account or WhatsApp Business API setup required on your end — FormBeep handles all of that.

= Does this work with Contact Form 7? =

Yes. FormBeep works alongside Contact Form 7 without any configuration changes. It reads form submissions after they're submitted without interfering with CF7's own processing.

= Will it break my existing forms? =

No. FormBeep never modifies your form's submit action or interferes with existing plugins. It works as a passive notification layer. If FormBeep ever fails, your forms continue to work exactly as before.

= Do I need to rebuild my forms? =

No. FormBeep works with your existing forms as-is. No rebuilding, no migrating, no new form builder to learn.

= Is form data stored permanently? =

No. FormBeep stores form data temporarily until you view it on WhatsApp, then permanently deletes it. If unviewed, it auto-deletes after 7 days. There are no archives or backups of visitor submissions.

= How many notifications do I get on the free plan? =

The free plan includes 15 notifications per month and supports 1 domain and 1 WhatsApp recipient. Paid plans start at $6.99/month for 150 notifications.

= Can multiple people receive notifications? =

Yes, on Pro plan ($24.99/month) and above. You can add up to 2 WhatsApp recipients on Pro, and 5 on Business.

= What happens when I hit my monthly limit? =

On the free plan, notifications pause until the next month. On paid plans, you can upgrade anytime from the FormBeep dashboard.

= Does it work with page builders like Elementor? =

Yes. If you're using Elementor's built-in form widget or any other page builder form, FormBeep picks it up automatically.

= Can I test it before paying? =

Yes. The free plan (15 notifications/month) requires no credit card. Sign up at [formbeep.com](https://formbeep.com).

== Screenshots ==

1. FormBeep settings page — enter your API key and optional custom success message
2. WhatsApp notification — the initial alert with "View Details" button
3. WhatsApp details message — full form data delivered to your phone

== Changelog ==

= 1.0.0 =
* Initial release
* Settings page with API key configuration
* Optional custom success message support
* Admin notice for unconfigured installs
* Automatic script injection in page footer
* External service disclosure on settings page

== Upgrade Notice ==

= 1.0.0 =
Initial release.
