टेलीग्राम के दर्शक हर दिन तेजी से बढ़ रहे हैं, यह मैसेंजर की सुविधा, चैनलों की उपस्थिति, चैट और निश्चित रूप से बॉट बनाने की क्षमता से सुगम है।

बॉट्स का उपयोग आपके ग्राहकों के साथ संचार को स्वचालित करने से लेकर आपके स्वयं के कार्यों को प्रबंधित करने तक, पूरी तरह से अलग-अलग उद्देश्यों के लिए किया जा सकता है।

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

मैं कैसे काम करना है इस पर लेखों की एक श्रृंखला लिखने की योजना बना रहा हूं टेलीग्राम बॉट एपीआई, और अपनी आवश्यकताओं के अनुरूप बॉट लिखें।

इस पहले लेख में हम जानेंगे कि टेलीग्राम बॉट कैसे बनाया जाए और टेलीग्राम में सूचनाएं भेजने के लिए इसका उपयोग कैसे किया जाए।

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

लेकिन लेखों की इस श्रृंखला का उद्देश्य आपको किसी विशिष्ट, संकीर्ण कार्य के लिए बॉट लिखना सिखाना नहीं है, बल्कि आम तौर पर आपको पैकेज के सिंटैक्स से परिचित कराना है। telegram.bot, और कोड उदाहरण जिनके साथ आप अपनी समस्याओं को हल करने के लिए बॉट लिख सकते हैं।

सामग्री

यदि आप डेटा विश्लेषण में रुचि रखते हैं, तो आपको मेरी रुचि भी हो सकती है तार и यूट्यूब चैनल. अधिकांश सामग्री आर भाषा को समर्पित है।

टेलीग्राम बॉट बनाना
आर में टेलीग्राम बॉट के साथ काम करने के लिए एक पैकेज स्थापित करना
आर से टेलीग्राम पर संदेश भेजना
कार्य स्कैन चलाने के लिए शेड्यूल सेट करना
निष्कर्ष

टेलीग्राम बॉट बनाना

सबसे पहले, हमें एक बॉट बनाना होगा। यह एक विशेष बॉट का उपयोग करके किया जाता है बोटफादर, जाओ लिंक और बॉट को लिखें /start.

जिसके बाद आपको आदेशों की सूची वाला एक संदेश प्राप्त होगा:

बॉटफादर की ओर से संदेश

I can help you create and manage Telegram bots. If you're new to the Bot API, please see the manual (https://core.telegram.org/bots).

You can control me by sending these commands:

/newbot - create a new bot
/mybots - edit your bots [beta]

Edit Bots
/setname - change a bot's name
/setdescription - change bot description
/setabouttext - change bot about info
/setuserpic - change bot profile photo
/setcommands - change the list of commands
/deletebot - delete a bot

Bot Settings
/token - generate authorization token
/revoke - revoke bot access token
/setinline - toggle inline mode (https://core.telegram.org/bots/inline)
/setinlinegeo - toggle inline location requests (https://core.telegram.org/bots/inline#location-based-results)
/setinlinefeedback - change inline feedback (https://core.telegram.org/bots/inline#collecting-feedback) settings
/setjoingroups - can your bot be added to groups?
/setprivacy - toggle privacy mode (https://core.telegram.org/bots#privacy-mode) in groups

Games
/mygames - edit your games (https://core.telegram.org/bots/games) [beta]
/newgame - create a new game (https://core.telegram.org/bots/games)
/listgames - get a list of your games
/editgame - edit a game
/deletegame - delete an existing game

नया बॉट बनाने के लिए, कमांड भेजें /newbot.

बॉटफ़ादर आपसे बॉट का नाम दर्ज करने और लॉगिन करने के लिए कहेगा।

BotFather, [25.07.20 09:39]
Alright, a new bot. How are we going to call it? Please choose a name for your bot.

Alexey Seleznev, [25.07.20 09:40]
My Test Bot

BotFather, [25.07.20 09:40]
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.

Alexey Seleznev, [25.07.20 09:40]
@my_test_bot

आप कोई भी नाम दर्ज कर सकते हैं, लेकिन लॉगिन के साथ समाप्त होना चाहिए bot.

यदि आपने सब कुछ सही ढंग से किया है, तो आपको निम्न संदेश प्राप्त होगा:

Done! Congratulations on your new bot. You will find it at t.me/my_test_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.

Use this token to access the HTTP API:
123456789:abcdefghijklmnopqrstuvwxyz

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

आगे आपको प्राप्त एपीआई टोकन की आवश्यकता होगी, मेरे उदाहरण में यह है 123456789:abcdefghijklmnopqrstuvwxyz.

इस चरण पर, बॉट बनाने की तैयारी का काम पूरा हो गया है।

आर में टेलीग्राम बॉट के साथ काम करने के लिए एक पैकेज स्थापित करना

मेरा मानना है कि आपके पास पहले से ही R भाषा और RStudio विकास वातावरण स्थापित है। अगर ऐसा नहीं है तो आप इस पर गौर कर सकते हैं वीडियो पाठ उन्हें कैसे स्थापित करें।

टेलीग्राम बॉट एपीआई के साथ काम करने के लिए हम आर पैकेज का उपयोग करेंगे टेलीग्राम.बॉट.

R में पैकेज इंस्टालेशन फ़ंक्शन का उपयोग करके किया जाता है install.packages(), इसलिए हमें जिस पैकेज की आवश्यकता है उसे स्थापित करने के लिए, कमांड का उपयोग करें install.packages("telegram.bot").

आप विभिन्न पैकेजों को स्थापित करने के बारे में अधिक जान सकते हैं यह वीडियो.

पैकेज स्थापित करने के बाद, आपको इसे कनेक्ट करना होगा:

library(telegram.bot)

आर से टेलीग्राम पर संदेश भेजना

आपके द्वारा बनाया गया बॉट निर्माण के दौरान निर्दिष्ट लॉगिन का उपयोग करके टेलीग्राम में पाया जा सकता है, मेरे मामले में ऐसा है @my_test_bot.

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

अब हम निम्नलिखित कोड को R में लिखते हैं।

library(telegram.bot)

# создаём экземпляр бота
bot <- Bot(token = "123456789:abcdefghijklmnopqrstuvwxyz")

# Запрашиваем информацию о боте
print(bot$getMe())

# Получаем обновления бота, т.е. список отправленных ему сообщений
updates <- bot$getUpdates()

# Запрашиваем идентификатор чата
# Примечание: перед запросом обновлений вы должны отправить боту сообщение
chat_id <- updates[[1L]]$from_chat_id()

प्रारंभ में, हम फ़ंक्शन के साथ अपने बॉट का एक उदाहरण बनाते हैं Bot(), पहले प्राप्त टोकन को एक तर्क के रूप में इसमें पारित किया जाना चाहिए।

टोकन को कोड में संग्रहीत करना सर्वोत्तम अभ्यास नहीं माना जाता है, इसलिए आप इसे एक पर्यावरण चर में संग्रहीत कर सकते हैं और इससे पढ़ सकते हैं। पैकेज में डिफ़ॉल्ट रूप से telegram.bot निम्नलिखित नामों के पर्यावरण चर के लिए समर्थन लागू किया गया है: R_TELEGRAM_BOT_ИМЯ_ВАШЕГО_БОТА. के बजाय ИМЯ_ВАШЕГО_БОТА बनाते समय आपके द्वारा निर्दिष्ट नाम को प्रतिस्थापित करें, मेरे मामले में यह एक चर होगा R_TELEGRAM_BOT_My Test Bot.

पर्यावरण चर बनाने के कई तरीके हैं; मैं आपको सबसे सार्वभौमिक और क्रॉस-प्लेटफ़ॉर्म वाले के बारे में बताऊंगा। अपनी होम डायरेक्टरी में बनाएं (आप इसे कमांड का उपयोग करके पा सकते हैं path.expand("~")) नाम के साथ टेक्स्ट फ़ाइल .रेनवायरन. आप इसे कमांड का उपयोग करके भी कर सकते हैं file.edit(path.expand(file.path("~", ".Renviron"))).

और इसमें निम्न पंक्ति जोड़ें।

R_TELEGRAM_BOT_ИМЯ_ВАШЕГО_БОТА=123456789:abcdefghijklmnopqrstuvwxyz

इसके बाद, आप फ़ंक्शन का उपयोग करके पर्यावरण चर में सहेजे गए टोकन का उपयोग कर सकते हैं bot_token(), अर्थात। इस कदर:

bot <- Bot(token = bot_token("My Test Bot"))

विधि getUpdates()हमें बॉट अपडेट प्राप्त करने की अनुमति देता है, अर्थात जो संदेश उसे भेजे गए थे. तरीका from_chat_id(), आपको उस चैट की आईडी प्राप्त करने की अनुमति देता है जिससे संदेश भेजा गया था। बॉट से संदेश भेजने के लिए हमें इस आईडी की आवश्यकता है।

विधि द्वारा प्राप्त ऑब्जेक्ट से चैट आईडी के अतिरिक्त getUpdates() आपको कुछ अन्य उपयोगी जानकारी भी प्राप्त होगी। उदाहरण के लिए, संदेश भेजने वाले उपयोगकर्ता के बारे में जानकारी.

updates[[1L]]$message$from

$id
[1] 000000000

$is_bot
[1] FALSE

$first_name
[1] "Alexey"

$last_name
[1] "Seleznev"

$username
[1] "AlexeySeleznev"

$language_code
[1] "ru"

तो, इस स्तर पर हमारे पास पहले से ही वह सब कुछ है जो हमें एक बॉट से टेलीग्राम पर एक संदेश भेजने के लिए चाहिए। आइए विधि का उपयोग करें sendMessage(), जिसमें आपको चैट आईडी, संदेश टेक्स्ट और संदेश टेक्स्ट मार्कअप प्रकार पास करना होगा। मार्कअप प्रकार मार्कडाउन या HTML हो सकता है और तर्क द्वारा निर्धारित किया जाता है parse_mode.

# Отправка сообщения
bot$sendMessage(chat_id,
                text = "Привет, *жирный текст* _курсив_",
                parse_mode = "Markdown"
)

मार्कडाउन फ़ॉर्मेटिंग मूल बातें:

बोल्ड फ़ॉन्ट को * के साथ हाइलाइट किया गया है:
- उदाहरण: *жирный шритф*
- परिणाम: बोल्ड फ़ॉन्ट
इटैलिक को अंडरस्कोर द्वारा दर्शाया गया है:
- उदाहरण: _курсив_
- परिणाम: इटैलिक
मोनोस्पेस फ़ॉन्ट, जो आमतौर पर प्रोग्राम कोड को हाइलाइट करने के लिए उपयोग किया जाता है, एपोस्ट्रोफ का उपयोग करके निर्दिष्ट किया जाता है - `:
- उदाहरण: `मोनोस्पेस फ़ॉन्ट`
- परिणाम: моноширинный шрифт

HTML मार्कअप फ़ॉर्मेट करने की मूल बातें:
HTML में, आप टेक्स्ट के उस भाग को लपेटते हैं जिसे टैग में हाइलाइट करने की आवश्यकता होती है, उदाहरण के लिए <тег>текст</тег>.

<टैग> - ओपनिंग टैग
- समापन टैग

HTML मार्कअप टैग

 - बोल्ड फ़ॉन्ट
- उदाहरण: жирный шрифт
- परिणाम बोल्ड फ़ॉन्ट
 - इटैलिक
- उदाहरण: курсив
- परिणाम: इटैलिक
— моноширинный шрифт
- उदाहरण: моноширинный шрифт
- परिणाम: моноширинный шрифт

पाठ के अतिरिक्त, आप विशेष विधियों का उपयोग करके अन्य सामग्री भेज सकते हैं:

# Отправить изображение
bot$sendPhoto(chat_id,
  photo = "https://telegram.org/img/t_logo.png"
)

# Отправка голосового сообщения
bot$sendAudio(chat_id,
  audio = "http://www.largesound.com/ashborytour/sound/brobob.mp3"
)

# Отправить документ
bot$sendDocument(chat_id,
  document = "https://github.com/ebeneditos/telegram.bot/raw/gh-pages/docs/telegram.bot.pdf"
)

# Отправить стикер
bot$sendSticker(chat_id,
  sticker = "https://www.gstatic.com/webp/gallery/1.webp"
)

# Отправить видео
bot$sendVideo(chat_id,
  video = "http://techslides.com/demos/sample-videos/small.mp4"
)

# Отправить gif анимацию
bot$sendAnimation(chat_id,
  animation = "https://media.giphy.com/media/sIIhZliB2McAo/giphy.gif"
)

# Отправить локацию
bot$sendLocation(chat_id,
  latitude = 51.521727,
  longitude = -0.117255
)

# Имитация действия в чате
bot$sendChatAction(chat_id,
  action = "typing"
)

वे। उदाहरण के लिए विधि का उपयोग करना sendPhoto() आप पैकेज का उपयोग करके बनाई गई छवि के रूप में सहेजा गया ग्राफ़ भेज सकते हैं ggplot2.

विंडोज़ टास्क शेड्यूलर की जाँच करना और उन कार्यों के बारे में सूचनाएं भेजना जो असामान्य रूप से समाप्त हो गए हैं

विंडोज़ टास्क शेड्यूलर के साथ काम करने के लिए आपको पैकेज इंस्टॉल करना होगा taskscheduleR, और डेटा के साथ काम करने की सुविधा के लिए, पैकेज स्थापित करें dplyr.

# Установка пакетов
install.packages(c('taskscheduleR', 'dplyr'))
# Подключение пакетов
library(taskscheduleR)
library(dplyr)

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

# запрашиваем список задач
task <- task <- taskscheduler_ls() %>%
        filter(! `Last Result`  %in% c("0", "267011") & 
               `Scheduled Task State` == "Enabled" & 
               Status != "Running") %>%
        select(TaskName) %>%
        unique() %>%
        unlist() %>%
        paste0(., collapse = "n")

वस्तु में task अब हमारे पास उन कार्यों की एक सूची है जो विफल रहे, हमें इस सूची को टेलीग्राम पर भेजना होगा।

यदि हम प्रत्येक कमांड को अधिक विस्तार से देखें, तो:

filter() - ऊपर वर्णित शर्तों के अनुसार कार्यों की सूची को फ़िल्टर करता है
select() - कार्यों के नाम के साथ तालिका में केवल एक फ़ील्ड छोड़ता है
unique() - डुप्लिकेट नाम हटा देता है
unlist() - चयनित तालिका कॉलम को वेक्टर में परिवर्तित करता है
paste0() - कार्यों के नामों को एक पंक्ति में जोड़ता है, और एक पंक्ति फ़ीड को विभाजक के रूप में रखता है, अर्थात। n.

हमारे लिए बस यह परिणाम टेलीग्राम के माध्यम से भेजना है।

bot$sendMessage(chat_id,
                text = task,
                parse_mode = "Markdown"
)

तो, फिलहाल बॉट कोड इस तरह दिखता है:

कार्य समीक्षा बॉट कोड

# Подключение пакета
library(telegram.bot)
library(taskscheduleR)
library(dplyr)

# инициализируем бота
bot <- Bot(token = "123456789:abcdefghijklmnopqrstuvwxyz")

# идентификатор чата
chat_id <- 123456789

# запрашиваем список задач
task <- taskscheduler_ls() %>%
        filter(! `Last Result`  %in% c("0", "267011")  &
               `Scheduled Task State` == "Enabled" & 
               Status != "Running") %>%
        select(TaskName) %>%
        unique() %>%
        unlist() %>%
        paste0(., collapse = "n")

# если есть проблемные задачи отправляем сообщение
if ( task != "" ) {

  bot$sendMessage(chat_id,
                  text = task,
                  parse_mode = "Markdown"
  )

}

उपरोक्त उदाहरण का उपयोग करते समय, कोड में अपना बॉट टोकन और अपनी चैट आईडी बदलें।

आप कार्यों को फ़िल्टर करने के लिए शर्तें जोड़ सकते हैं, उदाहरण के लिए, सिस्टम कार्यों को छोड़कर, केवल उन्हीं कार्यों की जाँच करना जो आपने बनाए हैं।

आप विभिन्न सेटिंग्स को एक अलग कॉन्फ़िगरेशन फ़ाइल में भी डाल सकते हैं, और उसमें चैट आईडी और टोकन संग्रहीत कर सकते हैं। आप कॉन्फ़िगरेशन को पढ़ सकते हैं, उदाहरण के लिए, पैकेज का उपयोग करके configr.

उदाहरण ini config

[telegram_bot]
;настройки телеграм бота и чата, в который будут приходить уведомления
chat_id=12345678
bot_token=123456789:abcdefghijklmnopqrstuvwxyz"

आर में एक कॉन्फिगरेशन से वेरिएबल पढ़ने का एक उदाहरण

library(configr)

# чтение конфина
config <- read.config('C:/путь_к_конфигу/config.cfg', rcmd.parse = TRUE)

bot_token <- config$telegram_bot$bot_token
chat_id     <- config$telegram_bot$chat_id

कार्य स्कैन चलाने के लिए शेड्यूल सेट करना

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

आइए मान लें कि हमने अपना बॉट कोड एक फ़ाइल में सहेजा है check_bot.R. इस फ़ाइल को नियमित रूप से चलाने के लिए शेड्यूल करने के लिए, इन चरणों का पालन करें:

उस फ़ोल्डर का पथ लिखें जिसमें पथ सिस्टम चर में आर स्थापित है; विंडोज़ में, पथ कुछ इस तरह होगा: C:Program FilesRR-4.0.2bin.
केवल एक पंक्ति के साथ एक निष्पादन योग्य बैट फ़ाइल बनाएं R CMD BATCH C:rscriptscheck_botcheck_bot.R. बदलने के C:rscriptscheck_botcheck_bot.R आपकी R फ़ाइल का पूरा पथ।
इसके बाद, लॉन्च शेड्यूल सेट करने के लिए विंडोज टास्क शेड्यूलर का उपयोग करें, उदाहरण के लिए, हर आधे घंटे में।

निष्कर्ष

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

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

अगले लेख में, हम यह पता लगाएंगे कि बॉट में कमांड और एक कीबोर्ड कैसे जोड़ा जाए ताकि यह न केवल सूचनाएं भेज सके, बल्कि अधिक जटिल क्रियाएं भी कर सके।

स्रोत: www.habr.com

आर में टेलीग्राम बॉट लिखना (भाग 1): एक बॉट बनाना और टेलीग्राम में संदेश भेजने के लिए इसका उपयोग करना