Happilee Forms Connector

Deskripsyon

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
  • WhatsApp template message support with dynamic parameter mapping

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:

  1. Install and activate the plugin
  2. Configure your Happilee API credentials
  3. Select which forms to connect and map the contact fields
  4. Choose a WhatsApp message template from your Happilee account
  5. Map the template’s dynamic parameters (e.g. {{customer_name}}) to your form fields
  6. Form submissions automatically sync to Happilee and trigger the selected WhatsApp template message

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.
  • Fetch available WhatsApp templates — sent once when you configure a form connection.
  • Send WhatsApp template messages — sent every time a connected form is submitted with a template selected.

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
* https://api.happilee.io/api/v1/getTemplateMessages — fetching available WhatsApp templates
* https://api.happilee.io/api/v1/sendMessage — sending WhatsApp template messages on form submission

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.).

Mga Screenshot

  • Plugin settings page with API configuration
  • List of available forms
  • Hook selection and field-mapping interface
  • Integration with Contact Form 7
  • Template listing from the Happilee Dashboard
  • Template preview
  • Template field mapping with preview

Pag-install

  1. Upload the plugin files to the /wp-content/plugins/happilee-forms-connector directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Navigate to Settings Happilee Forms Connector to configure the plugin.
  4. In the API Configuration section, enter your Happilee API key (available from your Happilee dashboard).
  5. 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.

Can I send WhatsApp template messages when a form is submitted?

Yes. After connecting a form, you can select a WhatsApp message template from your Happilee account and map its dynamic parameters (such as {{customer_name}} or {{order_id}}) to the corresponding form fields. When the form is submitted, the plugin automatically sends the template message to the contact’s phone number with the mapped values filled in.

What are template parameters?

Template parameters are dynamic placeholders in your WhatsApp message template, written as {{param_name}}. For example, a delivery template might contain {{pickup_time}} and {{customer_address}}. The plugin lets you map each placeholder to a specific form field so the correct submitted value is inserted when the message is sent.

What happens if a template has no parameters?

Templates without dynamic parameters are fully supported. The plugin will send the template message as-is without requiring any field mapping.

Mga Review

Wala pang reviews para sa plugin na ito.

Mga Contributor at Developer

Ang “Happilee Forms Connector” ay open source software. Ang mga sumusunod na tao ay nag-ambag sa plugin na ito.

Mga Contributor

Isalin ang “Happilee Forms Connector” sa iyong wika.

Interesado sa development?

Tingnan ang code, i-check ang SVN repository, o mag-subscribe sa development log sa pamamagitan ng RSS.

Changelog

1.0.7

  • Added WhatsApp template message sending on form submission
  • Added template selection interface with search and pagination
  • Added template parameter mapping to form fields
  • Added live WhatsApp-style message preview in template settings
  • Added support for templates with no dynamic parameters
  • Added deduplication guard across all supported form plugins
  • Improved param mapping to use original form field names for accurate value resolution

1.0.6

  • Removed README.md from distributed plugin package

1.0.5

  • Fixed issue with form_id type mismatch
  • Improved validation for form_type

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