नमस्कार, हेब्र! मुझे अपना परिचय दें: मेरा नाम सर्गेई अगल्त्सोव है, और मैं एक "जीवन में प्रोग्रामर हूं।" इसका मतलब यह है कि मैं लंबे समय से एक आईटी प्रबंधक रहा हूं, और पेशे से प्रोग्रामर बिल्कुल नहीं, लेकिन मैं अपनी मुख्य गतिविधि और शौक के रूप में लगातार प्रोग्रामिंग का उपयोग करता हूं। जैसा कि मेरे पूर्व मालिकों में से एक ने अक्सर कहा - "शेरोगा! आप फिर से प्रोग्रामिंग में फिसल गए हैं!" सच है, मैं यह नहीं कह सकता कि वह या कोई अन्य कभी भी इससे बहुत असंतुष्ट रहा है।

टैमटाम मैसेंजर पर बॉट एपीआई की उपस्थिति के बाद, मैं, एक सच्चे और इसलिए आलसी प्रोग्रामर के रूप में, इसके साथ काम करने के लिए 2 पायथन लाइब्रेरी बनाई:

• ओपन क्लाइंट एपीआई (इसके बाद - ओएसी) - शुरू में इसे एपीआई योजना के आधार पर ओपनएपीआई जनरेटर का उपयोग करके उत्पन्न किया गया था, फिर इसे जनरेटर की विशेषताओं को ध्यान में रखते हुए अनुकूलित किया गया;
• इस क्लाइंट के लिए शेल TamTamBot (इसके बाद - TTB) है, जो OAC के साथ काम को सरल करता है।

तो एक निश्चित टैटम पायथन एसडीके था।

मैंने सबसे पहले यह किया "अपने लिए, आत्मा के लिए", लेकिन यह भी सुझाव दिया कि तमताम समुदाय, यदि वांछित है, तो इसका उपयोग करें। लेकिन, जैसा कि आप जानते हैं, एक भी अच्छा काम नहीं किया जाता है - लोगों ने एक प्रशिक्षण लेख लिखने के लिए कहा। और यहाँ मैं इस लेख के साथ हूं। इसमें, मैं आपको बताऊंगा कि इन पुस्तकालयों का उपयोग करके एक साधारण बॉट कैसे विकसित किया जाए।

कार्य

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

यह समझा जाता है कि पाठक ने अजगर 3 स्थापित किया है , git , PyCharm विकास पर्यावरण से जुड़ा है (विकास का वातावरण अलग हो सकता है, लेकिन कहानी PyCharm पर आधारित होगी)। ओओपी की मूल बातें समझना वांछनीय है।

बॉट टोकन मिल रहा है

टोकन विशेष बॉट @PrimeBot पर कॉल के माध्यम से प्राप्त किया जाता है

हम तमताम में इस बॉट को ढूंढते हैं, / कमांड बनाते हैं और प्रश्नों का उत्तर देते हैं:

• लैटिन अक्षरों में बॉट का अद्वितीय संक्षिप्त नाम दर्ज करें - यह बॉट का उपयोगकर्ता नाम है जिसके द्वारा यह @ के माध्यम से या https://tt.me/username फॉर्म के लिंक द्वारा उपलब्ध होगा। उपयोगकर्ता नाम पर कोई विशेष प्रतिबंध नहीं हैं। विशेष रूप से, बॉट शब्द वैकल्पिक है।
• एक नाम दर्ज करें - यह बॉट का प्रदर्शन नाम है। यहां आप पहले से ही सिरिलिक वर्णमाला का उपयोग कर सकते हैं।

यदि सब कुछ सही ढंग से दर्ज किया गया है, तो निर्मित बॉट संपर्कों में जोड़ा जाएगा और बदले में हमें एक टोकन प्राप्त होगा - फॉर्म के पात्रों का एक क्रम: HDyDvomx6TfsXkgwfFCUY410fv-vff4XVjr8JVSU4c।

प्रारंभिक सेटअप

 mkdir ttBotDevHelper 

 cd ttBotDevHelper/ 

 git init 

 git submodule add https://github.com/asvbkr/openapi_client.git openapi_client git submodule add https://github.com/asvbkr/TamTamBot.git TamTamBot 

 venv/ .idea/ # Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class *.log *.log.* .env ttb.sqlite3 

सरल बॉट लॉन्च

TtBotDevHelper.py फ़ाइल खोलें और पहली पंक्तियाँ लिखें:

 # -*- coding: UTF-8 -*- from TamTamBot.TamTamBot import TamTamBot class BotDevHelper(TamTamBot): pass 

यहाँ हम TamTamBot क्लास के आधार पर अपना बॉट क्लास बनाते हैं।

PyCharm का सुझाव है कि बोटडेवेलर वर्ग में अमूर्त विधियां हैं जिन्हें लागू करने की आवश्यकता है। क्लास के नाम पर Alt-Enter दबाएं, "अमूर्त विधियों को लागू करें" का चयन करें, PyCharm द्वारा प्रस्तावित सभी विधियों (उनमें से 2) का चयन करें और OK पर क्लिक करें। नतीजतन, दो खाली संपत्ति विधियों को जोड़ा जाएगा: टोकन और विवरण। हम परिणामस्वरूप कोड को इस प्रकार संशोधित करते हैं:

 # -*- coding: UTF-8 -*- import os from TamTamBot.TamTamBot import TamTamBot from TamTamBot.utils.lng import set_use_django class BotDevHelper(TamTamBot): @property def token(self): return os.environ.get('TT_BOT_API_TOKEN') @property def description(self): return '       .\n\n' \ 'This bot is an helper in the development and management of bots.' if __name__ == '__main__': set_use_django(False) BotDevHelper().polling() 

token संपत्ति हमारे बॉट का टोकन लौटाती है, जिसका मूल्य पर्यावरण चर TT_BOT_API_TOKEN से लिया जाता है। description संपत्ति हमारे बॉट का एक विस्तारित विवरण लौटाती है, जो उपयोगकर्ताओं को प्रदर्शित किया जाएगा।

हमारे बॉट को स्टेटस पोलिंग मोड में चलाने के लिए फाइल के अंत में कोड की आवश्यकता होती है।

मैं ध्यान देता हूं कि बेस क्लास TamTamBot में वेब हुक मोड में काम करने के लिए django वेब सर्वर का उपयोग शामिल है। लेकिन अब कार्य सरल है, और हमें django की जरूरत नहीं है, जिसे हम set_use_django(False) में रिपोर्ट कर रहे हैं। यहां, polling() पद्धति को हमारे वर्ग की वस्तु के लिए कहा जाता है, जो आवश्यक मोड में संचालन सुनिश्चित करता है।

न्यूनतम आवश्यक किया जाता है। यह कोड पहले से ही काफी काम कर रहा है। इसे चलाने के लिए चलाएं। ऐसा करने के लिए, कुंजी संयोजन Ctrl-Shift-F10 दबाएं।

यदि आपने पहले पर्यावरण चर को सीधे OS में नहीं जोड़ा था, तो स्टार्टअप पर "No access_token" संदेश के साथ एक त्रुटि होगी। इसे ठीक करने के लिए .env फ़ाइल का उपयोग करने के लिए PyCharm को कॉन्फ़िगर करें।

 TT_BOT_API_TOKEN=__ 

बॉट शुरू करने के बाद, आप टैमटैम जा सकते हैं, हमारे बॉट के साथ एक संवाद खोलें और "स्टार्ट" बटन पर क्लिक करें। बॉट अपने छिपे हुए महाशक्तियों के बारे में जानकारी देगा। इसका मतलब है कि बॉट काम कर रहा है। जबकि बॉट डेमो मोड में काम कर रहा है, जिसमें 4 कमांड उपलब्ध हैं। बस उन्हें बाहर की जाँच करें।

अपनी शीतलता के बारे में बॉट की स्पष्ट राय के बावजूद, वह इस तथ्य से डरता है कि अब तक वह कुछ नहीं कर सकता है। दुनिया की विजय के लिए जरूरी हर चीज उसे सिखाना हमारा काम है।

स्रोत संदेश प्राप्त करना और स्रोत संदेश के आंतरिक प्रतिनिधित्व के साथ प्रतिक्रिया संदेश भेजना

हम receive_text() विधि को अवरुद्ध कर देंगे, जिसका नियंत्रण बॉट के साथ चैट में पाठ भेजते समय स्थानांतरित किया जाता है:

  def receive_text(self, update): res = self.msg.send_message(NewMessageBody(f' : {update.message}', link=update.link), user_id=update.user_id) return bool(res) 

UpdateCmn वर्ग की update वस्तु, जो इस विधि से पास की जाती है, में विभिन्न उपयोगी जानकारी होती है और विशेष रूप से, उन सभी को जो अब उपलब्ध हैं:

• update.message - एक ऐसी वस्तु जिसमें स्वयं संदेश होता है;
• update.link - इस संदेश के लिए तैयार प्रतिक्रिया लिंक;
• update.user_id - संदेश भेजने वाले उपयोगकर्ता की पहचानकर्ता।

बॉट से एक संदेश भेजने के लिए, हम self.msg चर का उपयोग करते हैं, जिसमें self.msg ऑब्जेक्ट होता है जो API विवरण के संदेश अनुभाग में वर्णित कार्यक्षमता को लागू करता है। इस ऑब्जेक्ट में send_message() विधि हमें send_message() , जो संदेश भेजने की सुविधा प्रदान करती है। कम से कम, इस विधि को हमारे मामले में NewMessageBody वर्ग और गंतव्य - उपयोगकर्ता आईडी, का एक ऑब्जेक्ट पास किया जाना चाहिए।

बदले में, इस मामले में NewMessageBody वर्ग का एक ऑब्जेक्ट स्रोत संदेश ऑब्जेक्ट का एक टेक्स्ट प्रतिनिधित्व और स्रोत संदेश के लिए एक प्रतिक्रिया लिंक प्रेषित करके बनाया जाता है।

हम अपने बॉट को पुनः आरंभ करते हैं और बॉट के साथ बातचीत में जाँचते हैं कि बॉट हमारे किसी भी संदेश की प्रतिक्रिया उत्पन्न करता है जिसमें स्रोत संदेश ऑब्जेक्ट का आंतरिक प्रतिनिधित्व है।

इस राज्य का स्रोत कोड यहाँ है ।

एक पैरामीटर के साथ एक नया बॉट कमांड जोड़ना - इसके पहचानकर्ता द्वारा संदेश का आंतरिक प्रतिनिधित्व दिखाना

बॉट्स विकसित करते समय, अक्सर एक या एक से अधिक ज्ञात संदेश पहचानकर्ताओं (संदेश आईडी - मध्य) का उपयोग करके किसी संदेश के आंतरिक प्रतिनिधित्व को देखना आवश्यक होता है। इस कार्यशीलता को हमारे बॉट में जोड़ें। ऐसा करने के लिए, पहले, हम संदेशों के आंतरिक प्रतिनिधित्व के बारे में जानकारी के आउटपुट की कार्यक्षमता को एक अलग विधि में निकालते हैं:

  def view_messages(self, update, list_mid, link=None): res = False msgs = self.msg.get_messages(message_ids=list_mid) if msgs: for msg in msgs.messages: r = self.msg.send_message(NewMessageBody(f' {msg.body.mid}:\n`{msg}`'[:NewMessageBody.MAX_BODY_LENGTH], link=link), user_id=update.user_id) res = res or r return res 

इस पद्धति में, हम मध्य की सूची पास करते हैं।

संदेश ऑब्जेक्ट प्राप्त करने के लिए, हम self.msg.get_messages विधि का उपयोग करते हैं, जो संदेशों की संपत्ति में ऑब्जेक्ट्स की एक सूची देता है।

इसके अलावा, प्राप्त संदेशों में से प्रत्येक का एक पाठात्मक प्रतिनिधित्व अलग-अलग संदेशों में हमारी बातचीत के लिए भेजा जाता है। त्रुटियों से बचने के लिए, उत्पन्न संदेश के पाठ को अधिकतम संदेश लंबाई - NewMessageBody.MAX_BODY_LENGTH के निरंतर द्वारा काट दिया जाता है।

फिर एक विधि जोड़ें जो कमांड को संसाधित करता है। चलो इसे vmp कहते हैं। आप एक स्पेस के साथ कमांड में मिड लिस्ट पास कर सकते हैं।

TTB को इसलिए बनाया गया है ताकि कमांड हैंडलर को cmd_handler_%s नाम के साथ एक विधि के रूप में बनाया जाए, जहाँ% s कमांड का नाम है। यानी vmp कमांड के लिए, विधि को cmd_handler_vmp कहा cmd_handler_vmp । UpdateCmn वर्ग का एक ऑब्जेक्ट कमांड हैंडलर को दिया जाता है। इसके अतिरिक्त, एक कमांड के लिए, इसमें cmd_args संपत्ति हो सकती है, जिसमें उन पंक्तियों और शब्दों का एक शब्दकोष होता है जो कमांड के साथ थे

कोड इस तरह दिखेगा:

  def cmd_handler_vmp(self, update): res = None if not update.this_cmd_response: #    ,       if update.cmd_args: #        list_id = [] parts = update.cmd_args.get('c_parts') or [] if parts: for line in parts: for part in line: list_id.append(str(part)) if list_id: res = self.view_messages(update, list_id, update.link) return bool(res) 

हम बॉट को पुनः आरंभ करते हैं। अब, यदि आप बॉट के संवाद में एक कमांड टाइप करते हैं जैसे: /vmp mid1 mid2 (आप अपनी पिछली जाँच मध्य के रूप में ले सकते हैं), तो बदले में हमें प्रेषित मध्य में से प्रत्येक के लिए स्रोत संदेश ऑब्जेक्ट के आंतरिक प्रतिनिधित्व के साथ दो संदेश मिलते हैं।

इस राज्य का स्रोत कोड यहाँ है ।

पाठ प्रतिक्रिया के साथ काम करने के लिए एक बॉट कमांड का संशोधन

आप किसी अन्य चैनल / चैट से संदेश को अग्रेषित करने का भी प्रयास कर सकते हैं। लेकिन इस मामले में, केवल बॉट के साथ बातचीत में स्रोत संदेश में निहित क्या दिखाया जाएगा। विशेष रूप से, जब एक संदेश भेजते हैं, तो बटन जानकारी सहेजा नहीं जाता है।

लेकिन क्या होगा अगर हम मूल संदेश के बारे में जानकारी देखना चाहते हैं? इस मामले में, आपको अग्रेषित संदेश से मध्य लेने की आवश्यकता है।

इस मोड को लागू करने के लिए, हम vmp कमांड को संशोधित करते हैं ताकि जब इसे बिना मापदंडों के कहा जाए, तो यह संदेश को अग्रेषित करने की उम्मीद करता है, और उसके बाद यह भेजे गए संदेश के बीच में ले जाता है और इसके बारे में जानकारी प्रदर्शित करता है।

(!) इस कार्यक्षमता के सही संचालन के लिए, बॉट को चैनल / चैट स्रोत से पढ़ने की अनुमति दी जानी चाहिए।

हम निम्नानुसार कमांड कोड को संशोधित करते हैं:

  def cmd_handler_vmp(self, update): res = None if not update.this_cmd_response: #    ,       if update.cmd_args: #        list_id = [] parts = update.cmd_args.get('c_parts') or [] if parts: for line in parts: for part in line: list_id.append(str(part)) if list_id: res = self.view_messages(update, list_id, update.link) else: #      self.msg.send_message(NewMessageBody(f' **  /    :'), user_id=update.user_id) update.required_cmd_response = True #       else: #    message = update.message link = message.link #       link #  -   . if link and link.type == MessageLinkType.FORWARD: res = self.view_messages(update, [link.message.mid], update.link) else: #         ,    . self.msg.send_message(NewMessageBody(f'.  **   /. , .'), user_id=update.user_id) return False return bool(res) 

और कब से इस दृष्टिकोण के साथ, संदेशों तक पहुंच की कमी के कारण जोखिम बढ़ता है, फिर view_messages() विधि में हम अनुरोधित / प्राप्त संदेशों की संख्या के अनुपालन के लिए एक चेक जोड़ते हैं:

  def view_messages(self, update, list_mid, link=None): res = False msgs = self.msg.get_messages(message_ids=list_mid) if msgs: #    mid     if len(msgs.messages) < len(list_mid): self.msg.send_message(NewMessageBody( f'     .    @{self.username}  /  .', link=update.link ), user_id=update.user_id) return False else: for msg in msgs.messages: r = self.msg.send_message(NewMessageBody(f' {msg.body.mid}:\n`{msg}`'[:NewMessageBody.MAX_BODY_LENGTH], link=link), user_id=update.user_id) res = res or r return res 

हम बॉट को पुनरारंभ करते हैं, / vmp कमांड देते हैं, और फॉरवर्डिंग की आवश्यकता के बारे में संकेत प्रदर्शित होने के बाद, हम चैनल / चैट से संदेश अग्रेषित करते हैं। अगर इस चैनल / चैट में संदेशों को पढ़ने के लिए बॉट के अधिकार हैं, तो अग्रेषित संदेश ऑब्जेक्ट का एक शाब्दिक प्रतिनिधित्व प्रदर्शित किया जाएगा। यदि कोई पहुंच नहीं है, तो बॉट एक संभावित समस्या की रिपोर्ट करेगा और सही स्रोत से अग्रेषित करने की प्रतीक्षा करेगा।

बॉट गुण सेट करना

अब यह चमक लाने के लिए बनी हुई है। आइए संपत्ति के about बंद करें, जो उस पाठ को लौटाती है जो बॉट प्रदर्शित करता है जब वह काम करना शुरू करता है, साथ ही साथ / प्रारंभ कमांड भी।

  @property def about(self): return '       .' 

हम get_commands() विधि को ब्लॉक करेंगे, जो हमारे बॉट के कमांड की सूची को लौटाती है, जो बॉट के साथ संवाद में दिखाई देती है।

  def get_commands(self): # type: () -> [BotCommand] commands = [ BotCommand('start', ' '), BotCommand('menu', ' '), BotCommand('vmp', '  '), ] return commands 

चलिए main_menu_buttons प्रॉपर्टी को बंद करते हैं, जो मेन मेनू पर बटनों की सूची को / मेनू कमांड द्वारा बुलाया जाता है।

  def main_menu_buttons(self): # type: () -> [] buttons = [ #       -  [CallbackButtonCmd(' ', 'start')], #        - .    -  [CallbackButtonCmd('  ', 'vmp', intent=Intent.POSITIVE)], ] return buttons 

हम बॉट को पुनरारंभ करते हैं, सुनिश्चित करें कि सब कुछ क्रम में है। बधाई हो, आपका पहला बॉट बनाया गया था और, कुछ खिलौने के बावजूद, इसकी काफी कार्यक्षमता है।

इस राज्य का स्रोत कोड यहाँ है ।

काम करने वाले @devhelpbot बोट को यहां देखा जा सकता है ।

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

वैसे, आप एक विशेष चैट में प्रश्न जल्दी से पूछ सकते हैं । वहां सीधे सुझाव / विचार।