Description
Happilee Forms Connector seamlessly integrates your WordPress contact forms with the Happilee WhatsApp chatbot platform. As a Meta Business Partner, Happilee provides powerful WhatsApp business solutions, and this plugin bridges your form submissions directly to the Happilee API.
Supported Form Plugins:
- Contact Form 7 (CF7)
- WPForms
- Ninja Forms
- Forminator
Key Features:
- Easy API connection setup with Happilee platform
- Automatic form submission sync to WhatsApp
- Support for multiple popular WordPress form plugins
- Secure API authentication with encrypted storage
- Real-time data transmission
- Simple configuration interface
About Happilee:
Happilee is a Meta Business Partner providing WhatsApp chatbot services that help businesses automate customer communication, lead generation, and support through WhatsApp Business API.
How It Works:
- Install and activate the plugin
- Configure your Happilee API credentials
- Select which forms to connect
- Form submissions automatically sync to your Happilee WhatsApp chatbot
External Services
This plugin connects to the following external services:
1. Happilee API (happilee.io)
This plugin communicates with the Happilee WhatsApp chatbot platform API to:
- Validate your API key and retrieve your project details — sent once when you save your API credentials in the settings page.
- Forward form submission data — sent every time a visitor submits a connected WordPress form.
Data sent to Happilee includes: your API key (for authentication) and submitted form field values (e.g., First Name, Last Name, Mobile, Country Code, Birthday, and Tags).
Data is transmitted to the following Happilee API endpoints:
* https://api.happilee.io/api/v1/getProjectDetails — API key validation
* https://api.happilee.io/api/v1/createContact — form submission forwarding
This service is provided by Happilee (a Meta Business Partner):
* Website: https://happilee.io
* Terms of Service: https://happilee.io/terms-of-use/
* Privacy Policy: https://happilee.io/privacy-policy/
No data is sent to Happilee unless a valid API key has been configured and at least one form has been enabled in the plugin settings.
2. ipapi.co — Country code lookup
When a form is submitted and no country calling code has been mapped to a field, the plugin automatically detects the visitor’s country calling code by sending the visitor’s IP address to ipapi.co.
Data sent: the visitor’s IP address.
When: automatically on every form submission where a country code field is not already populated by the form.
Why: to resolve the correct international phone dialling prefix (e.g. +44, +91) before forwarding the submission to Happilee.
The request is made to:
https://ipapi.co/{visitor_ip}/country_calling_code/
This service is provided by ipapi.co:
* Website: https://ipapi.co
* Terms of Service: https://ipapi.co/terms/
* Privacy Policy: https://ipapi.co/privacy/
Additional Information
Support:
For plugin support, visit https://happilee.io/contact-us/
For Happilee platform support and API documentation, visit your Happilee dashboard.
Privacy:
This plugin transmits form submission data to the Happilee API. Please review Happilee’s privacy policy and ensure compliance with your local data protection regulations (GDPR, CCPA, etc.).
Developer Information
Hooks & Filters:
The plugin provides the following filter hooks for developers:
happfoco_api_validate_endpoint — Override the live Happilee validation endpoint URL
happfoco_api_create_contact_endpoint — Override the live Happilee createContact endpoint URL
Database:
The plugin creates a custom table wp_happfoco_forms_data to store form configuration and field mappings.
Requirements:
– OpenSSL PHP extension (for API key encryption)
– WordPress REST API enabled
– One or more supported form plugins
Screenshots
Installation
- Upload the plugin files to the
/wp-content/plugins/happilee-forms-connectordirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Navigate to Settings Happilee Forms Connector to configure the plugin.
- In the API Configuration section, enter your Happilee API key (available from your Happilee dashboard).
- Save your settings and test the connection.
Requirements:
- Active Happilee account (sign up at https://happilee.io)
- Happilee API key
- One or more supported form plugins installed (CF7, WPForms, Ninja Forms, or Forminator)
FAQ
-
What is Happilee?
-
Happilee is a Meta Business Partner that provides WhatsApp chatbot services for businesses to automate customer communication through WhatsApp Business API.
-
Which form plugins are supported?
-
Currently, the plugin supports Contact Form 7, WPForms, Ninja Forms, and Forminator.
-
Do I need a Happilee account?
-
Yes, you need an active Happilee account and API key. Visit https://happilee.io to create an account.
-
Where do I find my Happilee API key?
-
Log in to your Happilee dashboard and navigate to Project Settings Integrations to find your API key.
-
Is the data transmission secure?
-
Yes, all data is transmitted securely via HTTPS. API keys are encrypted using AES-256-CBC encryption before being stored in the database.
-
Can I connect multiple forms?
-
Yes, you can connect as many forms as you need from any of the supported form plugins.
-
Does this work with custom forms?
-
Currently, the plugin supports the four major form plugins listed. Custom form support may be added in future updates.
-
What data is sent to Happilee?
-
The plugin sends selected form fields such as First Name, Last Name, Country Code, Birth Day, Mobile, and Tags. All data is sent based on the settings configured in the backend. For example, if only First Name and Mobile are selected in the backend settings, then only those fields will be sent to the Happilee API endpoint. Please note that the Mobile field is mandatory for the Happilee backend.
-
How do I verify the plugin is working?
-
After configuring your API key and connecting a form, submit a test form. You should see the submission data in your Happilee dashboard.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Happilee Forms Connector” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Happilee Forms Connector” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.4
- Removed src/ source folder from distributed plugin package
1.0.3
- Removed demo mode, demo API key, and webhook.site endpoint
- Updated readme.txt to remove all demo references and webhook.site External Service disclosure
1.0.2
- Fixed broken Terms of Service and Privacy Policy URLs in External Services section
- Added automatic database table creation on plugins_loaded to prevent missing table errors after migration or manual updates
1.0.1
- Added REST API parameter validation with sanitize_callback and validate_callback for all endpoints
- Fixed missing wp_unslash() on $_POST access in Forminator submission handler
- Fixed redundant double-sanitization of form field values
- Added External Services disclosure section
- Corrected database option cleanup on uninstall (encryption key and db version options now removed)
- Removed development source files from distributed zip
- Updated Tested up to: 6.9
1.0.0
- Initial release
- Support for Contact Form 7
- Support for WPForms
- Support for Ninja Forms
- Support for Forminator
- Happilee API integration with secure encrypted storage
- Settings page for API configuration
- Form field mapping interface
- Real-time form data transmission





