Mansico Meta Integration

bench get-app https://github.com/Ahmed-Mansy-Mansico/mansico_meta_integration

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=Ahmed-Mansy-Mansico%2Fmansico_meta_integration)](https://frappegems.com/gems/apps/Ahmed-Mansy-Mansico/mansico_meta_integration)

# Mansico Meta Integration **Mansico Meta Integration** is an open-source application designed to automate the synchronization of Facebook leads with ERPNext. When clients fill out Facebook Ads instant forms, the app automatically fetches the newly created leads and generates corresponding entries in ERPNext's **Lead** doctype. Additionally, when the Lead Status is updated in ERPNext, the new status is sent back to the Meta Pixel for real-time tracking and analytics. --- ## Key Features - **Automated Lead Sync**: Fetches new leads from Facebook Ads instant forms and creates them in ERPNext automatically. - **Real-Time Status Updates**: Sends updated lead statuses from ERPNext back to the Meta Pixel for enhanced tracking. - **Customizable Sync Frequency**: Configure how often the app fetches new leads (e.g., every 15 minutes, hourly, etc.). - **Seamless Integration**: Works with Meta Business Accounts, Marketing API, and ERPNext for a smooth setup process. - **Open-Source and Extendable**: Fully customizable to meet specific business needs. --- ## Installation ### Frappe Cloud (One-Click Install) Great new now available for FREE on [Frappe Cloud Marketplace](https://frappecloud.com/marketplace/apps/mansico_meta_integration). Stay tuned for updates! ### Self-Hosting 1. **Clone the App Repository**: ```bash bench get-app https://github.com/splinter-NGoH/mansico_meta_integration.git ``` 2. **Install the App**: ```bash bench --site [your.site.name] install-app mansico_meta_integration ``` 3. **Run Database Migrations**: ```bash bench --site [your.site.name] migrate ``` --- ## Facebook Requirements To use this integration, you need the following: 1. **Meta Business Account**: - If you don’t already have one, create a [Meta Business Account](https://www.facebook.com/business/help/1710077379203657?id=180505742745347). 2. **Meta App**: - Create a Meta App to access the Marketing API. Follow the steps below:  3. **Marketing API Setup**: - Enable the Marketing API for your app.  4. **Access Token for System User**: - Go to **Meta Settings > Users > System Users** and add a new user or use an existing one. - Assign the necessary permissions (`leads_retrieval`, `manage_pages`, `ads_management`, `business_management`). - Generate an access token and copy it.  5. **Pixel ID and Pixel Access Token**: - Go to **Events Manager** in your Meta Business Account. - Locate your Pixel ID and generate a Pixel Access Token.  --- ## Configuration in ERPNext 1. **Meta Facebook Settings**: - Paste the **Access Token** in the respective field. - Set the **API URL** (e.g., `https://graph.facebook.com`) and **Graph API Version** (e.g., `v16.0`).  2. **Page ID Doctype**: - Add your Facebook Page Name, Page ID, Pixel ID, and Pixel Access Token.  3. **Sync New Lead**: - Create a new sync job and configure the **Event Frequency** (e.g., every 15 minutes). - Ensure the **Lead Status Mapping** is correctly set up.  4. **Schedule Job**: - The sync job will be queued. You can manually execute it from **Schedule Job Type**.  5. **Verify Leads**: - Check the **Lead** doctype to confirm that new leads have been created. --- ## Support the Project If you find this project useful, consider supporting its development! Your contributions help maintain and improve the app. [](https://paypal.me/AhmedMansyArt?country.x=EG&locale.x=en_US) --- ## Dependencies - [Frappe Framework](https://github.com/frappe/frappe) - [ERPNext](https://github.com/frappe/erpnext) --- ## License This project is licensed under the **MIT License**. See the [LICENSE](https://github.com/splinter-NGoH/mansico_meta_integration/blob/main/LICENSE) file for details. --- ## Contributing We welcome contributions from the community! To contribute: 1. Fork the repository. 2. Create a new branch for your feature or bug fix. 3. Submit a pull request with a detailed description of your changes. --- ## Support For support or questions, open an issue on the [GitHub repository](https://github.com/splinter-NGoH/mansico_meta_integration) or contact the maintainers. --- ## Important Note This app is actively maintained, and new updates will be released regularly. Don’t forget to ⭐️ the repository to show your support! Pull requests from developers are highly encouraged. Cheers from Mansy! 🚀