CRM Meta Leadgen Webhook (Facebook + Instagram)
by Rahul https://www.linkedin.com/in/rahul-yadav-659b972a8$ 253.09
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
CRM (crm)
• Calendar (calendar) • Contacts (contacts) • Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 2514 |
| Technical Name |
crm_meta_leadgen_webhook |
| License | OPL-1 |
| Website | https://www.linkedin.com/in/rahul-yadav-659b972a8 |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
CRM (crm)
• Calendar (calendar) • Contacts (contacts) • Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 2514 |
| Technical Name |
crm_meta_leadgen_webhook |
| License | OPL-1 |
| Website | https://www.linkedin.com/in/rahul-yadav-659b972a8 |
| Versions | 17.0 18.0 19.0 |
CRM Meta Leadgen Webhook
Receive Facebook & Instagram leads instantly in your Odoo CRM â the moment a prospect submits a form
No cron delays • HMAC-SHA256 security • Works with both Facebook & Instagram Lead Ads
Why Real-Time Lead Delivery Changes Everything
With cron-based polling, your leads arrive every 8 minutes at best. That's 8 minutes where a hot prospect is waiting, losing interest, or clicking on a competitor's ad.
With this webhook module, the lead lands in your Odoo CRM within seconds of the prospect hitting "Submit" on Facebook or Instagram. Your sales team can follow up while the prospect is still on their phone.
How Instant Delivery Works
Key Features
â¡ Instant Real-Time Delivery
Leads arrive in your CRM within seconds of form submission. No polling, no cron jobs, no 8-minute delays. Meta pushes the data directly to your Odoo server the moment it happens.
ð HMAC-SHA256 Security
Every incoming webhook is cryptographically verified using HMAC-SHA256 with your App Secret. Spoofed or tampered requests are automatically rejected â only genuine Meta notifications create leads.
ð± Facebook + Instagram in One Endpoint
A single webhook URL handles leads from both Facebook and Instagram Lead Ads. The module automatically detects the source and routes each lead through the correct creation pipeline.
ð One-Click Page Subscription
Each Facebook and Instagram page gets a "Subscribe to Webhook" button directly on its form view in Odoo. One click and the page starts receiving instant leads â no manual API calls needed.
ð Keep Crons as Safety Net
The existing scheduled fetchers from the Facebook and Instagram modules can run alongside as a safety net (just increase their interval to 6â12 hours). If a webhook is ever missed, the cron catches it.
ð¡ï¸ Duplicate Prevention
Batch SQL-level duplicate checks ensure the same lead is never created twice, even if Meta retries the webhook or the cron also picks it up. Zero duplicates guaranteed.
Setup Guide â Odoo Side
Install This Module
Ensure CRM Facebook Lead Integration and CRM Instagram Lead Integration are already installed and configured. Then install this module.
Configure Webhook Settings
Go to Settings â Meta Webhook. Set the Verify Token (any secret string you choose) and the Graph API Version (default: v21.0).
Subscribe Pages
On each Facebook Page or Instagram Page record in Odoo, click "Subscribe to Webhook". This registers the page with Meta's leadgen webhook.
Setup Guide â Meta App Dashboard
You need to configure the webhook endpoint in your Meta App Dashboard so that Meta knows where to send lead notifications. Here's what to do:
Step 1: Open Your Meta App
Go to Meta App Dashboard â My Apps and select the app you use for lead ads.
Step 2: Add the Webhooks Product
In the left sidebar, click "Add Product" and add "Webhooks" if not already added. Then go to Webhooks configuration.
Step 3: Configure Page Webhooks
Select the "Page" object. Click "Edit Subscription" (or "Subscribe to this object") and enter:
- Callback URL:
https://your-odoo-domain.com/meta/leadgen/webhook - Verify Token: the exact same token you set in Odoo Settings â Meta Webhook
Click "Verify and Save". Meta will send a GET challenge to your server â if the tokens match, it will confirm successfully.
Step 4: Subscribe to the "leadgen" Field
Under the Page subscriptions, find the "leadgen" field and click "Subscribe". This tells Meta to send lead notifications to your webhook. See Meta Lead Ads Webhook documentation.
Step 5: Ensure Your App Is in Live Mode
Your Meta App must be in Live Mode (not Development) for real lead delivery. Check the toggle at the top of the App Dashboard. See App Modes documentation.
Helpful Meta Documentation Links:
• Lead Ads Overview
• Retrieving Leads via Webhooks
• Webhooks Getting Started Guide
• Page Leadgen Webhook Reference
• Meta App Dashboard
Compatibility & Requirements
| Requirement | Details |
|---|---|
| Odoo Version | 17.0 (Community & Enterprise) |
| Dependencies | CRM Facebook Lead Integration, CRM Instagram Lead Integration |
| Graph API | Configurable â default v21.0 |
| HTTPS Required | Yes â Meta only sends webhooks to HTTPS endpoints |
| License | OPL-1 (Odoo Proprietary License) |
Need Help or Have Questions?
Reach out for support, customization requests, or integration assistance.
Contact Author on LinkedInDeveloped with â¤ï¸ by Rahul
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module