"बाह्य अनुरोध" को बॉट बिल्डर में क्रियाओं की ड्रॉप-डाउन सूची में "क्रिया" ब्लॉक में पाया जा सकता है।
बॉट्स में "बाहरी अनुरोध" का उपयोग करने के परिदृश्यों के उदाहरण
1. "ग्राहक चुनता है कि वह कौन सा स्टार वार्स चरित्र है": लिंक .
- भेजने का अनुरोध।
- अनुरोध का परीक्षण किया जा रहा है।
- एक सरल JSON पथ का वर्णन करना और प्रतिक्रिया से डेटा को एक कस्टम फ़ील्ड में लिखना।
- बॉट में प्राप्त डेटा का उपयोग करना.
तालिका से डेटा पढ़ने के लिए Google शीट्स के साथ एकीकरण लिंक .
- एकीकरण के लिए Google खाता सेट अप करना और तैयार करना.
- अनुरोध भेजना और उसका परीक्षण करना.
- अधिक जटिल JSON पथ का वर्णन करना और प्रतिक्रिया से डेटा को कस्टम फ़ील्ड में लिखना।
- बॉट में प्राप्त डेटा का उपयोग करना.
एयरो एसएमएस के माध्यम से एसएमएस भेजना : वीडियो का लिंक ।
4. रैंडम नंबर जनरेटर: लिंक .
टेलीग्राम में एजेंट को सूचनाएं भेजना : लिंक ।
ग्रामोटाडेल के माध्यम से प्रमाण पत्र जारी करना : वीडियो का लिंक ।
सामान्य विवरण
बाह्य अनुरोध कार्रवाई आपको यह करने की अनुमति देती है:
- बाहरी सेवाओं को उनके API के माध्यम से अनुरोध भेजें। उपलब्ध अनुरोध प्रकार:
- पाना
- डाक
- रखना
- पैबंद
- मिटाना
- भेजे गए अनुरोध के प्रत्युत्तर में बाह्य सेवा से प्राप्त डेटा को कस्टम सब्सक्राइबर फ़ील्ड में लिखें।
- परीक्षण के तौर पर, एक अनुरोध भेजें और एक मॉडल विंडो के अंदर प्रतिक्रिया प्राप्त करें।
- यदि अनुरोध भेजने के लिए मैक्रोज़ का उपयोग किया जाता है, तो परीक्षण के दौरान, उनके स्थान पर परीक्षण डेटा प्रतिस्थापित किया जाएगा, जिसके मान परीक्षण से पहले बदले जा सकते हैं।
"बाह्य अनुरोध" के लिए सभी सेटिंग्स एक अलग पॉप-अप (मोडल) विंडो में की जाती हैं जो संपादन के दौरान खुलती है।
"बाह्य अनुरोध" के सभी तत्वों की स्थापना और उद्देश्य नीचे वर्णित हैं।
अनुरोध प्रकार और URL
"अनुरोध प्रकार" ड्रॉप-डाउन सूची में, भेजे जाने वाले अनुरोध का प्रकार चुनें। आपको इसे उस API सेवा के विवरण में देखना होगा जिसके साथ आप इंटरैक्शन सेट अप कर रहे हैं।
"URL" फ़ील्ड में, वह पता निर्दिष्ट करें जिस पर अनुरोध भेजा जाएगा। आपको इसे सेवा API विवरण में भी देखना चाहिए।
URL दर्ज करते समय, आप मानक मैक्रोज़ (आपके खाते में मौजूद सभी मैक्रोज़) का उपयोग कर सकते हैं। किसी लिंक में मैक्रोज़ जोड़ने के लिए, आपको यह करना होगा:
- लिंक के बाद ही साइन लगाएं "?»;
- पैरामीटर सूचीबद्ध करते समय, मैक्रोज़ को " चिह्न से जोड़ें&».
उदाहरण: link.ru?utm_content=1&{%pole%}.
शीर्षक अनुभाग
यह अनुभाग भेजे जाने वाले अनुरोध के लिए शीर्षलेख निर्दिष्ट करता है।
तुम कर सकते हो:
- शीर्षक जोड़ें/हटाएँ;
- "शीर्षक" मान वाले फ़ील्ड में मानक मैक्रोज़ का उपयोग करें। मैक्रोज़ का उपयोग करते समय, प्रत्येक ग्राहक के लिए शीर्षक मान अलग-अलग होगा।
महत्वपूर्ण! डेटा तुलना के सही संचालन के लिए, अनुरोध और सेवा प्रतिक्रिया, दोनों में
Content-Type हेडर आवश्यक है मान्य मान: application/json और text/html
अनुभाग "शरीर"
यह अनुभाग अनुरोध के मुख्य भाग का वर्णन करता है। इस अनुभाग के लिए, आपको तृतीय-पक्ष सेवा की सेटिंग से कोड लेना होगा।
मुख्य भाग का वर्णन JSON प्रारूप में होना चाहिए।
अनुरोध बॉडी भरते समय, मानक मैक्रोज़ के उपयोग की अनुमति है।
"पूर्वावलोकन" के दाहिने भाग में प्रविष्ट बॉडी का स्वचालित सत्यापन और स्वरूपण किया जाता है।
महत्वपूर्ण! यह अनुभाग GET प्रकार के अनुरोधों के लिए उपलब्ध नहीं है।
उत्तर अनुभाग
यह अनुभाग उस प्रतिक्रिया को प्रदर्शित करता है जो अनुरोध परीक्षण शुरू होने पर बाह्य सेवा से आएगी।
अपने अनुरोध का परीक्षण शुरू करने के लिए, अनुरोध सबमिट करें या अनुरोध का परीक्षण करें पर .
यदि आप हेडर, बॉडी या URL में मैक्रोज़ का उपयोग करते हैं, तो परीक्षण के दौरान मैक्रोज़ को परीक्षण मानों से बदल दिया जाएगा। आप "परीक्षण डेटा" ड्रॉप-डाउन सूची खोलकर और वांछित मैक्रो के लिए "परीक्षण मान" फ़ील्ड में मान बदलकर परीक्षण मान बदल सकते हैं।
आपके द्वारा सफलतापूर्वक परीक्षण अनुरोध भेजने के बाद, प्राप्त प्रतिक्रिया टैब के दाईं ओर प्रदर्शित होगी। आप प्रतिक्रिया शीर्षक और प्रतिक्रिया मुख्य भाग देख सकते हैं।
प्रतिक्रिया निकाय में प्राप्त मानों को प्रतिक्रिया मैपिंग टैब का उपयोग करके ग्राहक कस्टम फ़ील्ड में सहेजा जा सकता है।
अनुभाग "उत्तरों की तुलना"
इस अनुभाग में, आप प्रतिक्रिया मैपिंग को कॉन्फ़िगर कर सकते हैं ताकि अनुरोध के जवाब में प्राप्त डेटा निर्दिष्ट ग्राहक कस्टम फ़ील्ड में लिखा जाए।
अनुरोध परीक्षण शुरू होने पर डेटा और इसकी संरचना को प्रतिक्रिया बॉडी अनुभाग में प्रतिक्रिया टैब पर देखा जा सकता है:
यह ट्यूटोरियल एक अनुरोध का परीक्षण करने, मिलान स्थापित करने और फिर बॉट में डेटा का उपयोग करने के परिदृश्य का वर्णन करता है।
मैपिंग सेट अप करने के लिए आपको यह करना होगा:
- + मिलान जोड़ें पर क्लिक करके एक मिलान नियम जोड़ें ;
- JSON पथ निर्दिष्ट करें — प्रतिक्रिया निकाय में वह पथ जिससे प्राप्त मान प्राप्त किया जाना चाहिए। JSON पथ लिखने के तरीके पर विस्तृत निर्देश
- एक कस्टम फ़ील्ड निर्दिष्ट करें जिसमें प्रतिक्रिया में प्राप्त मान सहेजा जाएगा.
महत्वपूर्ण! Save पर क्लिक करना न भूलें ।
महत्वपूर्ण! बाह्य क्वेरी सेटिंग्स को रीसेट होने से रोकने के लिए, उस क्रिया चरण को सहेजना सुनिश्चित करें जिसमें आपने बाह्य क्वेरी जोड़ी थी।
अक्सर पूछे जाने वाले प्रश्नों
मैं हेडर के लिए कुंजी कहां से प्राप्त कर सकता हूं?
यह सेवा और उस विधि पर निर्भर करता है जिससे बाहरी अनुरोध के माध्यम से एकीकरण कॉन्फ़िगर किया जाता है। तृतीय-पक्ष सेवा की सेटिंग्स के विवरण में डेटा की एक सूची होगी, जिसमें यह बताया जाएगा कि कहाँ और कौन सी कुंजियाँ डालनी हैं।
बाहरी क्वेरी का उपयोग करने के उदाहरण
व्यक्तिगत प्रमाणपत्रों का स्वचालित जारीकरण।
ग्राहकों को एसएमएस संदेश भेजना।
टेलीग्राम चैनल में सूचनाएं.
बाह्य अनुरोध क्रिया आपको बाह्य सेवाओं से जानकारी भेजने या अनुरोध करने, तथा फिर उनसे प्रतिक्रिया प्राप्त करने और उसे ग्राहकों के कस्टम फ़ील्ड में लिखने की अनुमति देती है।
नीचे हम "बाहरी अनुरोध" क्रिया का उपयोग करने के सबसे सरल परिदृश्य पर विचार करेंगे। यह परिदृश्य वास्तविकता से कोसों दूर है, लेकिन यह "बाहरी अनुरोध" की स्थापना और कार्यक्षमता के सभी चरणों को दर्शाता है।
परिदृश्य और उसकी सेटिंग्स का विवरण
इस उदाहरण में, हम swapi.dev । यह सेवा स्टार वार्स फ़िल्म श्रृंखला के बारे में जानकारी संग्रहीत करती है: फ़िल्म के शीर्षक, पात्रों के नाम और उनकी विशेषताएँ, वाहनों, ग्रहों, जातियों आदि का विवरण।
दूसरे शब्दों में, यह सेवा स्टार वार्स ब्रह्मांड पर एक विकिपीडिया है।
पटकथा के मुख्य चरण
- ग्राहक बॉट में प्रवेश कर जाता है।
- बॉट ग्राहक आईडी के साथ swapi.dev सेवा को एक अनुरोध भेजता है।
- यह सेवा उस पात्र का विवरण लौटाती है जिसकी आईडी ग्राहक की आईडी के समान होती है।
- बॉट कस्टम फ़ील्ड में पात्र का नाम लिखता है और ग्राहक को यह मान प्रदर्शित करता है।
बॉट सेट अप करना
एक सरल बॉट श्रृंखला बनाएं:
- एक ब्लॉक "संदेश 1" जोड़ें.
- स्वागत पाठ लिखें.
- अगले चरण पर जाने के लिए एक बटन जोड़ें.
- एक ब्लॉक "संदेश 2" जोड़ें.
- उपयोगकर्ता की आईडी प्रदर्शित करें.
- इस आईडी का उपयोग करके, बाह्य सेवा अपने डेटाबेस में वर्ण ढूंढ लेगी।
- एक्शन 1 ब्लॉक जोड़ें.
- इस ब्लॉक में, “बाहरी अनुरोध” कार्रवाई का चयन करें (हम नीचे बाहरी अनुरोध सेटिंग्स पर चर्चा करेंगे)।
- एक ब्लॉक "संदेश 3" जोड़ें.
- एक कस्टम फ़ील्ड आउटपुट करें जिसमें आप बाहरी सेवा से प्राप्त वर्ण नाम लिखेंगे।
- सभी ब्लॉकों को कनेक्ट करें और आपको इस तरह का एक छोटा बॉट मिलेगा:
"बाहरी अनुरोध" सेट अप करना
- जब आप "एक्शन 1" ब्लॉक में "एक्सटर्नल क्वेरी" एक्शन जोड़ते हैं, तो "एक्सटर्नल क्वेरी" एडिटिंग विंडो खोलने के लिए "पेंसिल" पर क्लिक करें। फिर आपको खुलने वाली विंडो में सब कुछ कॉन्फ़िगर करना होगा।
- अनुरोध URL दर्ज करें.
- swapi.dev सेवा के विवरण में, उस विधि जो चरित्र की विशेषताओं को वापस करेगी: https://swapi.dev/api/people/ 1 /
- पते को कॉपी करें और URL फ़ील्ड में पेस्ट करें.
- इस पते में, "1" वर्ण आईडी है। इस मान के बजाय, एक मैक्रो डालें जो स्वचालित रूप से ग्राहक की आंतरिक आईडी को प्रतिस्थापित कर देगा। ऐसा करने के लिए, <> और वांछित मैक्रो चुनें।
- अंतिम लिंक: https://swapi.dev/api/people/{%bh_user_id%}
- अनुरोध प्रकार का चयन करें.
- इस अनुरोध का प्रकार GET है। यह जानकारी बाहरी सेवा की वेबसाइट पर उसके API के विवरण के साथ उपलब्ध होनी चाहिए। "अनुरोध प्रकार" ड्रॉप-डाउन सूची में GET चुनें।
- इस विधि में भरने के लिए कोई हेडर या बॉडी नहीं है, इसलिए अनुरोध का परीक्षण करने के लिए आगे बढ़ें।
- अनुरोध का परीक्षण करने और यह सुनिश्चित करने के लिए कि सब कुछ सही ढंग से काम करता है और सेवा सही प्रतिक्रिया लौटाती है, प्रतिक्रिया टैब पर जाएं या परीक्षण अनुरोध ।
- खुले हुए टैब में, आपको इस्तेमाल किए गए मैक्रोज़ का परीक्षण डेटा दिखाई देगा। डिफ़ॉल्ट मान 10 है। ज़रूरत पड़ने पर आप इसे बदल सकते हैं।
- परीक्षण शुरू करने के लिए, अनुरोध भेजें ।
- प्रतिक्रिया "200 OK" है, जिसका अर्थ है कि बाहरी सेवा ने आपका अनुरोध प्राप्त कर लिया है और सफलतापूर्वक प्रतिक्रिया दे दी है।
- विंडो के दाईं ओर, "प्रतिक्रिया बॉडी" अनुभाग में, आप देख सकते हैं कि आपके अनुरोध के जवाब में आपको क्या प्राप्त हुआ।
- आपको "नाम" फ़ील्ड का मान चाहिए। इसी फ़ील्ड का मान आप सब्सक्राइबर के कस्टम फ़ील्ड में अपने आप लिख देंगे।
- प्रतिक्रिया मिलान सेट करें.
- प्रतिक्रिया मैपिंग आपको तर्क सेट करने की अनुमति देता है जो प्राप्त प्रतिक्रिया निकाय से आवश्यक फ़ील्ड का मान लेगा और इसे निर्दिष्ट ग्राहक कस्टम फ़ील्ड में लिख देगा।
- ऐसा करने के लिए, आपको वह पथ निर्दिष्ट करना होगा जिसके द्वारा आप प्रतिक्रिया बॉडी में आवश्यक फ़ील्ड ढूंढना चाहते हैं ( यहां और पढ़ें ), और वह उपयोगकर्ता फ़ील्ड जिसमें आप मान सहेजना चाहते हैं।
- मैपिंग जोड़ें और दिखाई देने वाले फ़ील्ड भरें.
- JSON पथ मान "$.name" प्राप्त प्रतिक्रिया के मुख्य भाग से "name" फ़ील्ड का मान लौटाएगा। परीक्षण के उदाहरण में, मान "Obi-Wan Kenobi" था।
- इससे बाह्य अनुरोध की स्थापना पूर्ण हो जाती है।
- सेव पर क्लिक करके इसकी सेटिंग्स को सेव करना सुनिश्चित करें ।
- सहेजें और बंद करें पर क्लिक करके खुले चरण "कार्रवाई 1" की सेटिंग्स को सहेजना सुनिश्चित करें ।
बाहरी अनुरोध के साथ बॉट का परीक्षण करना
- बॉट का परीक्षण शुरू करें.
- परिणामस्वरूप, आपको इस प्रकार के संदेशों की एक श्रृंखला प्राप्त होगी:
मैं डार्थ वेडर हूं, आप कौन हैं? :)
बाह्य अनुरोध कार्रवाई का सामान्य विवरण यहां पाया जा सकता है: लिंक ।
यदि आपको अपने प्रश्न का उत्तर नहीं मिला है, तो अपने खाते के अंदर चैट में हमसे पूछें या BotHelpSupportBot या hello@bothelp.io
मेलिंग, ऑटोफ़नल और चैटबॉट्स बॉटहेल्प बनाने के लिए प्लेटफ़ॉर्म की 14 दिनों की पूर्ण कार्यक्षमता प्राप्त करें।