GetMyBot नॉलेज बेस

प्रोजेक्ट और चैनल

प्रोजेक्ट बनाएँ, बॉट जोड़ें और उसकी स्थिति देखें। कई चैनल, टोकन बदलना, विराम और प्लान के कारण फ़्रीज़ हुए बॉट को फिर चालू करना।

इस पृष्ठ पर

प्रोजेक्ट किसी बॉट या सेवा की सेटिंग, रिएक्शन और डेटा को एक जगह रखता है। चैनल उस प्रोजेक्ट को लोगों से बात करने की जगह से जोड़ता है, जैसे Telegram बॉट, वेबसाइट चैट या दूसरा मैसेंजर। उदाहरण के लिए, किसी स्कूल का एक प्रोजेक्ट हो सकता है जिसमें Telegram और वेबसाइट के दो चैनल हों।

प्रोजेक्ट में प्रोजेक्ट बनाएँ और फिर चैनल जोड़ें। Telegram के लिए @BotFather से मिला टोकन चाहिए; इससे बॉट का प्रबंधन होता है। ऊपर के चयनकर्ता से प्रोजेक्ट बदल सकते हैं।

बॉट सिर्फ़ Telegram तक सीमित नहीं है। आप WhatsApp और VK भी जोड़ सकते हैं और सभी चैनलों में वही रिएक्शन इस्तेमाल कर सकते हैं। देखें चैनल और WhatsApp सेटअप।

बॉट जोड़ना

  1. प्रोजेक्ट नहीं है तो प्रोजेक्ट में प्रोजेक्ट जोड़ें दबाएँ। उसके कार्ड में चैनल जोड़ें दबाकर Telegram चुनें। पहले बॉट के लिए शुरुआती विज़ार्ड भी इस्तेमाल कर सकते हैं।
  2. @BotFather का टोकन पेस्ट करके सत्यापित करें दबाएँ। GetMyBot मिला हुआ @username दिखाएगा, ताकि आप सही बॉट होने की पुष्टि कर सकें।
  3. कनेक्ट करें दबाएँ। टोकन एन्क्रिप्ट करके रखा जाता है और इवेंट आने तुरंत शुरू हो जाते हैं।

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

कई बॉट

एक अकाउंट कई प्रोजेक्ट और बॉट चला सकता है, आपके प्लान की “अधिकतम बॉट” सीमा तक। ऊपर के चयनकर्ता या प्रोजेक्ट सूची से प्रोजेक्ट बदलें। रिएक्शन, चैट और आँकड़े चुने हुए प्रोजेक्ट का डेटा दिखाते हैं।

बॉट को संदेश कैसे मिलते हैं?

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

चालू और बंद करना

हर बॉट को चालू या बंद किया जा सकता है। इसके लिए सेटिंग में बॉट की स्थिति कार्ड है। बंद बॉट संदेशों पर प्रतिक्रिया नहीं देता। बदलाव तुरंत लागू होता है; दोबारा कनेक्ट करने की ज़रूरत नहीं।

प्रोजेक्ट की स्थिति और चैनल की उपलब्धता

प्रोजेक्ट सूची में प्रोजेक्ट की अपनी स्थिति अलग दिखाई देती है: सक्रिय, विराम पर या फ़्रीज़ किया गया। यह Telegram की डिलीवरी जाँच नहीं है। हर चैनल की अपनी स्थिति भी होती है: ऑनलाइन, सिग्नल नहीं, कॉन्फ़िगर किया गया, बंद या प्रोजेक्ट निष्क्रिय। इसलिए Telegram के बिना वेबसाइट चैट वाला सक्रिय प्रोजेक्ट “रुका हुआ” नहीं दिखता।

यदि सक्रिय प्रोजेक्ट में Telegram का केवल एक चालू चैनल है, तो ऑनलाइन का मतलब है कि उसे संभालने वाली प्रक्रिया ने हाल में स्थिति संकेत भेजा है। संकेत न मिले तो सिग्नल नहीं दिखेगा। कई चालू Telegram चैनलों के मामले में कॉन्फ़िगर किया गया दिखता है, क्योंकि प्रोजेक्ट के साझा संकेत को भरोसे के साथ किसी एक चैनल का नहीं माना जा सकता। दूसरे प्लेटफ़ॉर्म के चालू चैनलों में कॉन्फ़िगर किया गया का मतलब चैनल जुड़ा है, हर संदेश पहुँचने की गारंटी नहीं।

प्लेटफ़ॉर्म कई समानांतर प्रक्रियाओं पर चलता है। हर प्रक्रिया अपने बॉट के लिए हर 30 सेकंड पर स्थिति संकेत भेजती है। संकेत डेढ़ मिनट तक ताज़ा माना जाता है; एक संकेत छूटने से स्थिति तुरंत नहीं बदलती।

इसका व्यवहार में अर्थ:

  • स्थिति आने में समय लग सकता है। कनेक्ट करने या प्लेटफ़ॉर्म फिर चालू होने के बाद ऑनलाइन तुरंत नहीं, बल्कि इस अवधि में दिख सकता है।
  • चालू Telegram चैनल पर सिग्नल नहीं कुछ मिनट से अधिक रहे तो टोकन और सेटिंग में Bot health कार्ड जाँचें। प्रोजेक्ट तब तक सक्रिय रहता है जब तक आप उसे विराम पर न रखें या प्लान के कारण प्लेटफ़ॉर्म उसे फ़्रीज़ न करे।
  • संकेत प्रक्रियाओं के बीच साझा है; इससे फ़र्क नहीं पड़ता कि आपके अनुरोध का जवाब किस सर्वर ने दिया। कई Telegram चैनल होने पर यह हर चैनल की उपलब्धता अलग-अलग साबित नहीं करता।

बॉट ऑफ़लाइन होने पर क्या होता है?

प्लेटफ़ॉर्म हर मिनट स्थिति संकेत जाँचता है। चालू बॉट का कोई ताज़ा संकेत न मिले तो घटना रिकॉर्ड खोला जाता है, कारण एक बार तय किया जाता है और बॉट को वापस चलाने की कोशिश अपने आप की जाती है।

सेटिंग के Bot health कार्ड में चार संभावित कारण दिखते हैं:

  • Webhook: Telegram प्लेटफ़ॉर्म के पते पर अपडेट नहीं पहुँचा पा रहा; प्लेटफ़ॉर्म पता फिर रजिस्टर करता है।
  • टोकन रद्द हुआ: getMe का जवाब 401 है। दोबारा चालू करने से यह ठीक नहीं होगा; @BotFather से नया टोकन लें और टोकन बदलें में भरें।
  • सेवा देने वाला सर्वर नहीं: अपडेट संभालने वाला सर्वर नहीं है; प्लेटफ़ॉर्म बॉट को फिर चालू करता है।
  • कारण पता नहीं चला: Telegram ने जाँच अनुरोध का जवाब नहीं दिया।

दोबारा चालू करने पर सिंक करें जैसा काम होता है: getMe से टोकन जाँचना और webhook फिर रजिस्टर करना। कोशिशों के बीच अंतराल बढ़ता जाता है। Restart log में हर कोशिश का समय, सफलता या असफलता और त्रुटि दर्ज होती है। अगली कोशिश का समय भी कार्ड में दिखता है।

यदि बॉट Bot health में तय सीमा से अधिक चुप रहता है (डिफ़ॉल्ट 5 मिनट), तो मालिक को ऐप के घंटी आइकन और ईमेल से “Бот офлайн” (“बॉट ऑफ़लाइन”) सूचना मिलती है। सूचना पाने के लिए चुनी गई चैट में बॉट भी संदेश भेजता है। एक घटना पर एक ही चेतावनी जाती है। संकेत लौटने पर “Бот снова онлайн” (“बॉट फिर ऑनलाइन”) सूचना रुकावट की अवधि बताती है। पिछली घटनाओं की अवधि और कारण उसी कार्ड में रहते हैं।

प्लान के कारण फ़्रीज़ होना

बॉट के चालू या बंद होने के अलावा उसकी स्थिति फ़्रीज़ किया गया भी हो सकती है। इसे उपयोगकर्ता नहीं, प्लेटफ़ॉर्म फ़्रीज़ करता है, जब मौजूदा प्लान जुड़े बॉट की संख्या के लिए काफ़ी नहीं रहता। इसके दो ही कारण हैं:

  • बॉट सीमा पार हुई: आप ऐसे प्लान पर गए जिसमें जुड़े हुए बॉट से कम बॉट की अनुमति है।
  • सदस्यता नवीनीकृत नहीं हुई: भुगतान वाला प्लान समाप्त हुआ और मुफ़्त प्लान की सीमा लागू हो गई।

फ़्रीज़ किया गया बॉट संदेश नहीं पाता: उसके लिए अपडेट प्राप्त करना सचमुच बंद हो जाता है। डेटा, रिएक्शन और ग्राहक सुरक्षित रहते हैं; फ़्रीज़ हटाया जा सकता है।

वापस चालू करने के लिए ऐसा प्लान खरीदें जिसमें आवश्यक संख्या में बॉट की अनुमति हो। भुगतान वाला प्लान सक्रिय होते ही बॉट सबसे पुराने से शुरू होकर नई सीमा पूरी होने तक अपने आप चालू होते हैं। कौन-सा बॉट पहले चलेगा, यह नहीं चुन सकते। कोई दूसरा बॉट चलाना है तो प्लान खरीदने से पहले अनावश्यक कनेक्शन हटाएँ।

बॉट के फ़्रीज़ होने से अलग, पूरा अकाउंट भी फ़्रीज़ हो सकता है। उस स्थिति में सभी बॉट और प्रसारण रुकते हैं और डैशबोर्ड पर “अकाउंट फ़्रीज़ किया गया” दिखता है। इसे सिर्फ़ सहायता के ज़रिए हटाया जा सकता है। देखें भुगतान और बैलेंस।

प्रोफ़ाइल और सिंक

सेटिंग में सिंक करें दबाने से बॉट का नाम Telegram से फिर लिया जाता है, अगर आपने उसे @BotFather में बदला है। बॉट की प्रोफ़ाइल फ़ोटो अपने आप ली जाती है।

टोकन बदलना

अगर आपने @BotFather में टोकन फिर से जारी किया है (Bot Settings → Revoke / New token), तो उसे सेटिंग्स → चैनल → Telegram 🔑 में अपडेट करें। नया टोकन उसी बॉट का होना चाहिए (Telegram आंतरिक ID से मेल खाना चाहिए) — इस तरह सभी रिएक्शन, सब्सक्राइबर और डेटा सुरक्षित रहते हैं। यदि Telegram चैनल नहीं दिख रहा है, तो उसी विंडो में «टोकन बदलें» चुनें।

प्रोजेक्ट दूसरे अकाउंट को सौंपना

सेटिंग → मालिक बदलें से किसी दूसरे GetMyBot अकाउंट के ईमेल पर प्रोजेक्ट हस्तांतरण का निमंत्रण भेजें। निमंत्रण 72 घंटे तक मान्य रहता है। प्राप्तकर्ता के स्वीकार करने तक प्रोजेक्ट आपके पास रहता है और आप हस्तांतरण रद्द कर सकते हैं। स्वीकार करते ही मालिक बदल जाता है और आपका प्रोजेक्ट तक पहुँच अधिकार समाप्त हो जाता है। ग्राहक या सहकर्मी को प्रोजेक्ट सौंपते समय इसका उपयोग करें।

बॉट टेम्पलेट

टेम्पलेट में प्रोजेक्ट सेटिंग और सभी रिएक्शन की एक प्रति रहती है, जिसे दूसरे प्रोजेक्ट पर लागू किया जा सकता है:

  • सेटिंग में टेम्पलेट बनाएँ मौजूदा प्रोजेक्ट को नाम देकर टेम्पलेट के रूप में सहेजता है।
  • टेम्पलेट लागू करें चुने हुए प्रोजेक्ट की सेटिंग को टेम्पलेट की सेटिंग से बदलता है और टेम्पलेट के रिएक्शन मौजूदा रिएक्शन में जोड़ता है।

एक जैसे प्रोजेक्ट तैयार करने के लिए यह उपयोगी है।

कैटलॉग से तैयार समाधान लगाना

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

यह विज़ार्ड ऊपर वाले बॉट टेम्पलेट को लागू करने से अलग है। लगाने से पहले की जाँच अधूरे पैरामीटर या अनुपलब्ध क्षमताएँ दिखाती है। किसी चरण को पूरा चिह्नित करने से यह साबित नहीं होता कि बाहरी सेवा सचमुच काम कर रही है।

तैयार समाधान के नतीजे देखना

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

आगे क्या करें?