--- url: >- https://docs.corbitaltech.dev/products/fblead-addon-for-whatsmarks-saas/installation.md description: >- Step-by-step installation for the Facebook Leads Integration & Sync Addon. Upload the addon, configure Meta Business Manager permissions, connect Facebook Page, set lead form mappings, and sync leads to WhatsApp. --- # 🚀 Facebook Leads Integration & Sync Addon Installation Guide *** ::: warning 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 ::: info 💡 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" ::: danger 🔑 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 ::: details 📋 PLAN CONFIGURATION EXAMPLE Here's a typical configuration for enabling Facebook Lead integration: 1. Go to **Admin > Plans & Pricing** 2. Select the plan you want to update (e.g., "Professional" or "Enterprise") 3. Find the "Features" or "Modules" section 4. Locate the "Facebook Lead Integration" feature textbox 5. Enter **1** to enable the feature (or **0** to disable) 6. Adjust any limits for leads per month if applicable 7. Save the changes 8. Repeat for other plans as needed ::: ## Post-Installation Requirements ::: info ⏱️ 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 ::: warning 🌐 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 ::: info 📘 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](/products/fblead-addon-for-whatsmarks-saas/facebook-integration.md) or visit the [Meta for Developers](https://developers.facebook.com/docs/) official documentation. ::: ## Next Steps Once installation is complete: 1. **Configure Plan Features**: Enable Facebook Lead integration in subscription plans 2. **Tenant Setup**: Guide tenants through Meta Developer app creation 3. **Test Integration**: Verify webhook connectivity and lead processing 4. **Monitor Performance**: Check cron job execution and lead capture rates ::: tip 🔄 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](/products/fblead-addon-for-whatsmarks-saas/getting-started.md).