# Welcome

## Facebook & Instagram Leads Integration Module

<figure><img src="https://img.shields.io/badge/Version-2.0.0-blue" alt="Version 2.0.0"><figcaption></figcaption></figure>

> **Automatically capture leads from Facebook & Instagram Lead Ads and sync them directly into your Perfex CRM — in real-time, with zero manual work.** 🚀

***

## 🤔 What Does This Module Do?

In simple terms:

1. 👤 Someone sees your **Facebook or Instagram ad**
2. 📝 They fill out a **lead form** (right inside Facebook/Instagram — no website needed!)
3. ⚡ The lead is **instantly sent** to your Perfex CRM
4. 🎉 You get a **new lead** with all their info, ready to follow up

**No copy-pasting. No CSV exports. No delays. Fully automatic.** ✨

***

## 🌟 Key Features

| Feature                     | Description                                                |
| --------------------------- | ---------------------------------------------------------- |
| ⚡ **Real-Time Sync**        | Leads arrive in your CRM within seconds                    |
| 📱 **Facebook + Instagram** | Works with both platforms (same setup!)                    |
| 📄 **Multiple Pages**       | Monitor multiple Facebook Pages at once                    |
| 🔀 **Field Mapping**        | Map Facebook form fields to any Perfex CRM field           |
| 🔁 **Retry Queue**          | Failed syncs automatically retry                           |
| 🔍 **Duplicate Detection**  | Prevents importing the same lead twice                     |
| 📊 **Sync History**         | Full log of every lead sync (success, failed, skipped)     |
| 🧙 **Setup Wizard**         | Guided step-by-step setup in minutes                       |
| 🧪 **Test Lead**            | One-click button to test the full flow                     |
| 📧 **Email Notifications**  | Get notified when new leads arrive                         |
| 🔒 **Secure**               | Webhook signature verification, server-side token exchange |

***

## ⏱️ How Long Does Setup Take?

> **About 10-15 minutes** if you follow this guide step by step. ☕

Here's the overview:

```
📦 Install module in Perfex CRM     →  2 minutes
🏗️ Create Meta App                  →  3 minutes
🔗 Configure Webhook                →  2 minutes
📄 Connect your Facebook Page       →  2 minutes
🎯 Create a Lead Ad campaign        →  5 minutes
✅ Done! Leads flow automatically!
```

***

## 📚 How to Use This Guide

👈 Use the **sidebar** to navigate through the sections in order:

1. **Getting Started** — Check requirements and install the module
2. **Facebook App Setup** — Create your Meta app and configure the webhook
3. **Module Configuration** — Configure the module settings in Perfex CRM
4. **Lead Ads** — Learn about Lead Ads and create your first campaign
5. **Help & Support** — Troubleshooting, FAQ, and changelog

> 💡 **Tip:** Follow the guide from top to bottom for the best experience. Each step builds on the previous one!

***

## 🆘 Need Help?

* 📖 Check the [Troubleshooting](https://themesic-docs.gitbook.io/facebook-and-instagram-leads-integration-module/help-and-support/troubleshooting) page
* ❓ Browse the [FAQ](https://themesic-docs.gitbook.io/facebook-and-instagram-leads-integration-module/help-and-support/faq)
* 📧 Contact us at <support@themesic.com>
* 🌐 Visit [themesic.com/support](https://themesic.com/support)

***

**Ready to get started? Let's go! 👉** [**Requirements**](https://themesic-docs.gitbook.io/facebook-and-instagram-leads-integration-module/getting-started/requirements)