Happilee Forms Connector

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. Enable the forms you want to connect and open their settings
4. Choose the trigger hook, the phone number field and a WhatsApp message template from your Happilee account (only approved templates whose name starts with wp_ are listed)
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), the visitor’s mobile number and country calling code, the form ID, form name and lead source (e.g. “Contact Us-Happilee web”), the submitted form field values mapped to the selected template’s parameters, and the selected template ID. Forms configured in earlier versions of the plugin also send their mapped First Name, Last Name, Birthday and Tags fields.

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 connected form is submitted, the plugin detects the visitor’s country calling code by sending the visitor’s IP address to ipapi.co. Forms configured in earlier versions of the plugin with a Country Code field mapping use the submitted value instead, and only fall back to this lookup when that value is empty.

Data sent: the visitor’s IP address.
When: on submission of a connected form, at most once per submission, unless the country code is already provided 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.).