हाँ, आप Papo के Atendimentos मॉड्यूल का उपयोग करके API के ज़रिए सेवाएँ, समय और अपॉइंटमेंट प्रबंधित कर सकते हैं। REST API आपको सेवाएँ, पेशेवर और मरीज़ों की सूची देखने, शेड्यूल देखने और प्रोग्रामेटिक रूप से नए अपॉइंटमेंट बनाने की सुविधा देती है, जिससे पूरा बुकिंग फ़्लो आपकी वेबसाइट, ऐप या बाहरी सिस्टम से जुड़ जाता है।
Papo का Atendimentos मॉड्यूल आपके शेड्यूल का नियंत्रण केंद्र बनने के लिए डिज़ाइन किया गया है। यह चार स्तंभों को व्यवस्थित करता है: आपकी दी जाने वाली सेवाएँ (नाम, अवधि और कीमत के साथ), उन्हें करने वाले पेशेवर, प्रत्येक की समय उपलब्धता और किए गए अपॉइंटमेंट। API के साथ, आप मैन्युअल रूप से पैनल खोले बिना इन कार्यों को ऑटोमेट कर सकते हैं, जिससे Papo और आपके अन्य टूल्स के बीच सहज इंटीग्रेशन बना रहता है।
API के माध्यम से Atendimentos संचालनों का सारांश
| संचालन | क्या करता है | कब उपयोग करें |
|---|---|---|
| सेवाएँ सूचीबद्ध करें | पंजीकृत Atendimentos सेवाओं को अवधि और कीमत के साथ लौटाता है। | सेवा कैटलॉग को अपनी वेबसाइट या ऐप से सिंक करें ताकि ग्राहक विकल्प रीयल-टाइम में देख सके। |
| पेशेवर सूचीबद्ध करें | सेवाएँ करने वाले Atendentes या टीम सदस्यों की सूची लौटाता है। | बाहरी बुकिंग इंटरफ़ेस में उपलब्ध पेशेवर और उनकी विशेषज्ञताएँ दिखाएँ। |
| मरीज़ सूचीबद्ध करें | पंजीकृत मरीज़ों को नाम, फ़ोन और ID के साथ लौटाता है। | नया अपॉइंटमेंट बनाने या मौजूदा रिकॉर्ड से जोड़ने से पहले जाँचें कि ग्राहक CRM में पहले से है या नहीं। |
| अपॉइंटमेंट सूचीबद्ध करें | स्थिति (जैसे: पुष्ट, लंबित) के फ़िल्टर के साथ अपॉइंटमेंट लौटाता है। | बुकिंग ऑडिट करें, रिपोर्टिंग सिस्टम से इंटीग्रेट करें या नए समय देने से पहले शेड्यूल की व्यस्तता जाँचें। |
| अपॉइंटमेंट बुक करें | किसी पेशेवर के शेड्यूल में किसी विशिष्ट सेवा और मरीज़ के लिए वास्तविक अपॉइंटमेंट बनाता है। | ग्राहकों को सीधे आपकी वेबसाइट या ऐप से बुक करने दें, या बाहरी सिस्टम से बुकिंग बनाना ऑटोमेट करें। |
API प्रमाणीकरण कैसे काम करता है
Atendimentos में सभी लेखन संचालनों के लिए आपके Papo खाते की गुप्त कुंजी आवश्यक है, जिसे प्रमाणीकरण हेडर में Bearer टोकन के रूप में भेजा जाता है। खाते की सार्वजनिक कुंजी वैकल्पिक है, लेकिन अगर भेजी जाए, तो उसे गुप्त कुंजी के समान खाते से मेल खाना चाहिए।
API का बेस URL https://app.papo.global/api/v1 है। कुंजियाँ Papo पैनल के डेवलपर क्षेत्र में जनरेट की जाती हैं। गुप्त कुंजी निर्माण के समय केवल एक बार दिखाई जाती है; इसे सुरक्षित स्थान पर रखें और लीक होने का संदेह होते ही तुरंत रद्द करें।
व्यवहार में कैसे उपयोग करें
- Papo पैनल के डेवलपर/API क्षेत्र में जाएँ और गुप्त कुंजी जनरेट करें। खाते की सार्वजनिक कुंजी भी कॉपी करें।
- प्रत्येक अनुरोध में गुप्त कुंजी से Bearer टोकन के रूप में प्रमाणीकरण करें। यदि सत्यापन मजबूत करना चाहें, तो दस्तावेज़ में बताए गए हेडर में सार्वजनिक कुंजी भेजें।
- बुकिंग इंटरफ़ेस बनाने के लिए, पहले उपलब्ध सेवाएँ और पेशेवर सूचीबद्ध करें। इससे आप अपनी वेबसाइट या ऐप में विकल्पों को अपने Papo खाते के वास्तविक डेटा से गतिशील रूप से भर सकते हैं।
- अपॉइंटमेंट बनाने के लिए, Atendimento निर्माण endpoint को कॉल करें और JSON payload में सेवा, पेशेवर, मरीज़ के identifiers और वांछित दिनांक/समय भेजें। API Atendimentos मॉड्यूल में कॉन्फ़िगर किए गए शेड्यूल में उपलब्धता जाँचेगी और अपॉइंटमेंट बनाएगी।
- सटीक paths, अनिवार्य parameters और कोड उदाहरणों के लिए आधिकारिक दस्तावेज़
https://papo.global/pt/docsदेखें। सभी responses JSON प्रारूप में होते हैं।
API मौजूदा अपॉइंटमेंट को स्थिति के फ़िल्टर के साथ सूचीबद्ध करने की भी अनुमति देती है। यह ट्रैकिंग डैशबोर्ड बनाने, स्वचालित रिमाइंडर भेजने या बुकिंग की स्थिति को अन्य सिस्टम से इंटीग्रेट करने के लिए उपयोगी है।
यह इंटीग्रेशन किसके लिए उपयुक्त है
- क्लिनिक, कंसल्टेशन और ब्यूटी सैलून जो अपनी वेबसाइट पर रीयल-टाइम उपलब्धता के साथ ऑनलाइन बुकिंग देना चाहते हैं।
- SaaS प्लेटफ़ॉर्म और मार्केटप्लेस जिन्हें सेवा प्रदाताओं के शेड्यूल को बाहरी बुकिंग सिस्टम से जोड़ना है।
- white label रीसेलर जो अंतिम ग्राहकों के लिए कस्टम समाधान बनाते हैं और Atendimentos मॉड्यूल को API के ज़रिए उपलब्ध कराना चाहते हैं।
- ऑटोमेटेड फ़्लो वाली कंपनियाँ जो CRM, ERP या ऑटोमेशन टूल्स में events से अपॉइंटमेंट निर्माण ट्रिगर करती हैं।
अक्सर पूछे जाने वाले प्रश्न
API का उपयोग करने के लिए क्या Atendimentos मॉड्यूल कॉन्फ़िगर होना ज़रूरी है?
हाँ। API को उन्हें सूचीबद्ध करने और अपॉइंटमेंट सत्यापित करने के लिए सेवाएँ, पेशेवर और उनकी उपलब्धताएँ पहले से Papo के Atendimentos मॉड्यूल में पंजीकृत होनी चाहिए।
क्या API नई सेवा या पेशेवर बना सकती है?
API सुविधाएँ मौजूदा सेवाओं और पेशेवरों को सूचीबद्ध करने तथा अपॉइंटमेंट बुक करने पर केंद्रित हैं। सेवाएँ और पेशेवर बनाने या संपादित करने के लिए Papo पैनल का उपयोग करें।
API को कैसे पता चलता है कि कोई समय खाली है?
अपॉइंटमेंट बुक करने का अनुरोध भेजने पर, Papo API उस दिन और समय के लिए चुने गए पेशेवर और सेवा की कॉन्फ़िगर की गई उपलब्धता जाँचती है। यदि टकराव होता है, तो अपॉइंटमेंट नहीं बनेगा और API त्रुटि लौटाएगी।
क्या मैं ऐसे मरीज़ के नाम पर अपॉइंटमेंट बुक कर सकता हूँ जो अभी CRM में नहीं है?
आप पहले Papo की Contacts API से मरीज़ बना सकते हैं (नाम, ईमेल और/या फ़ोन के साथ) और फिर अपॉइंटमेंट बनाने के लिए लौटाए गए ID का उपयोग कर सकते हैं। contacts निर्माण endpoint के लिए दस्तावेज़ देखें।
क्या Papo की AI API के ज़रिए अपने आप अपॉइंटमेंट बुक कर सकती है?
Papo की Artificial Intelligence, जैसे Super Chat, WhatsApp पर बातचीत से सीधे Atendimentos मॉड्यूल का शेड्यूल देखकर बुक करती है। API बाहरी प्रोग्रामेटिक इंटीग्रेशन, जैसे ऑनलाइन बुकिंग सिस्टम, के लिए रास्ता है।
अपॉइंटमेंट बुक करने के लिए payload का सटीक प्रारूप कहाँ देखूँ?
आधिकारिक API दस्तावेज़ में, https://papo.global/pt/docs पर। वहाँ Atendimentos संसाधनों के लिए प्रमाणीकरण, parameters, responses और कोड उदाहरणों का विवरण है।
यह भी पढ़ें
- Papo API से बल्क में संपर्क बनाने और अपडेट करने का तरीका
- Papo API से एटिकेट्स (tags) बनाने और प्रबंधित करने का तरीका
API के ज़रिए अपना शेड्यूल इंटीग्रेट करना शुरू करें →
Papo पर साइन अप करें और पहले ही उपयोगकर्ता से अपने अपॉइंटमेंट ऑटोमेट करने के लिए REST API तक पहुँचें।