Setup

डेटा एनरिचमेंट (जेनेरिक कनेक्टर)

अपने पसंदीदा एनरिचमेंट प्रोवाइडर (Clearbit, Apollo, Hunter, People Data Labs, जो भी आप चाहें) की ओर इशारा करें और कंपनियों व संपर्कों की खाली फ़ील्ड्स को स्वचालित रूप से भरें।

डेटा एनरिचमेंट एक जेनेरिक, न्यूट्रल कनेक्टर है: आप अपने पसंदीदा एनरिचमेंट प्रोवाइडर (Clearbit, Apollo, Hunter, People Data Labs, आदि में से) का खाता उपयोग करते हैं। आप प्रोवाइडर का पता, ऑथेंटिकेट करने का तरीका और एक फ़ील्ड mapping देते हैं; CRM प्रोवाइडर से पूछताछ करता है और रिकॉर्ड की केवल खाली फ़ील्ड्स भरता है। हमारी तरफ से कोई लागत नहीं है, और खाता व बिलिंग आपके चुने प्रोवाइडर के हैं।

कनेक्टर निष्क्रिय शुरू होता है: जब तक आप इसे कॉन्फ़िगर नहीं करते, कुछ नहीं होता। आपके द्वारा दी गई API key एन्क्रिप्टेड सहेजी जाती है और कभी वापस नहीं दिखाई जाती।

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

सक्रिय API key और पर्याप्त क्रेडिट्स/प्लान के साथ एनरिचमेंट प्रोवाइडर (Clearbit, Apollo, Hunter, People Data Labs या अन्य) का खाता।
उस प्रोवाइडर का API डॉक्यूमेंटेशन हाथ में: endpoint, ऑथेंटिकेशन header (जैसे, Authorization: Bearer, या X-Api-Key) और रिस्पॉन्स JSON की संरचना (mapping बनाने के लिए)।
Sellio में, Settings → Integrations में कनेक्टर सहेजने के लिए व्यवस्थापक एक्सेस।

प्रोवाइडर पर चरण-दर-चरण

अपने एनरिचमेंट प्रोवाइडर के डैशबोर्ड में साइन इन करें और API/Developers क्षेत्र ढूँढें।
API key जनरेट करें (या कॉपी करें)।
domain और/या email से पूछताछ करने का endpoint और आवश्यक ऑथेंटिकेशन header का सटीक फ़ॉर्मैट नोट करें। हर प्रोवाइडर का अपना होता है।

कॉन्फ़िगर कैसे करें

Settings → Integrations खोलें और "डेटा एनरिचमेंट" कार्ड पर जाएँ।
Endpoint (URL): प्रोवाइडर का पता {domain} और/या {email} placeholders का उपयोग करके पेस्ट करें। CRM {domain} को रिकॉर्ड के domain से (website/domain या ईमेल domain से) और {email} को रिकॉर्ड के ईमेल से बदल देता है।
Authentication header और Prefix: header का नाम (जैसे, Authorization) और value prefix (जैसे, स्पेस के साथ "Bearer ") दर्ज करें। कुछ प्रोवाइडर अपना खुद का header इस्तेमाल करते हैं, जैसे X-Api-Key, बिना prefix के।
API key: अपनी प्रोवाइडर key पेस्ट करें। यह एन्क्रिप्टेड सहेजी जाती है।
Field mapping: हर पंक्ति प्रोवाइडर के रिस्पॉन्स में एक पथ (बाईं ओर) को एक CRM फ़ील्ड (दाईं ओर) से जोड़ती है। जितनी जरूरत हो उतनी पंक्तियाँ जोड़ें।
कनेक्टर सहेजें। फिर, किसी Company या Contact डिटेल पर, "समृद्ध करें" बटन का उपयोग करें।

mapping कैसे बनाएँ

बाईं ओर प्रोवाइडर के JSON रिस्पॉन्स के भीतर वैल्यू का पथ है, स्तर नीचे जाने के लिए dots (और लिस्ट पोज़िशन के लिए numbers) का उपयोग करते हुए। दाईं ओर उस CRM फ़ील्ड का api_name है जो वैल्यू प्राप्त करेगी। केवल खाली फ़ील्ड्स भरी जाती हैं: रिकॉर्ड में पहले से मौजूद डेटा कभी ओवरराइट नहीं होता।

Example: Endpoint: https://api.provider.com/v1/company?domain={domain} • Header: Authorization • Prefix: "Bearer " • Mapping: company.name → name, company.metrics.employees → employee_count, company.location.country → country

💡 अगर रिस्पॉन्स लिस्ट लौटाता है, तो index का उपयोग करें: contacts.0.email पहली आइटम का email लेता है। पूरे objects या lists वाली वैल्यू अनदेखी की जाती हैं; केवल साधारण वैल्यू (text, number) किसी फ़ील्ड में फिट होती हैं।

एनरिच करने के लिए, रिकॉर्ड में कम से कम website/domain या email होना चाहिए, क्योंकि यहीं से पूछताछ का {domain}/{email} आता है। कंपनियों के पास आमतौर पर website होती है; संपर्कों और leads के पास, email।

अपना कोई प्रोवाइडर नहीं: system मोड और simulated मोड

अगर आप अपना प्रोवाइडर कॉन्फ़िगर नहीं करते, तो "समृद्ध करें" बटन फिर भी उपलब्ध रहता है। जब Sellio में system प्रोवाइडर सक्षम है, तो हर एनरिचमेंट मानक firmographic फ़ील्ड्स (employees, revenue, industry, technologies, LinkedIn, country) भरता है और प्रति रिकॉर्ड 1 credit उपयोग करता है, जो आपके invoice पर पारदर्शी रूप से बिल किया जाता है। बिना किसी प्रोवाइडर के, CRM simulated sample डेटा उपयोग करता है (कोई लागत नहीं), जो फ़्लो आज़माने के लिए सुविधाजनक है। Integrations कार्ड दिखाता है कि कौन सा मोड सक्रिय है।

बल्क और स्वचालित एनरिचमेंट

Bulk: Companies, Contacts या Leads सूची में कई रिकॉर्ड्स चुनें और एक्शन बार में "समृद्ध करें" पर क्लिक करें। CRM उन सभी को एक साथ एनरिच करता है, केवल खाली फ़ील्ड्स भरता है।
बनाने पर स्वचालित: Settings → Integrations में, "रिकॉर्ड बनने पर अपने आप एनरिच करें" चालू करें। बनते ही हर नई कंपनी, संपर्क या lead की खाली फ़ील्ड्स भर जाती हैं।
दैनिक catch-up: एक स्वचालित रूटीन उन tenants के हाल के रिकॉर्ड्स की समीक्षा करता है जिनके पास यह विकल्प चालू है और दैनिक सीमा के भीतर जो भी लंबित है उसे पूरा करता है। एक ही रिकॉर्ड को फिर से प्रोसेस करने पर कभी दो बार चार्ज नहीं होता।

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

एक ऐसी Company खोलें जिसमें website/domain हो (या email वाला Contact) जिसकी फ़ील्ड्स आंशिक रूप से खाली हों।
"समृद्ध करें" पर क्लिक करें।
जाँचें कि खाली फ़ील्ड्स आपके mapping के अनुसार भरी गईं। JSON पथों को मान्य करने के लिए प्रोवाइडर के अपेक्षित रिस्पॉन्स से तुलना करें।

समस्या निवारण

प्रोवाइडर से 401/403: गलत/एक्सपायर्ड API key या गलत ऑथेंटिकेशन header। header का नाम और prefix जाँचें (जैसे, स्पेस के साथ "Bearer ") और key फिर से पेस्ट करें।
कुछ नहीं भरता: जाँचें कि mapping पथ प्रोवाइडर के वास्तविक JSON से मेल खाते हैं (स्तर नीचे जाने के लिए dots और lists के लिए indices का उपयोग करें, जैसे, contacts.0.email)। केवल साधारण वैल्यू (text/number) किसी फ़ील्ड में फिट होती हैं; पूरे objects/lists अनदेखी की जाती हैं।
प्रोवाइडर के डेटा देने पर भी कुछ फ़ील्ड्स अपडेट नहीं होतीं: एनरिचमेंट केवल खाली फ़ील्ड्स में लिखता है। अगर किसी फ़ील्ड में पहले से वैल्यू है, तो वह डिज़ाइन के अनुसार सुरक्षित रहती है।
"समृद्ध करें" बटन कुछ नहीं करता: पुष्टि करें कि रिकॉर्ड में website/domain या email है (पूछताछ {domain}/{email} का उपयोग करती है) और endpoint उन placeholders का उपयोग करता है।
404/invalid endpoint: endpoint URL की समीक्षा करें और क्या प्रोवाइडर पूछताछ में domain या email की अपेक्षा करता है।

Open this article inside the system →