Telegram

जब कोई अलर्ट फ़ायर होता है या कोई घटना खुलती है, तो किसी Telegram चैट, ग्रुप या चैनल में एक संदेश भेजें। Status200 का Send Message to Telegram वर्कफ़्लो चरण इसे आपके बनाए बॉट के रूप में भेजता है, और एक तैयार टेम्पलेट अलर्ट के लिए वर्कफ़्लो बना देता है। यह इंटीग्रेशन आउटबाउंड है: बॉट संदेश भेजता है, और चैट में कही गई बातें नहीं पढ़ता।

यह कैसे काम करता है#

चरण Message Text को Telegram के Bot API के ज़रिए, आपके बॉट के रूप में, चैट में भेजता है। जब Telegram संदेश ले लेता है तो यह अपने Success आउटपुट पर जाता है, और जब Telegram उसे अस्वीकार करता है तो Telegram के कारण के साथ अपने Error आउटपुट पर। टेम्पलेट Error से एक Log चरण जोड़ता है, ताकि जो रन भेज नहीं सका वह कारण बताए।

शुरू करने से पहले#

• बॉट बनाने और उसे चैट में जोड़ने के लिए एक Telegram खाता।
• Status200 में वर्कफ़्लो और वेरिएबल बनाने का अधिकार। Status200 Cloud पर वर्कफ़्लो के लिए Growth प्लान या उससे ऊपर चाहिए।

इंटीग्रेशन सेट अप करें#

1. बॉट बनाएं#

   Telegram में @BotFather को /newbot भेजें और उसके सवालों के जवाब दें। वह आपको बॉट का टोकन देता है, जैसे 123456789:ABCdefGhIJKlmnoPQRstuVWxyz। जिसके पास भी टोकन है वह आपके बॉट के रूप में संदेश भेज सकता है, इसलिए इसे पासवर्ड जितना सुरक्षित रखें।

2. चैट का ID ढूंढें#

   1. बॉट को ग्रुप में जोड़ें, या उसे चैनल का एडमिनिस्ट्रेटर बनाएं। किसी व्यक्ति को संदेश भेजने के लिए, वह पहले बॉट के साथ चैट शुरू करता है।
   2. ग्रुप में बॉट का ज़िक्र करने वाला एक संदेश भेजें, जैसे /start@your_bot, ताकि बॉट उसे देखे।
   3. ब्राउज़र में https://api.telegram.org/bot<token>/getUpdates खोलें, <token> की जगह बॉट के टोकन के साथ।
   4. जवाब में "chat":{"id": ढूंढें। उसके बाद वाली संख्या चैट का ID है। ग्रुप का ID - से शुरू होता है, और बड़े ग्रुप का -100 से।

   सार्वजनिक चैनल को ID के बजाय उसके @username से बताया जा सकता है।

3. वर्कफ़्लो बनाएं#

   टेम्पलेट से शुरू करें, जो अलर्ट के लिए पूरा वर्कफ़्लो बना देता है, या शुरू से बनाएं।

   Template सेशुरू से

   Template से

   1. वर्कफ़्लो खोलें और वर्कफ़्लो बनाएं पर क्लिक करें।
   2. टेम्पलेट खोजें… में Telegram लिखें, Tell Telegram when an alert fires पर क्लिक करें, फिर यह टेम्पलेट इस्तेमाल करें पर क्लिक करें।
   3. नाम, Notify Telegram on new alert, रहने दें या बदलें, और अगला पर क्लिक करें।
   4. टोकन को Telegram Bot Token में और ID को Telegram Chat ID में पेस्ट करें, और वर्कफ़्लो बनाएं पर क्लिक करें।

   वर्कफ़्लो बिल्डर में तीन चरणों के साथ खुलता है: On Create Alert; Send Message to Telegram, जो अलर्ट का नंबर, शीर्षक, गंभीरता और स्थिति भेजता है; और उसके Error आउटपुट पर एक Log चरण। टोकन वर्कफ़्लो के सीक्रेट वेरिएबल telegramBotToken के रूप में सहेजा जाता है, और ID telegramChatId के रूप में।

   शुरू से

   1. टोकन को सीक्रेट ग्लोबल वेरिएबल के रूप में सहेजें: वर्कफ़्लो → ग्लोबल वेरिएबल पर जाएं, वर्कफ़्लो वेरिएबल बनाएँ पर क्लिक करें, इसका नाम TELEGRAM_BOT_TOKEN रखें, और अगला पर क्लिक करें। टोकन को सामग्री में पेस्ट करें, रहस्य चालू करें, और वर्कफ़्लो वेरिएबल बनाएँ पर क्लिक करें।
   2. वर्कफ़्लो पर जाएं, वर्कफ़्लो बनाएं पर क्लिक करें, शुरू से बनाएं चुनें, वर्कफ़्लो को नाम दें, और वर्कफ़्लो बनाएं पर क्लिक करें।
   3. बिल्डर में Choose what starts this workflow पर क्लिक करें और Popular के नीचे On Create Alert चुनें। ट्रिगर पर क्लिक करें: उसके Fields to pass on में पहले से शीर्षक है, इसलिए फ़ील्ड जोड़ें पर क्लिक करें और वे बाकी फ़ील्ड चुनें जो आपका संदेश दिखाता है, जैसे Alert Number With Prefix।
   4. घटक जोड़ें पर क्लिक करें, telegram खोजें, और Send Message to Telegram पर क्लिक करें। ट्रिगर के Success आउटपुट को इससे जोड़ें।
   5. नए चरण पर क्लिक करें। Telegram Bot Token में { } पर क्लिक करें और Global variables के नीचे TELEGRAM_BOT_TOKEN चुनें। Chat ID में चैट का ID डालें, Message Text में संदेश लिखें, और { } से अलर्ट के फ़ील्ड डालें।

   शुरू से बना संदेश अलर्ट के फ़ील्ड ऐसे रेफ़रेंस से पढ़ता है:

   🚨 Alert {{local.components.alert-on-create-1.returnValues.model.alertNumberWithPrefix}} fired
   Title: {{local.components.alert-on-create-1.returnValues.model.title}}

4. चालू करें और जाँचें#

   बिल्डर के ऊपर सक्षम चालू करें। अब से हर नया अलर्ट चैट में भेजा जाता है।

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

सुझाव#

• सादा टेक्स्ट। चरण टेक्स्ट जैसा लिखा है वैसा ही भेजता है, Telegram की फ़ॉर्मैटिंग के बिना, इसलिए * और _ जैसे हैं वैसे ही दिखते हैं।
• 4,096 अक्षरों की सीमा का ध्यान रखें। Telegram 4,096 अक्षरों तक के संदेश लेता है। इससे लंबा संदेश अस्वीकार होने के बजाय काट दिया जाता है, और "… (обрезано — полный текст в Status200)" पर खत्म होता है।
• घटनाएं भी। वही वर्कफ़्लो On Create Incident पर बनाएं, या स्थिति बदलावों के लिए On Update Incident पर। सिर्फ़ कुछ अलर्ट भेजने के लिए, चरण से पहले एक If / Else ब्लॉक रखें।
• टोकन का आकार जांचा जाता है। जो टोकन 123456789:ABCdef… जैसा नहीं दिखता, वह कुछ भी भेजे जाने से पहले रन रोक देता है, और टोकन कभी लॉग में नहीं लिखा जाता।

समस्या निवारण#

जब चरण Error पर जाता है, तो रन कारण बताता है: टेम्पलेट का Log चरण ❌ Telegram could not deliver the alert notification:, Telegram का कारण, और यह याद दिलाने वाली बात लिखता है कि बॉट को चैट में होना चाहिए।

अगले कदम#