Lead Ads (Meta और LinkedIn)

आपके Facebook/Instagram विज्ञापनों (Meta Lead Ads) या LinkedIn विज्ञापनों (Lead Gen Forms) के माध्यम से सबमिट किया गया हर फ़ॉर्म आपके अपने ऐप (BYO मॉडल) का उपयोग करते हुए CRM में एक Lead बन जाता है।

Lead Ads इंटीग्रेशन आपके अपने ऐप और आपके अपने पेज/एड अकाउंट का उपयोग करता है (यह BYO, यानी "अपना खुद का ऐप लाओ", मॉडल है)। जब कोई Facebook/Instagram (Meta) या LinkedIn विज्ञापन में लीड फ़ॉर्म भरता है, तो CRM स्वचालित रूप से एक Lead बनाता है और पब्लिक फ़ॉर्म कैप्चर की तरह ही राउंड-रॉबिन से एक ओनर असाइन करता है। डेटा सीधे आपके एड अकाउंट से आता है, हमारी तरफ से कोई मध्यस्थता नहीं है।

इंटीग्रेशन निष्क्रिय अवस्था में शुरू होता है: जब तक आप क्रेडेंशियल भरकर इसे चालू नहीं करते, तब तक कुछ नहीं होता। App Secret और एक्सेस टोकन CRM में एन्क्रिप्टेड रूप में सहेजे जाते हैं और आपको कभी वापस नहीं दिखाए जाते।

पूर्वापेक्षाएँ

• Meta: developers.facebook.com पर एक ऐप, विज्ञापन चलाने वाला एक Facebook Page, और leads_retrieval व pages_manage_metadata अनुमतियाँ; आपको App Secret और एक long-lived page access token की आवश्यकता होगी।
• LinkedIn: linkedin.com/developers पर एक ऐप जिसकी Lead Sync / Advertising API तक पहुँच हो और r_marketing_leadgen_automation स्कोप वाला एक OAuth access token।
• आपके कैंपेन में पहले से बने Lead फ़ॉर्म (Meta Lead Ads / LinkedIn Lead Gen Forms)।
• Sellio में, क्रेडेंशियल सहेजने और Settings → Integrations में इंटीग्रेशन सक्षम करने के लिए एडमिनिस्ट्रेटर एक्सेस।

Meta (Facebook/Instagram) कैसे काम करता है

Meta वेबहुक फ़ॉर्म का डेटा नहीं भेजता। यह सिर्फ़ एक पहचानकर्ता (leadgen_id) भेजता है। प्राप्त होने पर, CRM इवेंट सिग्नेचर सत्यापित करता है (आपके App Secret से बॉडी का HMAC-SHA256) और फिर आपके page access token का उपयोग करके Meta Graph API से लीड को FETCH करता है, सबमिट किए गए फ़ील्ड (field_data) प्राप्त करते हुए। वे फ़ील्ड Lead फ़ील्ड में मैप किए जाते हैं और Lead बनाई जाती है।

Meta कॉन्फ़िगर करें: Meta डैशबोर्ड में

1. developers.facebook.com पर एक ऐप बनाएं (या उपयोग करें)। Settings → Basic में, App Secret कॉपी करें।
2. "वेबहुक" प्रोडक्ट और Leadgen ऑब्जेक्ट/प्रोडक्ट (Leads Access) जोड़ें। अपने पेज के लिए leads_retrieval और pages_manage_metadata अनुमतियाँ अनुरोधित करें।
3. उस पेज के लिए एक long-lived page access token बनाएं जो विज्ञापन चलाता है (Graph API Explorer या Business Manager)।
4. सब कुछ तैयार रखें: आप App Secret, page token, और एक "वेरिफाई टोकन" (आपके द्वारा चुनी गई एक स्ट्रिंग) CRM में पेस्ट करेंगे।

Meta कॉन्फ़िगर करें: CRM में

1. Settings → Integrations खोलें और "Meta Lead Ads (Facebook/Instagram)" कार्ड खोजें।
2. Verify token: कोई भी स्ट्रिंग चुनें और उसे टाइप करें। आप Meta डैशबोर्ड में भी वही मान उपयोग करेंगे।
3. App Secret और Page access token: दोनों पेस्ट करें (वे साथ में, एन्क्रिप्टेड सहेजे जाते हैं) और "क्रेडेंशियल सहेजें" पर क्लिक करें।
4. दिखाई देने वाला "वेबहुक URL (Meta)" कॉपी करें।
5. वापस Meta डैशबोर्ड → Webhooks में, उस URL को Callback URL के रूप में और अपने verify token को Verify Token के रूप में पेस्ट करें। Meta एक हैंडशेक (GET) करता है, और यदि verify token मेल खाता है तो CRM चैलेंज का जवाब देता है।
6. अपने पेज के "leadgen" फ़ील्ड की सदस्यता लें। फिर CRM पर वापस जाएं और "Enable" पर क्लिक करें।

LinkedIn कॉन्फ़िगर करें

LinkedIn (Lead Gen Forms) पर, linkedin.com/developers पर एक ऐप बनाएं, Lead Sync / Advertising API प्रोडक्ट अनुरोधित करें, और lead gen स्कोप (r_marketing_leadgen_automation) वाला एक OAuth access token बनाएं। CRM में, "LinkedIn Lead Gen Forms" कार्ड पर, access token (और वैकल्पिक रूप से organization URN) पेस्ट करें, सहेजें, और सक्षम करें। अपने ऑटोमेशन (या फ़ॉर्म रिस्पॉन्स के pull) को "इनबाउंड URL (LinkedIn)" पर पॉइंट करें, फ़ॉर्म फ़ील्ड के साथ एक JSON भेजते हुए।

फ़ील्ड मैपिंग

हर मैपिंग रो विज्ञापन फ़ॉर्म के एक फ़ील्ड के NAME (बाईं ओर) को एक Lead फ़ील्ड (दाईं ओर, api_name द्वारा: email, name, phone, company, title…) से जोड़ती है। समझदार डिफ़ॉल्ट पहले से शामिल हैं: full_name → name, email → email, phone_number → phone, company_name → company। अपने फ़ॉर्म के कस्टम फ़ील्ड के लिए ही रो जोड़ें। यदि फ़ॉर्म first_name और last_name अलग-अलग भेजता है (LinkedIn पर सामान्य), तो उन्हें name में जोड़ दिया जाता है।

वेबहुक URL, App Secret और टोकन को सीक्रेट मानें। अमान्य सिग्नेचर अस्वीकार कर दिए जाते हैं (401)। page access token के बिना, CRM Graph API से लीड डेटा फ़ेच नहीं कर सकता, यही कारण है कि आप टोकन को App Secret के साथ पेस्ट करते हैं। एक सीमा ध्यान देने योग्य है: नेटिव LinkedIn pull (leadNotifications की सदस्यता लेना और फिर API के ज़रिए रिस्पॉन्स फ़ेच करना) यहाँ दस्तावेज़ीकृत है और इसे जोड़ा जा सकता है; आज यह रूट पहले से सामान्यीकृत फ़ॉर्म रिस्पॉन्स पेलोड प्राप्त करता है।

कैसे टेस्ट करें

1. Meta: Meta डैशबोर्ड → Webhooks में, जब आप Callback URL सहेजते हैं तो हैंडशेक (GET) पहले से verify token को मान्य करता है। फिर अपने फ़ॉर्म पर टेस्ट लीड भेजने के लिए Meta के "Lead Ads Testing Tool" (developers.facebook.com/tools/lead-ads-testing) का उपयोग करें।
2. CRM में जांचें: मैप किए गए फ़ील्ड के साथ एक नई Lead दिखाई देनी चाहिए; यदि कोई कंपनी आई है, तो Company ढूंढी/बनाई जाती है और लिंक की जाती है।
3. LinkedIn: "इनबाउंड URL (LinkedIn)" पर एक फ़ॉर्म रिस्पॉन्स पेलोड ट्रिगर करें (या मैन्युअल रूप से भेजें) और बनाई गई Lead जांचें।

समस्या-समाधान

• Meta हैंडशेक विफल होता है: CRM में टाइप किया गया verify token Meta डैशबोर्ड के Verify Token से बिल्कुल मेल खाना चाहिए। उन्हें मिलाएं और सहेजें।
• आपको वेबहुक मिलता है लेकिन कोई Lead नहीं बनती: page access token के बिना, CRM Graph API से field_data फ़ेच नहीं करता। App Secret के साथ page token भी पेस्ट करें। leads_retrieval/pages_manage_metadata अनुमतियों और पेज के "leadgen" फ़ील्ड की सदस्यता की पुष्टि करें।
• अमान्य सिग्नेचर (401): CRM में App Secret Meta ऐप से अलग है (सिग्नेचर App Secret से बॉडी का HMAC-SHA256 है)। सही App Secret फिर से पेस्ट करें।
• बिना ईमेल वाली लीड अनदेखी हो जाती है: ईमेल ही एकमात्र आवश्यक Lead फ़ील्ड है। सुनिश्चित करें कि विज्ञापन फ़ॉर्म में एक ईमेल फ़ील्ड है।
• फ़ील्ड नहीं भर रहे: Mapping की समीक्षा करें (फ़ॉर्म फ़ील्ड नाम से Lead api_name)। LinkedIn पर, first_name + last_name स्वचालित रूप से name में जोड़ दिए जाते हैं।

Open this article inside the system →