Papo Global (https://papo.global/) की API का उपयोग शुरू करने के लिए, आपको पैनल में एक सीक्रेट की बनानी होगी, अनुरोधों को Authorization हेडर से प्रमाणित करना होगा और बेस https://app.papo.global/api/v1 पर REST कॉल करने होंगे। पहला व्यावहारिक परीक्षण एक साधारण cURL कमांड से Extrator के संपर्कों को सूचीबद्ध करना है।
Papo की API REST है, JSON का उपयोग करती है और किसी भी ओरिजिन से अनुरोध स्वीकार करती है (CORS खुला है)। इसके साथ आप CRM, ऑटोमेशन प्लेटफ़ॉर्म (जैसे n8n), ERP या अपने खुद के बैकएंड को Papo के सपोर्ट, सेल्स और AI इकोसिस्टम से जोड़ सकते हैं।
आवश्यक तत्वों का सारांश
| तत्व | विवरण |
|---|---|
पब्लिक की (pk_live_…) |
आपके खाते का स्थिर पहचानकर्ता, फ्रंट-एंड में उजागर किया जा सकता है |
सीक्रेट की (sk_live_…) |
प्रमाणीकरण टोकन, इसे गुप्त रखें और केवल सर्वर पर उपयोग करें |
| प्रमाणीकरण | हर कॉल में हेडर Authorization: Bearer sk_live_... (या X-Papo-Secret-Key), सिवाय GET /api/v1 के |
| बेस URL | https://app.papo.global/api/v1 |
| उदाहरण एंडपॉइंट | GET /api/v1/contacts — निकाले गए संपर्कों (Extrator) की सूची, पेजिनेशन के साथ |
पहली कॉल के लिए चरण-दर-चरण
1. अपनी API की बनाएं
Papo पैनल में डेवलपर्स पेज पर जाएं (app.papo.global/developers पर उपलब्ध)। वहां आप एक नामित सीक्रेट की बना सकते हैं — उदाहरण के लिए, “primeiro-teste” — और उसे तुरंत कॉपी कर सकते हैं। की केवल एक बार दिखाई जाती है; उसके बाद आप उसे केवल रद्द कर सकते हैं और नई बना सकते हैं।
पब्लिक की (pk_live_…) प्रति खाता स्थिर होती है और उसी पेज पर कभी भी दिखाई देती है। हालांकि अनुरोधों में यह वैकल्पिक है, यदि आप इसे भेजते हैं, तो इसे सीक्रेट की वाले उसी खाते से जुड़ा होना चाहिए।
2. एंडपॉइंट चुनें
इस गाइड के लिए, हम GET /api/v1/contacts का उपयोग करेंगे, जो Extrator मॉड्यूल द्वारा निकाले गए लीड्स की सूची देता है। आप page (डिफ़ॉल्ट 1) और per_page (1 से 100, डिफ़ॉल्ट 20) पैरामीटर से परिणामों को पेजिनेट कर सकते हैं। कंपनी, फ़ोन या ईमेल से खोजने के लिए q के साथ टेक्स्ट क्वेरी भी स्वीकार की जाती है।
3. cURL से कॉल करें
सीक्रेट की हाथ में होने पर, अनुरोध बनाएं। निम्न उदाहरण 20 संपर्कों तक की सूची देता है:
curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \
-H "Authorization: Bearer sk_live_…"
sk_live_… को अपनी सीक्रेट की से बदलें। यदि आप वैकल्पिक हेडर उपयोग करना चाहते हैं, तो करें:
curl "https://app.papo.global/api/v1/contacts" \
-H "X-Papo-Secret-Key: sk_live_…"
प्रतिक्रिया एक JSON होती है जिसमें success: true और डेटा data ऑब्जेक्ट के अंदर होता है। यदि त्रुटि हो, तो JSON में success: false और कोड व संदेश वाला error ऑब्जेक्ट होगा।
यहां से, आप API पेज पर दस्तावेज़ित अन्य एंडपॉइंट्स का पता लगा सकते हैं, जैसे संदेश भेजना (POST /api/v1/messages), खाता विवरण (GET /api/v1/me) या AI से टेक्स्ट पूरा करना (POST /api/ai/v1/complete)।
यह गाइड किसके लिए है
यह सामग्री उन डेवलपर्स के लिए है जो Papo को बाहरी सिस्टम — CRM, ऑटोमेशन टूल्स (जैसे n8n) या अपने खुद के एप्लिकेशन — के साथ एकीकृत करना चाहते हैं। यदि आप अंतिम उपयोगकर्ता हैं जो केवल चैनल कनेक्ट करना और सपोर्ट करना चाहते हैं, तो Help Center में इसके लिए अधिक उपयुक्त अन्य लेख हैं।
अक्सर पूछे जाने वाले प्रश्न
क्या मुझे हर कॉल में पब्लिक की भेजनी होती है?
नहीं। पब्लिक की वैकल्पिक है। यदि आप इसे भेजना चुनते हैं, तो यह उपयोग की गई सीक्रेट की के खाते से मेल खानी चाहिए।
क्या सीक्रेट की समाप्त हो जाती है?
नहीं, यह स्वतः समाप्त नहीं होती। यदि आपको लीक का संदेह हो, तो आप पैनल से इसे कभी भी रद्द कर सकते हैं और नई बना सकते हैं।
क्या मैं मुफ़्त खाते से API परीक्षण कर सकता हूं?
हां। Papo का पहला उपयोगकर्ता मुफ़्त है और आप API का पता लगाने के लिए की बना सकते हैं। Extrator जैसे मॉड्यूल तक पहुंच उपयोग के अनुसार बैलेंस खर्च कर सकती है, लेकिन की बनाना और बुनियादी रीड कॉल बिना अतिरिक्त लागत के परीक्षण योग्य हैं।
अगर मैं सीक्रेट की खो दूं तो क्या करें?
डेवलपर्स पैनल में एक नई नामित की बनाएं। पिछली की पुनर्प्राप्त नहीं की जा सकती; सुरक्षा के लिए केवल रद्द की जा सकती है।
क्या मैं API का उपयोग बल्क संदेश भेजने के लिए कर सकता हूं?
हां, POST /api/v1/messages एंडपॉइंट टेक्स्ट संदेश भेजने की अनुमति देता है। हालांकि, प्लेटफ़ॉर्म की सहमति नीतियों और उपयोग की शर्तों का पालन करें।
क्या API केवल Extrator के संपर्कों की सूची देती है?
GET /api/v1/contacts एंडपॉइंट निकाले गए संपर्क लौटाता है। CRM के एकीकृत बेस को प्रबंधित करने के लिए (कोई भी संपर्क खोजना, बनाना और अपडेट करना), आप API के पूर्ण दस्तावेज़ देख सकते हैं।
यह भी पढ़ें: Papo API का उपयोग करके पंजीकरण फ़ॉर्म बनाएं और CRM को स्वचालित रूप से भरें · Papo API का उपयोग करके व्हाइट लेबल रीसेल के क्रेडिट खपत और इनवॉइस की निगरानी करें
Papo Global पर मुफ़्त शुरू करें →
पहला उपयोगकर्ता R$ 0, कार्ड के बिना। अधिक जानें papo.global पर।