Changelog

All notable changes to the Facebook & Instagram Leads Integration module are documented here.

[2.0.0] - 2026-02-05

Per-Page Lead Assignment - Assign different staff members to different Pages (leads from Page A go to Alice, leads from Page B go to Bob)
Instagram Lead Ads Support - Full support for Instagram Lead Ads (same webhook, automatic)
Setup Wizard - Guided 5-step setup wizard for first-time configuration
Sync History Dashboard - View all lead syncs with status, timestamps, and details
Connection Test - One-click button to verify credentials and permissions
Test Lead - Send a test lead to verify the integration is working
Duplicate Detection - Configurable option to prevent importing the same lead twice
Field Mapping Interface - Visual interface to map custom form fields to Perfex CRM fields
Retry Queue - Automatic retry mechanism for failed lead syncs
Email Notifications - Get notified when new leads arrive from Facebook/Instagram
Webhook Verification Status - Visual indicator showing if webhook is verified
Statistics Dashboard - Real-time stats showing sync success/failure rates
Sidebar Navigation - Easy access to all features from the sidebar
Database Logging - Comprehensive logging of all sync activities
Custom Field Support - Map to any Perfex CRM custom field

Graph API Version - Updated from v5.0 to v19.0 (latest stable)
Token Exchange - Moved to server-side for security (App Secret no longer in JavaScript)
Webhook Handler - Completely rewritten with async processing and instant 200 response
Settings Interface - Modern, intuitive design with better organization
Pages Management - Improved subscription interface with status indicators and lead counts
Error Handling - Better error messages and user feedback throughout

Critical: Fixed missing Facebook PHP SDK reference
Critical: Fixed webhook handler session dependency that caused lead loss
Security: Removed App Secret from client-side JavaScript
Security: Added proper input validation and sanitization
Security: Removed debug file writes from production code
Security: Added webhook signature verification (X-Hub-Signature-256)
Bug: Fixed CSRF exclusion (now uses proper hooks instead of config modification)
Bug: Fixed country lookup for international leads