Papo (https://papo.global/) की API कुंजियाँ जनरेट करने के लिए, पैनल में लॉग इन करें और सेटिंग्स > डेवलपर्स (या API) पर जाएँ। वहाँ आपको अपनी फिक्स्ड पब्लिक कुंजी मिलेगी और आप नामित सीक्रेट कुंजियाँ बना सकते हैं, जो केवल एक बार दिखाई जाती हैं और उन्हें सुरक्षित स्थान, जैसे पासवर्ड मैनेजर या सर्वर पर एनवायरनमेंट वेरिएबल्स में संग्रहीत करना चाहिए।
Papo की API CRM, ERP, ऑटोमेशन प्लेटफ़ॉर्म (n8n, Zapier) और अपने सिस्टम के साथ इंटीग्रेशन में आपके अकाउंट की पहचान और प्रमाणीकरण के लिए कुंजियों की एक जोड़ी का उपयोग करती है। इनके बीच अंतर समझना और इन्हें जनरेट व सुरक्षित करना जानना भरोसेमंद ऑटोमेशन बनाने का पहला कदम है।
| कुंजी का प्रकार | फ़ॉर्मैट | कार्य | एक्सपोज़र स्तर |
|---|---|---|---|
| पब्लिक कुंजी | pk_live_... |
आपके Papo अकाउंट की विशिष्ट पहचान करती है। | फ्रंटएंड या सार्वजनिक स्क्रिप्ट में एक्सपोज़ की जा सकती है। |
| सीक्रेट कुंजी | sk_live_... |
रिक्वेस्ट को प्रमाणित करती है और आपके अकाउंट में कार्रवाइयों को अधिकृत करती है। | गोपनीय – इसे कभी साझा या कोड में वर्शन नहीं करना चाहिए। |
API कुंजियाँ कैसे जनरेट करें
- Papo पैनल में लॉग इन करें और सेटिंग्स पर जाएँ।
- बाएँ मेनू में डेवलपर्स या API सेक्शन खोजें।
- यह पेज आपकी पब्लिक कुंजी (
pk_live_...) दिखाएगा। यह फिक्स्ड है और कभी भी कॉपी की जा सकती है। - सीक्रेट कुंजी पाने के लिए, नई कुंजी बनाने वाले बटन पर क्लिक करें।
- भविष्य में प्रबंधन आसान बनाने के लिए एक वर्णनात्मक नाम दें (जैसे: “CRM इंटीग्रेशन”, “n8n ऑटोमेशन”)।
- सीक्रेट कुंजी (
sk_live_...) केवल एक बार दिखाई जाएगी। इसे तुरंत कॉपी करें और सुरक्षित स्थान पर रखें।
⚠️ सुरक्षा के लिए, Papo सीक्रेट कुंजी का केवल हैश संग्रहीत करता है। यदि आप मूल मान खो देते हैं, तो उसे पुनः प्राप्त नहीं किया जा सकता। ऐसे में, समझौता किए गए कुंजी को रद्द करें और नई जनरेट करें।
कुंजियों को सुरक्षित रूप से कैसे संग्रहीत करें
- कभी भी सीक्रेट कुंजी को सीधे सोर्स कोड, Git रिपॉज़िटरी या संदेशों में न रखें।
- अपने सर्वर पर एनवायरनमेंट वेरिएबल्स का उपयोग करें (जैसे:
PAPO_SECRET_KEY) और कोड में उनका संदर्भ दें। - भविष्य में देखने के लिए कुंजी को पासवर्ड मैनेजर (जैसे 1Password, Bitwarden या आपके क्लाउड प्रोवाइडर का वॉल्ट) में संग्रहीत करें।
- यदि कुंजी लीक हो जाए या समझौते का संदेह हो, तो उसी डेवलपर्स पेज पर जाएँ, सूची में कुंजी खोजें और तुरंत उसे रद्द करें। फिर नई बनाएँ और अपने इंटीग्रेशन अपडेट करें।
ये कुंजियाँ किस काम आती हैं?
Papo API की सभी कॉल में जिनके लिए प्रमाणीकरण आवश्यक है, इन कुंजियों का उपयोग होता है। सीक्रेट कुंजी Authorization हेडर में Bearer टोकन के रूप में भेजी जाती है। पब्लिक कुंजी को अतिरिक्त सत्यापन के रूप में X-Papo-Public-Key हेडर में भेजा जा सकता है, लेकिन मुख्य प्रमाणीकरण हमेशा सीक्रेट कुंजी पर निर्भर करता है।
कुंजियों के साथ, आप उदाहरण के लिए:
- API के ज़रिए WhatsApp संदेश भेज सकते हैं।
- Extrator द्वारा निकाले गए संपर्क देख सकते हैं।
- अपने सिस्टम से Papo की आर्टिफिशियल इंटेलिजेंस को ट्रिगर कर सकते हैं।
- अपने CRM या ERP के साथ डेटा सिंक कर सकते हैं।
अक्सर पूछे जाने वाले प्रश्न
मेरे अकाउंट की पब्लिक कुंजी कहाँ मिलेगी?
पब्लिक कुंजी (pk_live_...) सेटिंग्स > डेवलपर्स (या API) पेज पर दिखाई देती है। यह फिक्स्ड है और जब भी आवश्यक हो कॉपी की जा सकती है।
क्या मैं एक से अधिक सीक्रेट कुंजी रख सकता हूँ?
हाँ। आप कई सीक्रेट कुंजियाँ जनरेट कर सकते हैं, हर एक अलग नाम के साथ (जैसे: “प्रोडक्शन”, “टेस्ट”, “n8n”)। इससे एक्सेस को अलग रखने और अन्य को प्रभावित किए बिना किसी विशिष्ट कुंजी को रद्द करने में मदद मिलती है।
मेरी सीक्रेट कुंजी खो गई। क्या करें?
सीक्रेट कुंजी पुनः प्राप्त नहीं की जा सकती। डेवलपर्स पेज पर जाएँ, खोई हुई कुंजी को रद्द करें और नई बनाएँ। अपने इंटीग्रेशन को नए मान के साथ अपडेट करें।
प्रमाणीकरण के लिए क्या मुझे पब्लिक कुंजी चाहिए?
अनिवार्य रूप से नहीं। प्रमाणीकरण सीक्रेट कुंजी से होता है। पब्लिक कुंजी वैकल्पिक है और अतिरिक्त पहचानकर्ता के रूप में काम करती है, लेकिन यह सीक्रेट कुंजी की जगह नहीं लेती।
सीक्रेट कुंजी को कैसे रद्द करें?
डेवलपर्स पेज की कुंजियों की सूची में, जिस कुंजी को निष्क्रिय करना है उसे खोजें और रद्द करने के विकल्प पर क्लिक करें। उस समय से, उस कुंजी का उपयोग करने वाली कोई भी रिक्वेस्ट अस्वीकार कर दी जाएगी।
क्या मैं इन कुंजियों का उपयोग n8n या Zapier जैसे टूल में कर सकता हूँ?
हाँ। Papo API कुंजियाँ किसी भी ऐसे टूल के साथ संगत हैं जो Bearer टोकन के ज़रिए प्रमाणीकरण का समर्थन करता है। बस टूल के ऑथराइज़ेशन फ़ील्ड में सीक्रेट कुंजी डालें।
यह भी पढ़ें
Papo पर अपना मुफ़्त अकाउंट बनाएँ और अपने सिस्टम को इंटिग्रेट करने के लिए API कुंजियों तक तुरंत पहुँच पाएँ।