🚀 Facebook Leads Integration & Sync Addon Installation Guide
Important Notice
This addon requires WhatsMarkSaaS version 1.4.0 or higher and MySQL 8. or higher*. Please ensure your main script is updated before proceeding.
Prerequisites
Before installing the Facebook Leads Integration & Sync Addon, make sure you have:
- WhatsMarkSaaS (version 1.4.0 or higher) installed and running
- MySQL 8. or higher* database server
- Meta Developer Account for Facebook API access
- Admin access to your WhatsMarkSaaS dashboard
- Proper server permissions for file uploads and cron jobs
💡 PRO TIP
We recommend setting up your Meta Developer account before beginning the installation process to streamline the integration.
📹 Video Installation Guide
Watch our complete installation walkthrough:
This video covers the complete installation process from download to activation, including plan configuration and initial setup.
Installation Steps
1. Download the Module
- Head to CodeCanyon and download the Facebook Leads Integration & Sync Addon zip file
- You'll receive a zip file containing the module files and documentation
2. Extract Files
- Extract the downloaded zip file
- You'll find the main module files ready for upload
3. Access WhatsMarkSaaS Admin Panel
- Open your web browser
- Navigate to your WhatsMarkSaaS admin dashboard
- Log in using your admin credentials
4. Navigate to Modules Section
- In the admin dashboard, locate the Modules section
- This is typically found in the main navigation menu
- Click to access the module management area
5. Upload the Module
- Click on Upload Module or Install New Module button
- Select the Facebook Leads Integration & Sync Addon zip file
- Click Upload to begin the installation process
- Wait for the upload to complete
6. Install & Activate
- Once uploaded, find the Facebook Leads Integration & Sync Addon in the module list
- Click Install to install the module
- After installation, click Activate to enable the module
- The module will now be active and ready for configuration
7. License Activation
- Enter your CodeCanyon purchase code
- Click Activate License to unlock all features
- Verify the license & module status shows as "Active"
🔑 IMPORTANT
Keep your purchase code secure. Sharing your purchase code can result in your license being blacklisted. Each purchase code is valid for only one production installation.
8. Configure Plan Features
After successful installation:
- Navigate to Admin > Plans & Pricing
- Edit the subscription plans that should include Facebook Lead integration
- Find the Facebook Lead Integration feature textbox and enter 1 to enable it (or 0 to disable)
- Save the plan configuration
📋 PLAN CONFIGURATION EXAMPLE
Here's a typical configuration for enabling Facebook Lead integration:
- Go to Admin > Plans & Pricing
- Select the plan you want to update (e.g., "Professional" or "Enterprise")
- Find the "Features" or "Modules" section
- Locate the "Facebook Lead Integration" feature textbox
- Enter 1 to enable the feature (or 0 to disable)
- Adjust any limits for leads per month if applicable
- Save the changes
- Repeat for other plans as needed
Post-Installation Requirements
⏱️ CRON JOB REQUIREMENT
This module requires a properly configured cron job to process leads automatically.
Server Requirements
- Cron Jobs: Configured for automated lead processing
- Webhook Support: Server must accept incoming webhook requests
- SSL Certificate: Required for secure Facebook webhook communication
- Public URL: Localhost or local development environments are not supported as Meta requires valid static public URLs for webhook responses
🌐 ENVIRONMENT LIMITATION
Localhost or local development environments are not supported for this module as Meta requires valid static public URLs for webhook responses. Make sure to deploy on a production server with a valid domain and SSL certificate.
Meta Developer Setup
Each tenant will need to:
- Create a Meta Developer account
- Set up a business application
- Configure webhook endpoints
- Obtain required permissions for lead retrieval
📘 META DEVELOPER RESOURCES
For detailed instructions on setting up a Meta Developer account and configuring the necessary permissions, refer to our Meta Developer Setup Guide or visit the Meta for Developers official documentation.
Next Steps
Once installation is complete:
- Configure Plan Features: Enable Facebook Lead integration in subscription plans
- Tenant Setup: Guide tenants through Meta Developer app creation
- Test Integration: Verify webhook connectivity and lead processing
- Monitor Performance: Check cron job execution and lead capture rates
🔄 TROUBLESHOOTING
If leads aren't being synchronized properly after installation, check your cron job configuration and webhook setup. Common issues include incorrect webhook URLs or missing Meta permissions.
For detailed configuration steps, refer to the Getting Started Guide.