अपने खाते को बाहरी सिस्टम जैसे CRM, ERP या ऑटोमेशन प्लेटफ़ॉर्म (n8n, Zapier) के साथ इंटीग्रेट करने के लिए, Papo (https://papo.global/) API (एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस) कुंजियाँ प्रदान करता है जिन्हें सीधे आपके डैशबोर्ड में जनरेट और प्रबंधित किया जा सकता है। ये कुंजियाँ सुरक्षित क्रेडेंशियल के रूप में कार्य करती हैं जो अन्य सॉफ़्टवेयर को आपके Papo खाते में प्रोग्रामेटिक रूप से एक्सेस करने और कार्य करने के लिए अधिकृत करती हैं।
Papo का API आपको कनेक्टेड कार्य इकोसिस्टम बनाने की अनुमति देता है, WhatsApp संदेश भेजने से लेकर योग्य लीड निकालने तक के कार्यों को स्वचालित करता है। सुरक्षा सुनिश्चित करने के लिए, Papo दो-कुंजी प्रणाली का उपयोग करता है: एक सार्वजनिक, पहचान के लिए, और एक गुप्त, प्रमाणीकरण के लिए।
| कुंजी का प्रकार | विवरण | सुरक्षा स्तर | उपयोग का उदाहरण |
|---|---|---|---|
सार्वजनिक कुंजी (pk_live_...) |
आपके Papo खाते के लिए एक अद्वितीय और निश्चित पहचानकर्ता। | कम। इसे सार्वजनिक रूप से उजागर किया जा सकता है। | अपनी वेबसाइट के फ्रंटएंड पर एक स्क्रिप्ट में अपने खाते की पहचान करना। |
गुप्त कुंजी (sk_live_...) |
API के लिए एक "पासवर्ड"। यह आपके अनुरोधों को प्रमाणित करता है और आपके खाते की ओर से कार्य करने की अनुमति देता है। | उच्च। इसे पूर्ण गोपनीयता में रखा जाना चाहिए। | संदेश भेजने के लिए अपने सर्वर (बैकएंड) से API कॉल को प्रमाणित करना। |
अपनी API कुंजियाँ कैसे जनरेट करें और खोजें
API कुंजियाँ आपके Papo खाते के एक विशिष्ट क्षेत्र में प्रबंधित की जाती हैं। उन तक पहुँचने के लिए नीचे दिए गए चरणों का पालन करें।
- अपने Papo डैशबोर्ड में लॉग इन करें और सेटिंग्स पर जाएँ।
- सेटिंग्स मेनू में, डेवलपर्स या API अनुभाग खोजें।
- इस पृष्ठ पर, आपको अपनी सार्वजनिक कुंजी (
pk_live_...) मिलेगी, जो निश्चित है और इसे किसी भी समय कॉपी किया जा सकता है। - गुप्त कुंजी के लिए, आपको एक नई कुंजी जनरेट करनी होगी। एक नई कुंजी बनाने के लिए बटन पर क्लिक करें।
- कुंजी के लिए एक वर्णनात्मक नाम दें, यह इंगित करते हुए कि इसका उपयोग कहाँ किया जाएगा (उदाहरण: "CRM इंटीग्रेशन", "N8N ऑटोमेशन")। यह आवश्यकता पड़ने पर विशिष्ट कुंजियों की पहचान करने और उन्हें रद्द करने में मदद करता है।
- बनाने के बाद, गुप्त कुंजी (
sk_live_...) केवल एक बार प्रदर्शित होगी। इसे कॉपी करें और इसे किसी सुरक्षित स्थान पर सहेजें, जैसे पासवर्ड मैनेजर या आपके सर्वर पर एक पर्यावरण चर। सुरक्षा कारणों से, Papo कुंजी के मूल मान को संग्रहीत नहीं करता है और इसे फिर से प्रदर्शित नहीं कर पाएगा।
यदि आप एक गुप्त कुंजी खो देते हैं या संदेह करते हैं कि यह लीक हो गई है, तो इसे तुरंत डैशबोर्ड में रद्द करें और एक नई कुंजी बनाएँ।
API में प्रमाणीकरण के लिए कुंजियों का उपयोग कैसे करें
Papo API के साथ सभी संचार जिसमें निजी डेटा तक पहुँच या कार्य शामिल हैं, प्रमाणित होने चाहिए। यह HTTP हेडर में गुप्त कुंजी भेजकर किया जाता है।
सभी API कॉलों के लिए बेस URL है: https://app.papo.global/api/v1
प्रमाणित करने के लिए, अपनी गुप्त कुंजी को अपने अनुरोध के Authorization हेडर में शामिल करें, जिसके पहले Bearer शब्द हो।
अपने खाते से डेटा प्राप्त करने के लिए curl के साथ अनुरोध का उदाहरण:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_SUA_CHAVE_SECRETA_AQUI"
इस उदाहरण में:
sk_live_SUA_CHAVE_SECRETA_AQUIको आपकी वास्तविक गुप्त कुंजी से बदला जाना चाहिए।/meएंडपॉइंट प्रमाणित खाते के बारे में जानकारी देता है, यह जाँचने के लिए एक अच्छा परीक्षण के रूप में कार्य करता है कि आपकी कुंजी काम कर रही है या नहीं।
सार्वजनिक कुंजी (pk_live_...) को वैकल्पिक रूप से X-Papo-Public-Key हेडर में एक अतिरिक्त सत्यापन के रूप में भेजा जा सकता है, लेकिन मुख्य प्रमाणीकरण हमेशा गुप्त कुंजी द्वारा किया जाता है।
Papo API के साथ आप क्या कर सकते हैं?
API आपके संचालन को स्वचालित और इंटीग्रेट करने के लिए कई संभावनाएँ खोलता है। यहाँ कुछ उदाहरण दिए गए हैं जो आप कर सकते हैं:
- WhatsApp संदेश भेजें: अपने कनेक्टेड नंबरों में से किसी एक के माध्यम से सूचनाएं, अलर्ट या लेन-देन संबंधी संदेश भेजने के लिए स्क्रिप्ट बनाएँ।
- एक्सट्रैक्टर से संपर्क खोजें: अपने मुख्य CRM के साथ सिंक्रनाइज़ करने के लिए Extrator de CNPJ के साथ निकाले गए लीड की सूची तक पहुँचें।
- उदाहरणों का प्रबंधन करें: अपने WhatsApp कनेक्शन की स्थिति को सूचीबद्ध करें और जाँचें।
- आर्टिफिशियल इंटेलिजेंस का उपयोग करें: Papo के AI इंजन को टेक्स्ट भेजें और अपने कॉन्फ़िगर किए गए प्रॉम्प्ट के आधार पर जनरेट किए गए उत्तर प्राप्त करें।
- डेटा सिंक्रनाइज़ करें: Papo में जनरेट किए गए डेटा के साथ अपने आंतरिक सिस्टम (ERP, BI) को अपडेट रखें।
अक्सर पूछे जाने वाले प्रश्न (FAQ)
### API का पूरा दस्तावेज़ कहाँ मिलेगा?
API के लिए विस्तृत तकनीकी दस्तावेज़, जिसमें सभी एंडपॉइंट, पैरामीटर और विभिन्न भाषाओं (JavaScript, Python) में कोड उदाहरण शामिल हैं, सार्वजनिक रूप से papo.global/pt/docs पर उपलब्ध है।
### मेरी गुप्त कुंजी लीक हो गई है। मुझे क्या करना चाहिए?
यदि आपको संदेह है कि आपकी गुप्त कुंजी से समझौता किया गया है, तो तुरंत अपने Papo डैशबोर्ड में डेवलपर्स क्षेत्र तक पहुँचें, सूची में लीक हुई कुंजी को खोजें और उसे रद्द करने के लिए क्लिक करें। एक बार रद्द होने के बाद, इसका उपयोग अनुरोधों को प्रमाणित करने के लिए नहीं किया जा सकता है। फिर, अपने इंटीग्रेशन में पुरानी कुंजी को बदलने के लिए एक नई कुंजी जनरेट करें।
### मैं कितनी गुप्त कुंजियाँ बना सकता हूँ?
आप कई गुप्त कुंजियाँ बना सकते हैं। यह एक अच्छी सुरक्षा प्रथा है कि आप जिस प्रत्येक सिस्टम या वातावरण को इंटीग्रेट करते हैं, उसके लिए एक अलग कुंजी जनरेट करें (उदाहरण: आपके CRM के लिए एक, आपके ऑटोमेशन सिस्टम के लिए एक, परीक्षण वातावरण के लिए एक, आदि)। यह आपको अन्य सिस्टम को प्रभावित किए बिना एक विशिष्ट सिस्टम की पहुँच को रद्द करने की अनुमति देता है।
### क्या मैं अपनी वेबसाइट के फ्रंटएंड में सार्वजनिक कुंजी का उपयोग कर सकता हूँ?
हाँ, सार्वजनिक कुंजी (pk_live_...) को सार्वजनिक वातावरण में, जैसे आपकी वेबसाइट के JavaScript कोड में उपयोग के लिए सुरक्षित बनाया गया है। इसका कार्य केवल आपके खाते की पहचान करना है, न कि कार्यों को प्रमाणित करना। गुप्त कुंजी, दूसरी ओर, क्लाइंट-साइड कोड में कभी भी उजागर नहीं की जानी चाहिए।
### Papo API और Webhook में क्या अंतर है?
मुख्य अंतर इस बात में है कि संचार कौन शुरू करता है। API के साथ, आपका सिस्टम कार्रवाई शुरू करता है: आप Papo से डेटा "मांगते" (pull) हैं या Papo को कुछ करने के लिए "कहते" (push) हैं, जैसे संदेश भेजना। Webhook के साथ, Papo कार्रवाई शुरू करता है: यह एक विशिष्ट घटना होने पर स्वचालित रूप से आपके सिस्टम को डेटा "धकेलता" (push) है (उदाहरण: एक संपर्क एक Flow के एक चरण तक पहुँचता है)।
### Papo API और WhatsApp के आधिकारिक API में क्या अंतर है?
WhatsApp का आधिकारिक API विशेष रूप से WhatsApp चैनल की कार्यक्षमताओं पर केंद्रित है। Papo का API एक व्यापक और अधिक शक्तिशाली अमूर्त परत है: यह आपको न केवल WhatsApp को नियंत्रित करने की अनुमति देता है, बल्कि प्लेटफ़ॉर्म के अन्य मॉड्यूल, जैसे CRM, लीड एक्सट्रैक्टर और आर्टिफिशियल इंटेलिजेंस इंजन को भी, सभी एक ही कुंजी सेट के साथ और सरलीकृत तरीके से।
यह भी पढ़ें
- अन्य सिस्टम के साथ इंटीग्रेट करने के लिए ऑटोमेशन Flows में Webhook एक्शन का उपयोग कैसे करें
- क्या मैं Papo के आधिकारिक API में WhatsApp Business App का वही नंबर उपयोग कर सकता हूँ?
मुफ्त में इंटीग्रेशन शुरू करें →
आपके नंबर पर ऑटोमेशन और इंटीग्रेशन का परीक्षण करने के लिए पहला उपयोगकर्ता मुफ्त है।