प्रोग्रामेटिक रूप से Kanban में डील बनाने और अपडेट करने के लिए, Papo की REST API का उपयोग करें। गुप्त कुंजी (Bearer token) और खाते की सार्वजनिक कुंजी से प्रमाणीकरण के साथ, आप ऐसी अनुरोध भेज सकते हैं जो कार्ड बनाते हैं, अवसरों को चरणों के बीच ले जाते हैं और परिणाम चिह्नित करते हैं, जिससे बिक्री फ़नल बिना मैन्युअल हस्तक्षेप के बाहरी सिस्टम से जुड़ जाता है।
Papo की API Kanban के लिए लेखन ऑपरेशन प्रदान करती है, जिससे आप CRM के फ़नल, चरणों और कार्डों के साथ काम कर सकते हैं। यह ERP, लैंडिंग पेज या भुगतान टूल को बिक्री फ़नल के साथ सिंक करना संभव बनाती है, जिससे अवसर हमेशा अपडेट रहते हैं।
Kanban के साथ एकीकरण का सारांश
| चरण | क्रिया | महत्वपूर्ण विवरण |
|---|---|---|
| 1. कुंजियाँ प्राप्त करें | Papo पैनल में गुप्त कुंजी (sk_live_…) जनरेट करें और सार्वजनिक कुंजी (pk_live_…) कॉपी करें। |
गुप्त कुंजी केवल एक बार दिखाई देती है; इसे सुरक्षित स्थान पर रखें। |
| 2. कॉल प्रमाणित करें | सभी लेखन अनुरोधों में Authorization: Bearer sk_live_… हेडर शामिल करें। |
सार्वजनिक कुंजी X-Papo-Public-Key हेडर में भेजी जा सकती है (वैकल्पिक)। |
| 3. फ़नल और चरण जानें | आवश्यक पहचानकर्ता प्राप्त करने के लिए Kanban के फ़नल और उनके चरणों की सूची बनाएँ। | API प्रतिक्रिया अगली कॉल में उपयोग होने वाले पहचानकर्ता देती है। |
| 4. कार्ड बनाएँ या ले जाएँ | किसी चरण में कार्ड बनाने, किसी संपर्क के कार्ड को दूसरे चरण में ले जाने या परिणाम चिह्नित करने का ऑपरेशन भेजें। | प्रत्येक ऑपरेशन एक क्रिया संसाधित करता है; कई रिकॉर्ड के लिए, लूप में भेजना स्वचालित करें। |
| 5. प्रतिक्रिया सत्यापित करें | API success: true और कार्ड या सूची का डेटा लौटाती है। |
त्रुटि होने पर, प्रतिक्रिया बॉडी में सुधार के लिए कोड और संदेश होता है। |
API Kanban में क्या करने देती है
Kanban endpoints के साथ, आप प्रोग्रामेटिक रूप से यह कर सकते हैं:
- उपलब्ध फ़नल और उनके चरणों को नाम और स्थिति के साथ सूचीबद्ध करें।
- CRM के कार्डों की सूची बनाएँ।
- बंद बिक्री रिपोर्ट के लिए सभी जीते गए कार्डों की सूची बनाएँ।
- किसी चरण में कार्ड बनाएँ, वैकल्पिक रूप से किसी मौजूदा संपर्क से लिंक करें।
- किसी संपर्क के कार्ड को फ़नल के दूसरे चरण में ले जाएँ।
- कार्डों को जीत या हार के रूप में चिह्नित करें।
- डिफ़ॉल्ट या कस्टम चरणों के साथ Kanban फ़नल बनाएँ।
ये ऑपरेशन फ़नल को Papo के बाहर होने वाली घटनाओं को स्वचालित रूप से दर्शाने देते हैं, जैसे पुष्ट किया गया खरीद, शेड्यूल की गई मीटिंग या वेबसाइट से आया पंजीकरण।
प्रमाणीकरण और कॉल कैसे काम करते हैं
डेटा बदलने वाली हर कॉल के लिए खाते की गुप्त कुंजी आवश्यक है। इसे Authorization हेडर में Bearer token के रूप में या वैकल्पिक रूप से X-Papo-Secret-Key हेडर में भेजा जाना चाहिए। सार्वजनिक कुंजी अनुरोध के साथ X-Papo-Public-Key हेडर में भेजी जा सकती है; इसका उपयोग वैकल्पिक है, लेकिन यदि भेजी जाए, तो उसे गुप्त कुंजी के समान खाते से मेल खाना चाहिए।
API का बेस URL https://app.papo.global/api/v1 है। इससे, Kanban endpoints बनाने, ले जाने, अपडेट करने और सूचीबद्ध करने के लिए उपयुक्त HTTP verbs स्वीकार करते हैं। चूँकि पूर्ण दस्तावेज़ीकरण paths, parameters और स्वीकृत fields का विस्तार से वर्णन करता है, हम कोडिंग से पहले API के आधिकारिक संदर्भ को देखने की सलाह देते हैं।
अपनी कुंजियाँ काम कर रही हैं यह सत्यापित करने के लिए, आप GET /api/v1/me endpoint कॉल कर सकते हैं, जो खाते का डेटा लौटाता है। प्रमाणीकरण पैटर्न अन्य endpoints में उपयोग किए जाने वाले समान है:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
सफल प्रतिक्रिया में success: true और खाते की जानकारी वाला data ऑब्जेक्ट शामिल होता है।
बाहरी सिस्टम के साथ एकीकरण का विशिष्ट प्रवाह
Python, Node.js में एक स्क्रिप्ट या n8n जैसे टूल में ऑटोमेशन फ़नल का पूरा चक्र चला सकती है:
- प्रत्येक कॉलम के पहचानकर्ता प्राप्त करने के लिए फ़नल और चरणों की सूची बनाएँ।
- यदि आवश्यक हो तो किसी संपर्क से लिंक करते हुए, प्रारंभिक चरण में कार्ड बनाएँ।
- जब कोई बाहरी घटना हो — उदाहरण के लिए, भुगतान की पुष्टि या मीटिंग तय — तो कार्ड को नए चरण में ले जाएँ।
- अवसर पूरा होने पर कार्ड को जीत या हार के रूप में चिह्नित करें।
- रिपोर्ट, डैशबोर्ड या BI सिस्टम को डेटा देने के लिए जीते गए कार्डों की सूची बनाएँ।
चूँकि API REST है और JSON का उपयोग करती है, HTTP समर्थन वाली कोई भी भाषा काम करती है। प्रत्येक ऑपरेशन के payload और fields का विवरण आधिकारिक दस्तावेज़ीकरण में है।
यह एकीकरण किसके लिए उपयुक्त है
- वे कंपनियाँ जो बाहरी सिस्टम में अवसर कैप्चर करती हैं, जैसे लैंडिंग पेज, ERP या ई‑कॉमर्स, और चाहती हैं कि वे स्वचालित रूप से Papo के फ़नल में आएँ।
- वे ऑपरेशन जिन्हें भुगतान घटनाओं के अनुसार कार्ड ले जाने की आवश्यकता होती है, जैसे गेटवे या बिलिंग प्लेटफ़ॉर्म, बिना CRM मैन्युअल रूप से खोले।
- BI और डेटा टीमें जो जीते गए कार्ड और मूल्यों को रीयल-टाइम डैशबोर्ड में लाना चाहती हैं।
- IT टीमें जो Papo और आंतरिक टूल के बीच कस्टम एकीकरण बनाती हैं, API को बिक्री फ़नल और बाकी ऑपरेशन के बीच पुल के रूप में उपयोग करते हुए।
अक्सर पूछे जाने वाले प्रश्न
क्या मुझे हर कॉल में सार्वजनिक कुंजी का उपयोग करना होगा?
नहीं। सार्वजनिक कुंजी वैकल्पिक है, लेकिन यदि X-Papo-Public-Key हेडर में भेजी जाए, तो उसे गुप्त कुंजी के समान खाते से मेल खाना चाहिए।
मुझे कैसे पता चलेगा कि मेरे फ़नल में कौन-कौन से चरण हैं?
API से Kanban के फ़नल की सूची बनाएँ। प्रतिक्रिया प्रत्येक फ़नल के चरणों को उनके पहचानकर्ताओं के साथ लौटाती है, जिनका उपयोग कार्ड बनाने या ले जाने के लिए किया जाता है।
क्या मैं पहले से किसी संपर्क से लिंक कार्ड बना सकता/सकती हूँ?
हाँ। कार्ड बनाने से वैकल्पिक रूप से किसी मौजूदा संपर्क से लिंक किया जा सकता है, जिससे ग्राहक का इतिहास और डेटा अवसर से जुड़ा रहता है।
क्या API कार्ड का मूल्य अपडेट करने देती है?
API Kanban कार्डों के लिए लेखन ऑपरेशन प्रदान करती है। मूल्यों सहित कौन-कौन से fields अपडेट किए जा सकते हैं, इसका विवरण API के आधिकारिक दस्तावेज़ीकरण में है।
क्या API से कार्ड को जीत या हार के रूप में चिह्नित करना संभव है?
हाँ। API कार्डों को जीत और हार के रूप में चिह्नित करने देती है, साथ ही रिपोर्ट और डैशबोर्ड के लिए सभी जीते गए कार्डों की सूची बनाने देती है।
क्या मुझे प्रोग्राम करना होगा या मैं ऑटोमेशन टूल का उपयोग कर सकता/सकती हूँ?
आप HTTP समर्थन वाली कोई भी भाषा या n8n जैसे ऑटोमेशन टूल का उपयोग कर सकते हैं, और वांछित प्रवाह के अनुसार कॉल को क्रम में चला सकते हैं।
यह भी पढ़ें
- Papo API का उपयोग करके संपर्कों को थोक में बनाना और अपडेट करना कैसे करें
- Webhook (outbound) के माध्यम से Papo से रीयल-टाइम इवेंट कैसे प्राप्त करें
मुफ़्त शुरू करें → पहला उपयोगकर्ता मुफ़्त है और क्रेडिट कार्ड की आवश्यकता नहीं है।