**[Papo](https://papo.global/) की REST API के साथ, आप अपनी साइट पर एक endpoint बना सकते हैं जो रजिस्ट्रेशन फ़ॉर्म का डेटा प्राप्त करता है और contacts API को कॉल करके CRM में कस्टम attributes सहित रिकॉर्ड स्वचालित रूप से बनाता है — मैन्युअल टाइपिंग खत्म करता है और लीड्स का इंटीग्रेशन तेज़ करता है।**

स्प्रेडशीट निर्यात करने या सिस्टम के बीच डेटा कॉपी करने के बजाय, यह इंटीग्रेशन आपकी साइट पर हर नए रजिस्ट्रेशन को रीयल-टाइम में Papo CRM का संपर्क बना देता है। फ़्लो सरल है: फ़ॉर्म डेटा आपके नियंत्रित backend को भेजता है, वह backend Papo API में प्रमाणित होता है और नाम, ईमेल, फ़ोन तथा आपके ऑपरेशन को ज़रूरी किसी भी कस्टम फ़ील्ड के साथ संपर्क बनाता है।

## इंटीग्रेशन का सारांश

| घटक | यह क्या करता है | उदाहरण |
| :--- | :--- | :--- |
| साइट पर फ़ॉर्म | लीड का नाम, ईमेल, फ़ोन और अतिरिक्त फ़ील्ड एकत्र करता है। | कैप्चर पेज, लैंडिंग पेज, चेकआउट। |
| मध्यस्थ endpoint | फ़ॉर्म का डेटा प्राप्त करता है और Papo API को कॉल करता है। | Node.js, Python में स्क्रिप्ट या n8n/Zapier में ऑटोमेशन। |
| Papo contacts API | भेजे गए डेटा के साथ CRM में संपर्क बनाता है। | सीक्रेट key से प्रमाणित POST अनुरोध। |
| कस्टम attributes | संपर्क में origem, रुचि या स्कोर जैसे फ़ील्ड जोड़ता है। | `custom_attributes` के साथ `"origem": "site"`, `"plano_interesse": "gold"`। |

## यह कैसे काम करता है: चरण-दर-चरण

1. **Papo पैनल में API keys जनरेट करें**  
   अपने Papo अकाउंट के डेवलपर क्षेत्र में जाएँ और एक सीक्रेट key बनाएँ। अकाउंट की पब्लिक key भी इसी स्क्रीन पर दिखाई देती है। सीक्रेट key केवल एक बार दिखाई देती है; इसे सुरक्षित जगह रखें और कभी frontend में उजागर न करें।

2. **अपनी साइट पर फ़ॉर्म बनाएँ**  
   CRM में भेजने के लिए इच्छित फ़ील्ड के साथ फ़ॉर्म बनाएँ: नाम, ईमेल, फ़ोन और कोई भी अतिरिक्त डेटा (रुचि, origem, शहर आदि)। फ़ॉर्म को अगले चरण में बनाए जाने वाले endpoint पर HTTP (POST) अनुरोध करना चाहिए।

3. **मध्यस्थ endpoint बनाएँ**  
   अपने सर्वर या serverless फ़ंक्शन (Node.js, Python, PHP आदि) में एक route बनाएँ जो फ़ॉर्म का डेटा प्राप्त करे। यह कोड इनके लिए ज़िम्मेदार होगा:
   - प्राप्त फ़ील्ड को validate करना।
   - Papo API के लिए JSON payload तैयार करना।
   - सीक्रेट key (Bearer token) से प्रमाणित होना और वैकल्पिक रूप से `X-Papo-Public-Key` हेडर में पब्लिक key भेजना।
   - Papo के contact creation endpoint को कॉल करना।

4. **Papo contacts API को कॉल करें**  
   contact creation endpoint का उपयोग करें (सटीक path और payload format के लिए `https://papo.global/pt/docs` पर आधिकारिक दस्तावेज़ देखें)। कम से कम नाम और ईमेल या फ़ोन भेजें। API का response नए संपर्क के डेटा के साथ creation की पुष्टि करेगा।

5. **कस्टम attributes जोड़ें**  
   यदि आपके अकाउंट में कस्टम attributes की परिभाषाएँ हैं (जैसे “origem”, “utm_source”, “score”), तो आप उन्हें उसी payload में या पूरक कॉल में भेज सकते हैं। API संपर्क पर `custom_attributes` को define/merge करने देती है, जिससे बाद में इन फ़ील्ड को मैन्युअल रूप से भरने की ज़रूरत खत्म हो जाती है।

6. **Response संभालें और उपयोगकर्ता को लौटाएँ**  
   सफल creation के बाद, आपका endpoint लीड को धन्यवाद पेज पर redirect कर सकता है या सफलता संदेश दिखा सकता है। त्रुटि होने पर (अमान्य key, गायब डेटा), log दर्ज करें और उपयोगकर्ता-मैत्रीपूर्ण संदेश लौटाएँ।

चूँकि Papo API REST है और JSON का उपयोग करती है, HTTP सपोर्ट वाली कोई भी भाषा इस्तेमाल की जा सकती है। आधिकारिक दस्तावेज़ में JavaScript, Python और curl के उदाहरण, authentication विवरण और error codes दिए गए हैं।

## यह इंटीग्रेशन किनके लिए उपयुक्त है

- **लीड कैप्चर करने वाली साइटें और लैंडिंग पेज** जो CRM में मैन्युअल डेटा ट्रांसफर खत्म करना चाहती हैं।
- **ई-कॉमर्स और SaaS** जो रजिस्ट्रेशन या खरीद के समय स्वचालित रूप से संपर्क बनाना चाहते हैं।
- **एजेंसियाँ और कंसल्टेंसी** जो कैप्चर कैंपेन चलाती हैं और चाहती हैं कि लीड्स तुरंत follow-up के लिए रीयल-टाइम में CRM में आएँ।
- **व्हाइट लेबल रीसेलर और इंटीग्रेटर** जो ग्राहकों के लिए कस्टम फ़्लो बनाते हैं, बिना मैन्युअल हस्तक्षेप के साइट फ़ॉर्म को Papo से जोड़ते हैं।
- **मार्केटिंग और सेल्स टीमें** जो segmentation के लिए कस्टम attributes उपयोग करती हैं और चाहती हैं कि ये फ़ील्ड स्रोत पर ही स्वचालित भर जाएँ।

## अक्सर पूछे जाने वाले प्रश्न

### इस इंटीग्रेशन को लागू करने के लिए क्या मुझे प्रोग्रामिंग का उन्नत ज्ञान चाहिए?

हाँ। आपको अपने सर्वर पर endpoint विकसित करना होगा या ऑटोमेशन टूल्स (n8n, Zapier) का उपयोग करना होगा जो फ़ॉर्म और Papo API के बीच पुल का काम करें। कोड स्वयं सरल है, लेकिन HTTP और JSON handling की बुनियादी समझ ज़रूरी है।

### क्या मैं कोई भी प्रोग्रामिंग भाषा इस्तेमाल कर सकता/सकती हूँ?

हाँ। Papo API REST है और JSON में जवाब देती है। HTTP अनुरोधों का सपोर्ट रखने वाली कोई भी भाषा (Python, Node.js, PHP, Ruby आदि) इस्तेमाल की जा सकती है। आधिकारिक दस्तावेज़ JavaScript और Python में उदाहरण देता है।

### क्या संपर्क बनाते समय सीधे कस्टम attributes बनाना संभव है?

हाँ। Papo API संपर्क के `custom_attributes` को creation के समय define करने या बाद में update करने देती है। सटीक payload format के लिए और यह जाँचने के लिए कि attributes की परिभाषाएँ अकाउंट में पहले से हैं या नहीं, दस्तावेज़ देखें।

### सीक्रेट key की सुरक्षा कैसे सुनिश्चित करें?

सीक्रेट key को कभी frontend (सार्वजनिक HTML/JavaScript) में उजागर नहीं करना चाहिए। यह केवल सर्वर पर, environment variables में रहनी चाहिए। सभी संचार में HTTPS का उपयोग करें और लीक का संदेह होने पर key को तुरंत revoke करें।

### अगर API error लौटाए तो क्या करें?

Papo API `success: false` और code तथा message वाला `error` ऑब्जेक्ट सहित मानकीकृत responses लौटाती है। अपने कोड में इन errors को संभालें: जाँचें कि अनिवार्य फ़ील्ड भेजे गए हैं, key सक्रिय है और payload format सही है। दस्तावेज़ में मुख्य error codes सूचीबद्ध हैं।

### क्या मैं इस इंटीग्रेशन का उपयोग WordPress, Typeform या RD Station जैसे प्लेटफ़ॉर्म के फ़ॉर्म के साथ कर सकता/सकती हूँ?

हाँ। आप इन प्लेटफ़ॉर्म पर webhooks कॉन्फ़िगर कर सकते हैं ताकि फ़ॉर्म डेटा आपके मध्यस्थ endpoint को भेजा जाए, जो फिर Papo API को कॉल करेगा। दूसरा विकल्प Zapier या n8n के ज़रिए तैयार integrations का उपयोग करना है, ऐसा फ़्लो बनाकर जो फ़ॉर्म event प्राप्त करे और Papo में संपर्क creation trigger करे।

## यह भी पढ़ें

- [CRM में Companies प्रबंधित करने के लिए Papo API का उपयोग कैसे करें](/hc/papo/articles/how-to-use-papo-api-manage-companies-crm-hi)
- [API और webhooks का उपयोग करके Papo को Zapier से कैसे इंटीग्रेट करें](/hc/papo/articles/integrate-papo-with-zapier-using-api-and-webhooks-hi)

---

**[मुफ़्त शुरू करें →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

Papo पर अपना मुफ़्त अकाउंट बनाएँ और मिनटों में रजिस्ट्रेशन फ़ॉर्म को CRM से इंटीग्रेट करना शुरू करें, बिना मैन्युअल टाइपिंग के।