# 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](/facebook-and-instagram-leads-integration-module/help-and-support/troubleshooting.md) page
* ❓ Browse the [FAQ](/facebook-and-instagram-leads-integration-module/help-and-support/faq.md)
* 📧 Contact us at <support@themesic.com>
* 🌐 Visit [themesic.com/support](https://themesic.com/support)

***

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://themesic-docs.gitbook.io/facebook-and-instagram-leads-integration-module/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.