Yandex.Cloud में टेलीग्राम बॉट का निर्माण

आज हम स्क्रैप सामग्री से असेंबल करेंगे यांडेक्स.क्लाउड टेलीग्राम बॉट साथ यांडेक्स क्लाउड फ़ंक्शंस (या यांडेक्स कार्य करता है - संक्षेप में) और यांडेक्स ऑब्जेक्ट स्टोरेज (या वस्तु भंडारण - विस्तृत जानकारी के लिए)। कोड चालू रहेगा Node.js. हालाँकि, एक विचित्र परिस्थिति है - एक निश्चित संगठन जिसे कहा जाता है, मान लीजिए, RossKomTsenzur (सेंसरशिप रूसी संघ के संविधान के अनुच्छेद 29 द्वारा निषिद्ध है), रूसी इंटरनेट प्रदाताओं को अनुरोध प्रेषित करने की अनुमति नहीं देता है टेलीग्राम एपीआई पते पर: https://api.telegram.org/. खैर, हम ऐसा नहीं करेंगे - नहीं, नहीं। आख़िरकार, हमारे बैग में तथाकथित हैं। वेबहुक — उनकी मदद से, हम किसी विशिष्ट पते पर अनुरोध नहीं करते हैं, बल्कि किसी भी अनुरोध के जवाब के रूप में अपना अनुरोध हमें भेजते हैं। यानी, ओडेसा की तरह, हम एक प्रश्न का उत्तर एक प्रश्न से देते हैं। इसीलिए टेलीग्राम एपीआई हमारे कोड में दिखाई नहीं देगा.

исклеймерइस लेख में उल्लिखित किसी भी सरकारी संगठन के नाम काल्पनिक हैं, और वास्तविक जीवन के संगठनों के नामों के साथ संभावित मिलान संयोग है।

तो, हम एक बॉट बनाएंगे जो हमें स्मार्ट विचार प्रदान करेगा। बिल्कुल चित्र की तरह:

आप इसे क्रियान्वित करके देख सकते हैं - नाम यह है: @SmartThoughtsBot. बटन पर ध्यान गया "ऐलिस का कौशल"? ऐसा इसलिए है क्योंकि बॉट उसी नाम के बॉट के लिए एक प्रकार का "साथी" है। ऐलिस का कौशल, अर्थात। यह के समान ही कार्य करता है ऐलिस का कौशल और यह संभव है कि वे एक-दूसरे का विज्ञापन करके शांतिपूर्वक सह-अस्तित्व में रह सकेंगे। बनाने के तरीके के बारे में कौशल स्मार्ट विचार लेख में वर्णित है ऐलिस ने कौशल हासिल किया. अब (उपरोक्त लेख के प्रकाशन के बाद कुछ बदलाव करने के बाद) स्मार्टफोन पर यह कौशल कुछ ऐसा दिखाई देगा:

एक बॉट बनाना

मैं चाहूंगा कि यह ट्यूटोरियल सभी के लिए उपयोगी हो। और नौसिखिया बॉट बिल्डर्स। इसलिए, इस अनुभाग में मैं कुछ विस्तार से वर्णन करूंगा कि सामान्य रूप से कैसे बनाया जाए Telegram'ई बॉट्स. जिन लोगों को इस जानकारी की आवश्यकता नहीं है, उनके लिए निम्नलिखित अनुभागों पर आगे बढ़ें।

एप्लिकेशन खोलें टेलीग्रामआइए सभी बॉट्स के पिता को बुलाएं (उनके पास लोगों की तरह सब कुछ है) - @ बाटफादर - और सबसे पहले हम उसे /help कमांड देंगे ताकि उसकी याद ताजा हो सके कि हम क्या कर सकते हैं। अब हमें टीम में दिलचस्पी होगी / newbot.

चूंकि यहां वर्णित बॉट पहले ही बनाया जा चुका है, प्रदर्शन उद्देश्यों के लिए मैं थोड़े समय के लिए एक और बॉट बनाऊंगा (और फिर इसे हटा दूंगा)। मैं उसे फोन करूंगा डेमोहैबरबॉट. नाम (उपयोगकर्ता नाम) सभी टेलीग्राम बॉट शब्द के साथ समाप्त होने चाहिए थूथन, उदाहरण के लिए: माईकूलबॉट या मेरा_कूल_बॉट - यह बॉट्स के लिए है। लेकिन पहले हम बॉट को एक नाम देते हैं (नाम) - और यह लोगों के लिए है। नाम किसी भी भाषा में हो सकता है, इसमें रिक्त स्थान हो सकता है और इसका अंत किसी शब्द से नहीं होना चाहिए थूथन, और इसका अद्वितीय होना भी आवश्यक नहीं है। इस उदाहरण में, मैंने इसे बॉट कहा है डेमो हबर.

अब बॉट के लिए एक नाम चुनें (उपयोगकर्ता नाम, बॉट्स के लिए एक)। चलो उसे बुलाते हैं डेमोहैबरबॉट. बॉट के नाम से जुड़ी हर चीज़ (नाम) उसके नाम से बिल्कुल भी संबंधित नहीं है - उपयोगकर्ता नाम (या लागू होता है, लेकिन बिल्कुल विपरीत)। एक अद्वितीय बॉट नाम सफलतापूर्वक बनाने के बाद, हमें स्क्रीनशॉट में दिखाए गए टोकन को लाल तीर के साथ कॉपी और सहेजना होगा (पूरे विश्वास के साथ!)। इसकी सहायता से हम बाद में इसकी उत्पत्ति स्थापित करेंगे Telegram'हमारे लिए एक वेबहुक यांडेक्स फ़ंक्शन.

आइए अब सभी बॉट्स के जनक को आदेश दें: /मायबोट्स, और यह हमें हमारे द्वारा बनाए गए सभी बॉट्स की एक सूची दिखाएगा। आइए अभी ताजा पके हुए बॉट को अकेला छोड़ दें डेमो हबर (इसे यह दिखाने के लिए बनाया गया था कि बॉट कैसे बनाएं, लेकिन हम आज इसका उपयोग अन्य प्रदर्शन उद्देश्यों के लिए भी करेंगे), और आइए बॉट को देखें स्मार्ट विचार (@SmartThoughtsBot). बॉट्स की सूची में उसके नाम वाले बटन पर क्लिक करें।

यहां हम अपने बॉट को कॉन्फ़िगर कर सकते हैं। बटन दबाकर संपादित करें ... हम एक या दूसरे विकल्प को संपादित करने के लिए आगे बढ़ेंगे। उदाहरण के लिए, बटन पर क्लिक करके नाम संपादित करें इसके बजाय, हम बॉट का नाम बदल सकते हैं स्मार्ट विचारलिखो पागल विचार. बॉटपिक - यह बॉट का अवतार है, कम से कम होना ही चाहिए 150 एक्स 150 px. Description — यह एक संक्षिप्त विवरण है जिसे उपयोगकर्ता पहली बार बॉट शुरू करते समय प्रश्न के उत्तर के रूप में देखता है: यह बॉट क्या कर सकता है? About - एक और भी संक्षिप्त विवरण, जो बॉट के लिंक के साथ प्रसारित होता है (https://t.me/SmartThoughtsBot) या इसके बारे में जानकारी देखते समय।

हमें बस कमांड सेट करना है। ऐसा करने के लिए, बटन दबाएँ आदेश संपादित करें. उपयोगकर्ता अभ्यास को मानकीकृत करना Telegram हमेशा दो आदेशों का उपयोग करने की अनुशंसा करता है: / शुरू и /मदद, और यदि बॉट को सेटिंग्स की आवश्यकता है, तो अतिरिक्त /सेटिंग्स कमांड का उपयोग करें। हमारा बॉट एक गेंद की तरह सरल है, इसलिए इसे अभी तक किसी सेटिंग की आवश्यकता नहीं है। हम पहले दो कमांड लिखते हैं, जिन्हें हम फिर कोड में प्रोसेस करेंगे। अब, यदि उपयोगकर्ता इनपुट फ़ील्ड में स्लैश (स्लैश चिह्न: /) दर्ज करता है, तो त्वरित चयन के लिए कमांड की एक सूची दिखाई देगी। चित्र में सब कुछ वैसा ही है: बाईं ओर - हम फादर बॉट के माध्यम से कमांड इंस्टॉल करते हैं; दाईं ओर, ये आदेश हमारे बॉट में उपयोगकर्ताओं के लिए पहले से ही उपलब्ध हैं।

यांडेक्स फ़ंक्शन

अब जब हमारा बॉट बन गया है, तो चलिए आगे बढ़ते हैं यांडेक्स.क्लाउडएक फ़ंक्शन बनाने के लिए जो हमारे बॉट के कोड को निष्पादित करेगा। अगर आपने साथ काम नहीं किया है यांडेक्स.क्लाउड सामग्री पढ़ें बिट्रिक्स की भूमि में ऐलिस, और फिर - यांडेक्स फ़ंक्शंस मेल भेजते हैं. मुझे पूरा यकीन है कि विषय की बुनियादी समझ पाने के लिए ये दो अपेक्षाकृत छोटे लेख आपके लिए पर्याप्त होंगे।

तो कंसोल में यांडेक्स.क्लाउड बाएँ नेविगेशन मेनू में आइटम का चयन करें क्लाउड फ़ंक्शंस, और फिर बटन दबाएँ एक फ़ंक्शन बनाएं. हम इसे अपने लिए एक नाम और संक्षिप्त विवरण देते हैं।

बटन दबाने के बाद बनाएँ और कुछ सेकंड के बाद, नया फ़ंक्शन सभी फ़ंक्शन की सूची में दिखाई देगा। उसके नाम पर क्लिक करें - यह हमें पेज पर ले जाएगा Обзор हमारा कार्य. यहां आपको सक्षम करने की आवश्यकता है (On) बदलना सार्वजनिक समारोहताकि यह बाहरी (के लिए) से सुलभ हो सके यांडेक्स.क्लाउड) दुनिया का, और क्षेत्रों का अर्थ कॉल लिंक и पहचानकर्ता - इसे अपने और टेलीग्राम के अलावा बाकी सभी से गुप्त रखें, ताकि आपके कार्य को विभिन्न स्कैमर्स द्वारा कॉल न किया जा सके।

अब, बाएँ मेनू का उपयोग करके, पर जाएँ संपादक कार्य. आइए एक पल के लिए अपनी बात अलग रखें स्मार्ट विचार, और हमारे बॉट की कार्यक्षमता की जांच करने के लिए एक न्यूनतम टेम्पलेट फ़ंक्शन बनाएं... हालांकि, इस संदर्भ में, यह फ़ंक्शन हमारा बॉट है... संक्षेप में, अभी और यहीं हम एक सरल बॉट बनाएंगे जो "मिरर" करेगा ( यानी उपयोगकर्ता अनुरोध वापस भेजें। संचार सुनिश्चित करने के लिए नए टेलीग्राम बॉट बनाते समय इस टेम्पलेट का हमेशा उपयोग किया जा सकता है तार'ओम ठीक काम करता है. क्लिक फ़ाइल बनाएँ, चलो उसे बुलाते हैं index.js, और ऑनलाइन कोड संपादक इस फ़ाइल में निम्नलिखित कोड पेस्ट करें:

module.exports.bot = async (event) => {
  
  const body = JSON.parse(event.body);

  const msg = {
    'method': 'sendMessage',
    'chat_id': body.message.chat.id,
    'text': body.message.text
  };

  return {
    'statusCode': 200,
    'headers': {
      'Content-Type': 'application/json'
    },
    'body': JSON.stringify(msg),
    'isBase64Encoded': false
  };
};

Yandex.Cloud कंसोल में इसे कुछ इस तरह दिखना चाहिए:

आगे हम संकेत देते हैं प्रवेश बिंदु - सूचकांक.बॉटजहां अनुक्रमणिका यह फ़ाइल नाम है (index.js), और थूथन - फ़ंक्शन का नाम (मॉड्यूल.निर्यात.बॉट). अन्य सभी फ़ील्ड को वैसे ही छोड़ दें, और ऊपरी दाएं कोने में बटन पर क्लिक करें संस्करण बनाएँ. कुछ ही सेकंड में फ़ंक्शन का यह संस्करण तैयार हो जाएगा. परीक्षण के तुरंत बाद WEbhook, हम एक नया संस्करण बनाएंगे - स्मार्ट विचार.

वस्तु भंडारण

अब जब हमने बना लिया है यांडेक्स फ़ंक्शन, चलो, जब तक हम कंसोल में हैं यांडेक्स.क्लाउड, आइए तथाकथित बनाएं बाल्टी (बाल्टी, अर्थात। रूसी में बाल्टी, गुलदस्ता बिल्कुल नहीं) छवि फ़ाइलों को संग्रहीत करने के लिए जिनका उपयोग हमारे बॉट में किया जाएगा स्मार्ट विचार. बाएँ नेविगेशन मेनू में आइटम का चयन करें ऑब्जेक्ट स्टोरेज, बटन दबाएँ एक बाल्टी बनाएं, इसके लिए एक नाम लेकर आएं, उदाहरण के लिए, img-बाल्टी, और सबसे महत्वपूर्ण रूप से, वस्तुओं तक पहुंच पढ़ें हम इसे सार्वजनिक करते हैं - अन्यथा टेलीग्राम हमारी तस्वीरें नहीं देख पाएगा। हम अन्य सभी क्षेत्रों को अपरिवर्तित छोड़ देते हैं। बटन दबाएँ एक बाल्टी बनाएं.

इसके बाद, सभी बकेट की सूची कुछ इस तरह दिख सकती है (यदि यह आपकी एकमात्र बकेट है):

अब मैं आपके विभिन्न अनुप्रयोगों के लिए छवियों के भंडारण को व्यवस्थित करने के लिए बकेट के नाम पर क्लिक करने और उसके अंदर एक फ़ोल्डर बनाने का सुझाव देता हूं। उदाहरण के लिए, टेलीग्राम बॉट के लिए स्मार्ट विचार मैंने नामक एक फ़ोल्डर बनाया टीजी-बॉट-स्मार्ट-विचार (कुछ नहीं, मैं इस कोड को समझूंगा)। एक भी बनाएं.

अब आप फ़ोल्डर नाम पर क्लिक कर सकते हैं, उसमें जा सकते हैं और फ़ाइलें अपलोड कर सकते हैं:

और फ़ाइल नाम पर क्लिक करके - इसे प्राप्त करें यूआरएल हमारे बॉट में और सामान्य तौर पर - कहीं भी उपयोग के लिए (लेकिन इसे प्रकाशित न करें यूआरएल अनावश्यक, से यातायात के बाद से वस्तु भंडारण चार्ज किया गया)।

इसमें मूलतः बस इतना ही है वस्तु भंडारण. अब आपको पता चल जाएगा कि जब आपको वहां फ़ाइलें अपलोड करने का संकेत दिखे तो क्या करना चाहिए।

WEbhook

अब हम इंस्टॉल करेंगे WEbhook - अर्थात। जब बॉट को सर्वर से अपडेट (उदाहरण के लिए, उपयोगकर्ता से एक संदेश) प्राप्त होता है Telegram हमारे में यांडेक्स फ़ंक्शन एक अनुरोध भेजा जाएगा (का अनुरोध) डेटा के साथ। यहां एक पंक्ति है जिसे आप बस अपने ब्राउज़र के पता फ़ील्ड में पेस्ट कर सकते हैं और फिर पृष्ठ को रीफ्रेश कर सकते हैं (आपको यह केवल एक बार करना होगा): https://api.telegram.org/bot{bot_token}/setWebHook?url={webhook_url}
हम बस इसे बदल देंगे {बॉट_टोकन} अपना बॉट बनाते समय हमें फादर बॉट से जो टोकन प्राप्त हुआ था, और {webhook_url} - पर यूआरएल हमारे यांडेक्स कार्य करता है. ज़रा ठहरिये! लेकिन RossKomTsenzur रूसी संघ में प्रदाताओं को पते की सेवा देने से रोकता है https://api.telegram.org. हाँ यह सही है। लेकिन कुछ लेकर आओ. आख़िरकार, उदाहरण के लिए, आप यूक्रेन, इज़राइल या कनाडा में अपनी दादी से इस बारे में पूछ सकते हैं - वहाँ कोई "रॉसकोमसेंसरशिप" नहीं है, और भगवान ही जानता है कि लोग इसके बिना कैसे रहते हैं। परिणामस्वरूप, वेबहुक स्थापित करते समय अनुरोध-प्रतिक्रिया इस तरह दिखनी चाहिए:

हम परीक्षण कर रहे हैं. इसे "दर्पण" करना चाहिए।

यह सच है। हमारी बधाई - अभी यांडेक्स फ़ंक्शन बन गया है Telegram-बॉट!

स्मार्ट विचार

अब आइए स्मार्ट विचार करें। कोड खुला है और चालू है GitHub. इस पर काफी अच्छी टिप्पणी की गई है और यह केवल सौ पंक्तियाँ लंबी है। इसे ओपेरा दिवा लिब्रेटो की तरह पढ़ें!

प्रोजेक्ट को क्लोन करें और निर्भरताएँ स्थापित करें:

git clone https://github.com/stmike/tg-bot-smart-thoughts.git
cd tg-bot-smart-thoughts
npm i

फ़ाइल में आवश्यक परिवर्तन करें index.js (वैकल्पिक; आपको कुछ भी बदलने की ज़रूरत नहीं है)। बनाएं ज़िप-संग्रह, फ़ाइल के साथ index.js और फ़ोल्डर नोड_मॉड्यूल अंदर, उदाहरण के लिए, नाम के तहत स्मार्ट.ज़िप.

अब हमारे कंसोल पर जाएं यांडेक्स कार्य करता है, टैब चुनें ज़िप संग्रह, बटन दबाएँ फ़ाइल का चयन करें, और हमारा संग्रह डाउनलोड करें स्मार्ट.ज़िप. अंत में, ऊपरी दाएं कोने में, बटन पर क्लिक करें संस्करण बनाएँ.

कुछ ही सेकंड में, जब फ़ंक्शन अपडेट हो जाएगा, तो हम अपने बॉट का फिर से परीक्षण करेंगे। अब वह "दर्पण" नहीं करता, बल्कि स्मार्ट विचार प्रस्तुत करता है!

यह सभी आज के लिए है। आगे और लेख आएंगे। यदि आप इसे पढ़ने में रुचि रखते हैं, तो नए लेखों के बारे में अधिसूचनाओं की सदस्यता लें। आप यहां या यहां सदस्यता ले सकते हैं Telegram-चैनल आईटी ट्यूटोरियल ज़खरया ट्विटर @माइकज़ाहारोव.

संदर्भों

GitHub पर कोड
यांडेक्स क्लाउड फ़ंक्शंस
यांडेक्स ऑब्जेक्ट स्टोरेज
बॉट्स: डेवलपर्स के लिए एक परिचय
टेलीग्राम बॉट एपीआई

दान

स्रोत: www.habr.com