प्रोग्रामेटिक रूप से बड़ी संख्या में बातचीत और संपर्कों को संग्रहित करने के लिए, Papo के REST API का उपयोग करें। संपर्कों को अपडेट करने और बातचीत में टैग लगाने वाले एंडपॉइंट्स के साथ, आप रिकॉर्ड को संग्रहित के रूप में चिह्नित कर सकते हैं, जिससे डेटाबेस हमेशा साफ रहता है और मैन्युअल हस्तक्षेप की आवश्यकता नहीं होती — यह बड़ी मात्रा में डेटा वाले संचालनों या कई ग्राहकों को प्रबंधित करने वाली व्हाइट लेबल रीसेलर्स के लिए आदर्श है।
Papo को “संग्रहित करने” के लिए एक विशेष एंडपॉइंट की आवश्यकता नहीं है। इसके बजाय, आप रिकॉर्ड की स्थिति बदलने के लिए API में पहले से उपलब्ध ऑपरेशनों का उपयोग करते हैं: किसी संपर्क को अपडेट करना (संग्रहण टैग या कस्टम एट्रिब्यूट जोड़ना) और किसी बातचीत पर टैग लगाना। इस तरह, स्क्रिप्ट या ऑटोमेशन हजारों आइटम को बैच में प्रोसेस कर सकते हैं और आपके व्यवसाय के नियमों के अनुसार डेटाबेस को व्यवस्थित कर सकते हैं।
API के माध्यम से बड़ी संख्या में संग्रहण प्रक्रिया का सारांश
| चरण | क्रिया | महत्वपूर्ण विवरण |
|---|---|---|
| 1. कुंजियाँ प्राप्त करें | Papo पैनल में गुप्त कुंजी (sk_live_…) जनरेट करें और सार्वजनिक कुंजी (pk_live_…) कॉपी करें। | गुप्त कुंजी केवल एक बार दिखाई देती है; इसे सुरक्षित स्थान पर रखें। |
| 2. संग्रहित करने योग्य पहचानें | उन संपर्कों या बातचीतों की सूची बनाएं जिन्हें संग्रहित किया जाना चाहिए (तिथि, स्थिति, बातचीत की अनुपस्थिति आदि के आधार पर)। | फ़िल्टर के साथ लिस्टिंग एंडपॉइंट्स का उपयोग करें या स्क्रिप्ट को फीड करने के लिए CSV निर्यात करें। |
| 3. संपर्कों को संग्रहित करें | प्रत्येक संपर्क के लिए, “संग्रहित” टैग या कस्टम एट्रिब्यूट सहित एक अपडेट अनुरोध भेजें। | संपर्क अपडेट एंडपॉइंट उन फ़ील्ड्स को स्वीकार करता है जिन्हें आप संशोधित करना चाहते हैं। |
| 4. बातचीतों को संग्रहित करें | प्रत्येक बातचीत के लिए, टैग एंडपॉइंट का उपयोग करके “संग्रहित” जैसा टैग लगाएं। | यदि टैग पहले से मौजूद नहीं है तो यह खाते में स्वचालित रूप से बन जाता है। |
| 5. परिणाम जांचें | जांचें कि रिकॉर्ड संग्रहण चिह्न के साथ दिखाई दे रहे हैं और क्या प्लेटफ़ॉर्म के फ़िल्टर नए संगठन को दर्शाते हैं। | संग्रहित आइटम छिपाने के लिए संपर्क या बातचीत मॉड्यूल में फ़िल्टर समायोजित करें। |
यह कैसे काम करता है – चरण दर चरण
1. प्रमाणीकरण और कुंजियाँ
डेटा को संशोधित करने वाली प्रत्येक कॉल के लिए खाते की गुप्त कुंजी आवश्यक है। इसे Authorization हेडर (या X-Papo-Secret-Key हेडर) में Bearer टोकन के रूप में भेजा जाना चाहिए। सार्वजनिक कुंजी (प्रति खाता निश्चित) X-Papo-Public-Key हेडर में अनुरोध के साथ भेजी जा सकती है — इसका उपयोग वैकल्पिक है, लेकिन यदि भेजा जाता है तो इसे गुप्त कुंजी के समान खाते से मेल खाना चाहिए।
Papo पैनल में डेवलपर क्षेत्र में कुंजियाँ जनरेट करें। API का बेस URL https://app.papo.global/api/v1 है। सटीक एंडपॉइंट्स, पैरामीटर और पेलोड उदाहरण देखने के लिए आधिकारिक दस्तावेज़ देखें।
2. संग्रहित करने योग्य रिकॉर्ड की पहचान करना
अपडेट शुरू करने से पहले, आपको यह जानना होगा कि कौन से संपर्क या बातचीत संग्रहित किए जाने चाहिए। API लिस्टिंग एंडपॉइंट्स प्रदान करता है जो आवश्यक डेटा लौटाते हैं। उदाहरण के लिए, आप यह कर सकते हैं:
- संपर्कों की सूची बनाएं (नाम, ईमेल, फ़ोन या तिथि फ़िल्टर द्वारा खोजें) उन लोगों का चयन करने के लिए जिनके साथ X दिनों से कोई बातचीत नहीं हुई है।
- बातचीतों की सूची बनाएं और स्थिति या अंतिम संदेश की तिथि जैसे मानदंडों के साथ मिलाएं।
सूची हाथ में होने पर, Python, Node.js में एक स्क्रिप्ट या n8n में एक ऑटोमेशन प्रत्येक रिकॉर्ड को पार कर सकता है और संग्रहण क्रिया निष्पादित कर सकता है।
3. बड़ी संख्या में संपर्कों को संग्रहित करना
Papo का API मौजूदा संपर्क को अपडेट करने की अनुमति देता है। इसे संग्रहित करने के लिए, आप यह कर सकते हैं:
- संपर्क में एक टैग (उदा.: “संग्रहित”) जोड़ें। अपडेट एंडपॉइंट टैग शामिल करने की अनुमति देता है।
- या वांछित मान के साथ एक कस्टम एट्रिब्यूट (यदि आपने “स्थिति” या “संग्रहित” जैसा फ़ील्ड बनाया है) अपडेट करें।
महत्वपूर्ण यह है कि अपडेट के बाद, संपर्क में एक ऐसा चिह्न हो जो उसे सक्रिय संपर्कों से अलग करे। चूंकि API प्रति अनुरोध एक संपर्क को प्रोसेस करता है, बड़ी संख्या में ऑपरेशन कई कॉल को क्रम में निष्पादित करके किया जाता है। JavaScript और Python में कोड उदाहरण API दस्तावेज़ में उपलब्ध हैं और अपडेट एंडपॉइंट के लिए अनुकूलित किए जा सकते हैं।
4. बड़ी संख्या में बातचीतों को संग्रहित करना
बातचीतों के लिए, API एक एंडपॉइंट प्रदान करता है जो खाते में एक टैग बनाता है (यदि वह मौजूद नहीं है) और इसे संपर्क और खुली बातचीत पर लागू करता है। इस प्रकार, आप “संग्रहित” टैग बना सकते हैं और इसे उन सभी बातचीतों पर लागू कर सकते हैं जिन्हें आप मुख्य दृश्य से हटाना चाहते हैं।
प्रक्रिया संपर्कों के समान है: बातचीतों की सूची बनाएं, जिन्हें संग्रहित किया जाना चाहिए उन्हें फ़िल्टर करें और प्रत्येक के लिए टैग लगाने का अनुरोध भेजें। यदि टैग पहले से मौजूद नहीं है तो पहली कॉल में यह स्वचालित रूप से बन जाएगा।
5. संग्रहण की जाँच करना
स्क्रिप्ट समाप्त होने के बाद, Papo पैनल में संपर्क और बातचीत मॉड्यूल पर जाएं। केवल “संग्रहित” के रूप में चिह्नित आइटम देखने के लिए टैग द्वारा फ़िल्टर का उपयोग करें — या, इसके विपरीत, उन्हें छिपाने और सक्रिय रिकॉर्ड पर ध्यान केंद्रित करने के लिए। यदि ऑपरेशन का अपेक्षित प्रभाव नहीं हुआ है, तो पेलोड और प्रमाणीकरण हेडर की समीक्षा करें।
यह ऑटोमेशन किसके लिए उपयुक्त है
- बड़ी मात्रा में संपर्कों वाले संचालन जिन्हें समय-समय पर डेटाबेस साफ करने की आवश्यकता होती है, ठंडे लीड्स या समाप्त बातचीत को मुख्य दृश्य से हटाकर।
- व्हाइट लेबल रीसेलर्स जो दर्जनों ग्राहक खातों का प्रबंधन करते हैं और API के माध्यम से स्वचालित संगठन सेवा प्रदान करना चाहते हैं।
- IT टीमें और डेवलपर्स जो CRM को हमेशा सुव्यवस्थित रखने के लिए कस्टम इंटीग्रेशन बनाते हैं, मैन्युअल कार्यों पर निर्भर रहे बिना।
- वे कंपनियाँ जिन्होंने अन्य सिस्टम से डेटा माइग्रेट किया है और अब पुराने रिकॉर्ड संग्रहित करना चाहती हैं जो दैनिक उपयोग में नहीं आएंगे।
अक्सर पूछे जाने वाले प्रश्न
क्या Papo के API में संग्रहित करने के लिए कोई विशिष्ट एंडपॉइंट है?
विशिष्ट एंडपॉइंट की आवश्यकता नहीं है। आप रिकॉर्ड को संग्रहित के रूप में चिह्नित करने के लिए संपर्क अपडेट और बातचीत में टैग लगाने वाले एंडपॉइंट्स का उपयोग करते हैं। आधिकारिक दस्तावेज़ स्वीकृत पैरामीटर का विवरण देता है।
क्या मैं संग्रहित करने के बजाय संपर्कों या बातचीतों को हटा सकता हूँ?
वर्तमान API विलोपन एंडपॉइंट्स प्रदान नहीं करता है। सिफारिश यह है कि टैग या कस्टम एट्रिब्यूट के माध्यम से संग्रहण का उपयोग करें, जो डेटा को संरक्षित रखता है, लेकिन मुख्य दृश्य से बाहर।
मैं अनुरोधों को कैसे प्रमाणित करूँ?
सभी राइट कॉल में Authorization: Bearer {आपकी_गुप्त_कुंजी} हेडर शामिल करें। गुप्त कुंजी Papo पैनल में डेवलपर अनुभाग में जनरेट की जाती है।
क्या एक बार में हजारों रिकॉर्ड संग्रहित करना संभव है?
हाँ। बस एक स्क्रिप्ट बनाएं जो संपर्कों या बातचीतों की सूची पर लूप करे और प्रत्येक के लिए एक अनुरोध भेजे। n8n जैसे उपकरण भी इस प्रक्रिया को ऑर्केस्ट्रेट कर सकते हैं।
क्या संग्रहित बातचीत इनबॉक्स से गायब हो जाती हैं?
वे अस्तित्व में रहती हैं, लेकिन “संग्रहित” जैसा टैग लगाने पर, आप उन्हें डिफ़ॉल्ट दृश्य से बाहर फ़िल्टर कर सकते हैं। प्रदर्शन का तरीका बातचीत मॉड्यूल में कॉन्फ़िगर किए गए फ़िल्टर पर निर्भर करता है।
मुझे API कुंजियाँ कहाँ मिलेंगी?
Papo पैनल में, डेवलपर क्षेत्र या API सेटिंग्स पर जाएं। गुप्त कुंजी केवल निर्माण के समय दिखाई जाती है; यदि खो गई हो, तो नई जनरेट करनी होगी।
यह भी पढ़ें
- प्रोग्रामेटिक रूप से बातचीत सूचीबद्ध करने और संदेश भेजने के लिए Papo API का उपयोग कैसे करें
- संपर्कों के कस्टम एट्रिब्यूट प्रबंधित करने के लिए Papo API का उपयोग कैसे करें
मुफ्त में शुरू करें और API के साथ अपना डेटाबेस व्यवस्थित करें →
Papo के मुफ्त प्लान के साथ आप पहले से ही इंटीग्रेशन का परीक्षण कर सकते हैं और बिना किसी प्रारंभिक लागत के बड़ी संख्या में संपर्कों और बातचीतों को संग्रहित कर सकते हैं।