Telegram-ის აუდიტორია ყოველ დღე ექსპონენტურად იზრდება, ამას ხელს უწყობს მესინჯერის მოხერხებულობა, არხების არსებობა, ჩეთები და, რა თქმა უნდა, ბოტების შექმნის შესაძლებლობა.

ბოტების გამოყენება შესაძლებელია სრულიად განსხვავებული მიზნებისთვის, თქვენს მომხმარებლებთან კომუნიკაციის ავტომატიზირებიდან დაწყებული საკუთარი ამოცანების მართვამდე.

არსებითად, შეგიძლიათ გამოიყენოთ ტელეგრამა ბოტის საშუალებით ნებისმიერი ოპერაციების შესასრულებლად: გაგზავნეთ ან მოითხოვეთ მონაცემები, შეასრულეთ დავალებები სერვერზე, შეაგროვეთ ინფორმაცია მონაცემთა ბაზაში, გაგზავნეთ ელ.წერილები და ა.შ.

ვგეგმავ სტატიების სერიის დაწერას, თუ როგორ ვიმუშაო telegram bot APIდა დაწერეთ ბოტები თქვენს საჭიროებებზე.

ამ პირველ სტატიაში ჩვენ გავარკვევთ, თუ როგორ შევქმნათ ტელეგრამის ბოტი და გამოვიყენოთ იგი შეტყობინებების გაგზავნისთვის ტელეგრამაში.

შედეგად, ჩვენ გვექნება ბოტი, რომელიც შეამოწმებს ყველა დავალების ბოლო შესრულების სტატუსს Windows Task Scheduler-ში და გამოგიგზავნით შეტყობინებებს, თუ რომელიმე მათგანი ვერ მოხერხდა.

მაგრამ ამ სტატიების სერიის მიზანი არ არის გასწავლოთ როგორ დაწეროთ ბოტი კონკრეტული, ვიწრო ამოცანისთვის, არამედ ზოგადად გაგაცნოთ პაკეტის სინტაქსი. telegram.botდა კოდის მაგალითები, რომლითაც შეგიძლიათ დაწეროთ ბოტები საკუთარი პრობლემების გადასაჭრელად.

ინფორმაციის

თუ გაინტერესებთ მონაცემთა ანალიზი, შეიძლება დაგაინტერესოთ ჩემი დეპეშა и youtube არხები. შინაარსის უმეტესი ნაწილი ეძღვნება R ენას.

ტელეგრამის ბოტის შექმნა
რ-ში ტელეგრამის ბოტთან მუშაობის პაკეტის დაყენება
შეტყობინებების გაგზავნა R-დან Telegram-ში
დავალების სკანირების შესრულების გრაფიკის დაყენება
დასკვნა

ტელეგრამის ბოტის შექმნა

პირველ რიგში, ჩვენ უნდა შევქმნათ ბოტი. ეს კეთდება სპეციალური ბოტის გამოყენებით BotFather, წადი ლინკები და მიწერე ბოტს /start.

რის შემდეგაც მიიღებთ შეტყობინებას ბრძანებების სიით:

შეტყობინება BotFather-ისგან

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 მოგთხოვთ შეიყვანოთ ბოტის სახელი და შესვლა.

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

შემდეგ დაგჭირდებათ მიღებული API ჟეტონი, ჩემს მაგალითში ეს არის 123456789:abcdefghijklmnopqrstuvwxyz.

ამ ეტაპზე დასრულებულია ბოტის შექმნის მოსამზადებელი სამუშაოები.

რ-ში ტელეგრამის ბოტთან მუშაობის პაკეტის დაყენება

ვვარაუდობ, რომ თქვენ უკვე გაქვთ დაინსტალირებული R ენა და RStudio განვითარების გარემო. თუ ეს ასე არ არის, მაშინ შეგიძლიათ ნახოთ ეს ვიდეო გაკვეთილი თუ როგორ დააინსტალიროთ ისინი.

Telegram Bot API-სთან მუშაობისთვის ჩვენ გამოვიყენებთ R პაკეტს telegram.bot.

პაკეტების ინსტალაცია R-ში ხდება ფუნქციის გამოყენებით install.packages(), ამიტომ ჩვენ გვჭირდება პაკეტის დასაყენებლად, გამოიყენეთ ბრძანება install.packages("telegram.bot").

შეგიძლიათ მეტი გაიგოთ სხვადასხვა პაკეტების დაყენების შესახებ ამ ვიდეოს.

პაკეტის დაყენების შემდეგ, თქვენ უნდა დააკავშიროთ იგი:

library(telegram.bot)

შეტყობინებების გაგზავნა R-დან Telegram-ში

თქვენ მიერ შექმნილი ბოტი შეგიძლიათ იხილოთ Telegram-ში შექმნისას მითითებული ლოგინის გამოყენებით, ჩემს შემთხვევაში ეს ასეა @my_test_bot.

გაუგზავნეთ ბოტს ნებისმიერი შეტყობინება, როგორიცაა "ჰეი ბოტ". ამ დროისთვის, ჩვენ გვჭირდება ეს, რათა მივიღოთ თქვენი ჩეთის ID ბოტთან.

ახლა ჩვენ ვწერთ შემდეგ კოდს 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(), გაძლევთ საშუალებას მიიღოთ ჩატის ID, საიდანაც გაგზავნილი იყო შეტყობინება. ჩვენ გვჭირდება ეს ID ბოტიდან შეტყობინებების გასაგზავნად.

მეთოდით მიღებული ობიექტიდან ჩატის 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"

ასე რომ, ამ ეტაპზე ჩვენ უკვე გვაქვს ყველაფერი, რაც გვჭირდება ბოტიდან Telegram-ზე შეტყობინების გასაგზავნად. მოდით გამოვიყენოთ მეთოდი sendMessage(), რომელშიც თქვენ უნდა გადასცეთ ჩატის ID, შეტყობინების ტექსტი და შეტყობინების ტექსტის მარკირების ტიპი. მარკირების ტიპი შეიძლება იყოს Markdown ან HTML და დაყენებულია არგუმენტით parse_mode.

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

Markdown ფორმატირების საფუძვლები:

თამამი შრიფტი მონიშნულია *:
- მაგალითად: *жирный шритф*
- შედეგი: თამამი შრიფტი
დახრილები მითითებულია ქვედა ხაზებით:
- მაგალითად: _курсив_
- შედეგი: დახრილი
monospace შრიფტი, რომელიც ჩვეულებრივ გამოიყენება პროგრამის კოდის ხაზგასასმელად, მითითებულია აპოსტროფების გამოყენებით - `:
- მაგალითი: `მონოსკოსისტური შრიფტი`
- შედეგი: моноширинный шрифт

HTML მარკირების ფორმატირების საფუძვლები:
HTML-ში თქვენ ახვევთ ტექსტის იმ ნაწილს, რომელიც უნდა იყოს ხაზგასმული ტეგებში, მაგალითად <тег>текст</тег>.

<tag> - გახსნის ტეგი
- დახურვის ტეგი

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.

Windows Task Scheduler-ის შემოწმება და შეტყობინებების გაგზავნა ამოცანების შესახებ, რომლებიც არანორმალურად დასრულდა

Windows Task Scheduler-თან მუშაობისთვის საჭიროა პაკეტის ინსტალაცია 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 ახლა ჩვენ გვაქვს იმ ამოცანების სია, რომლებიც ვერ მოხერხდა, ეს სია უნდა გავგზავნოთ Telegram-ში.

თუ თითოეულ ბრძანებას უფრო დეტალურად განვიხილავთ, მაშინ:

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"
  )

}

ზემოთ მოყვანილი მაგალითის გამოყენებისას, ჩაანაცვლეთ თქვენი ბოტის ჟეტონი და თქვენი ჩატის ID კოდით.

თქვენ შეგიძლიათ დაამატოთ პირობები ამოცანების ფილტრაციისთვის, მაგალითად, შეამოწმოთ მხოლოდ ის ამოცანები, რომლებიც თქვენ შექმენით, სისტემური ამოცანების გამოკლებით.

თქვენ ასევე შეგიძლიათ მოათავსოთ სხვადასხვა პარამეტრები ცალკე კონფიგურაციის ფაილში და შეინახოთ მასში ჩატის ID და ჟეტონი. თქვენ შეგიძლიათ წაიკითხოთ კონფიგურაცია, მაგალითად, პაკეტის გამოყენებით configr.

მაგალითი ini config

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

R-ში კონფიგურაციიდან ცვლადების წაკითხვის მაგალითი

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. იმისათვის, რომ დაგეგმოთ ამ ფაილის რეგულარულად გაშვება, მიჰყევით ამ ნაბიჯებს:

ჩაწერეთ გზა საქაღალდეში, რომელშიც R არის დაინსტალირებული Path system ცვლადში; Windows-ში ბილიკი იქნება მსგავსი: C:Program FilesRR-4.0.2bin.
შექმენით შესრულებადი bat ფაილი მხოლოდ ერთი ხაზით R CMD BATCH C:rscriptscheck_botcheck_bot.R. ჩანაცვლება C:rscriptscheck_botcheck_bot.R თქვენი R ფაილის სრულ გზაზე.
შემდეგი, გამოიყენეთ Windows Task Scheduler გაშვების განრიგის დასაყენებლად, მაგალითად, ყოველ ნახევარ საათში.

დასკვნა

ამ სტატიაში ჩვენ გავარკვიეთ, როგორ შევქმნათ ბოტი და გამოვიყენოთ იგი ტელეგრამაში სხვადასხვა შეტყობინებების გასაგზავნად.

მე აღვწერე Windows Task Scheduler-ის მონიტორინგის ამოცანა, მაგრამ შეგიძლიათ გამოიყენოთ ამ სტატიაში მოცემული მასალა ნებისმიერი შეტყობინებების გასაგზავნად, ამინდის პროგნოზიდან დაწყებული საფონდო ბირჟის ფასით, რადგან R საშუალებას გაძლევთ დაუკავშირდეთ მონაცემთა უამრავ წყაროს.

შემდეგ სტატიაში ჩვენ გავარკვევთ, თუ როგორ დავამატოთ ბრძანებები და კლავიატურა ბოტზე, რათა მან არა მხოლოდ შეტყობინებების გაგზავნა, არამედ უფრო რთული მოქმედებების შესრულებაც შეძლოს.

წყარო: www.habr.com

ტელეგრამის ბოტის დაწერა R-ში (ნაწილი 1): ბოტის შექმნა და მისი გამოყენება ტელეგრამაში შეტყობინებების გასაგზავნად

ინფორმაციის

ტელეგრამის ბოტის შექმნა

რ-ში ტელეგრამის ბოტთან მუშაობის პაკეტის დაყენება

შეტყობინებების გაგზავნა R-დან Telegram-ში

Windows Task Scheduler-ის შემოწმება და შეტყობინებების გაგზავნა ამოცანების შესახებ, რომლებიც არანორმალურად დასრულდა

დავალების სკანირების შესრულების გრაფიკის დაყენება

დასკვნა

ახალი კომენტარის დამატება

ტელეგრამის ბოტის დაწერა R-ში (ნაწილი 1): ბოტის შექმნა და მისი გამოყენება ტელეგრამაში შეტყობინებების გასაგზავნად

ინფორმაციის

ტელეგრამის ბოტის შექმნა

რ-ში ტელეგრამის ბოტთან მუშაობის პაკეტის დაყენება

შეტყობინებების გაგზავნა R-დან Telegram-ში

Windows Task Scheduler-ის შემოწმება და შეტყობინებების გაგზავნა ამოცანების შესახებ, რომლებიც არანორმალურად დასრულდა

დავალების სკანირების შესრულების გრაფიკის დაყენება

დასკვნა

ახალი კომენტარის დამატება პასუხის გასაუქმებლად

ახალი კომენტარის დამატება