קהל הטלגרם גדל באופן אקספוננציאלי מדי יום, זה מקל על ידי הנוחות של המסנג'ר, נוכחות של ערוצים, צ'אטים, וכמובן היכולת ליצור בוטים.

ניתן להשתמש בבוטים למטרות שונות לחלוטין, מאוטומציה של תקשורת עם הלקוחות שלך ועד לניהול המשימות שלך.

בעיקרו של דבר, אתה יכול להשתמש בטלגרם כדי לבצע כל פעולה דרך בוט: לשלוח או לבקש נתונים, להפעיל משימות בשרת, לאסוף מידע למסד נתונים, לשלוח מיילים וכן הלאה.

אני מתכנן לכתוב סדרת מאמרים על איך לעבוד עם ממשק API של בוט טלגרם, וכתוב בוטים שיתאימו לצרכים שלך.

במאמר ראשון זה נבין כיצד ליצור בוט טלגרם ולהשתמש בו כדי לשלוח הודעות בטלגרם.

כתוצאה מכך, יהיה לנו בוט שיבדוק את מצב הביצוע האחרון של כל המשימות ב-Windows Task Scheduler, וישלח לך הודעות אם אחת מהן נכשלה.

אבל מטרת סדרת המאמרים הזו היא לא ללמד אותך איך לכתוב בוט למשימה ספציפית וצרה, אלא להציג לך באופן כללי את התחביר של החבילה telegram.bot, ודוגמאות קוד שבאמצעותן אתה יכול לכתוב בוטים כדי לפתור את הבעיות שלך.

תוכן

אם אתה מעוניין בניתוח נתונים, אולי אתה מעוניין ב- שלי מברק и YouTube ערוצים. רוב התוכן מוקדש לשפת R.

1. יצירת בוט טלגרם
2. התקנת חבילה לעבודה עם בוט טלגרם ב-R
3. שליחת הודעות מ-R לטלגרם
4. הגדרת לוח זמנים להפעלת סריקות משימות
5. מסקנה

יצירת בוט טלגרם

ראשית, עלינו ליצור בוט. זה נעשה באמצעות בוט מיוחד 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

אני מניח שכבר מותקנת אצלך שפת R וסביבת הפיתוח RStudio. אם זה לא המקרה, אז אתה יכול להסתכל על זה מדריך וידאו כיצד להתקין אותם.

כדי לעבוד עם ה-API של Telegram Bot נשתמש בחבילת R telegram.bot.

התקנת חבילות ב-R מתבצעת באמצעות הפונקציה install.packages(), אז כדי להתקין את החבילה שאנחנו צריכים, השתמש בפקודה install.packages("telegram.bot").

אתה יכול ללמוד עוד על התקנת חבילות שונות מ הוידאו הזה.

לאחר התקנת החבילה, עליך לחבר אותה:

library(telegram.bot)

שליחת הודעות מ-R לטלגרם

את הבוט שיצרת ניתן למצוא בטלגרם באמצעות ההתחברות שצוינה במהלך היצירה, במקרה שלי @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("~")) קובץ טקסט עם השם .Renviron. אתה יכול גם לעשות זאת באמצעות הפקודה 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(), שאליו עליך להעביר את מזהה הצ'אט, טקסט ההודעה וסוג סימון טקסט ההודעה. סוג הסימון יכול להיות Markdown או HTML והוא מוגדר על ידי הארגומנט parse_mode.

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

יסודות עיצוב סימון:

• גופן מודגש מסומן עם *:
  • לדוגמא: *жирный шритф*
  • התוצאה גופן מודגש
• נטוי מסומן באמצעות קווים תחתונים:
  • לדוגמא: _курсив_
  • התוצאה אוֹתִיוֹת מוּטוֹת
• הגופן המונוספייס, המשמש בדרך כלל להדגשת קוד התוכנית, מצוין באמצעות אפוסתרופים - `:
  • דוגמה: `גופן מונו-רווח`
  • התוצאה моноширинный шрифт

יסודות של עיצוב סימון HTML:
ב-HTML, אתה עוטף את החלק של הטקסט שצריך להיות מודגש בתגים, למשל <тег>текст</тег>.

• <tag> - תג פתיחה
• - תג סגירה

תגי סימון HTML

• <b> - גופן מודגש
  • לדוגמא: <b>жирный шрифт</b>
  • תוצאה גופן מודגש
• <i> - נטוי
  • לדוגמא: <i>курсив</i>
  • התוצאה אוֹתִיוֹת מוּטוֹת
• — моноширинный шрифт
  • דוגמה: моноширинный шрифт
  • התוצאה моноширинный шрифт

בנוסף לטקסט, אתה יכול לשלוח תוכן אחר בשיטות מיוחדות:

# Отправить изображение
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 ושליחת הודעות על משימות שהסתיימו באופן חריג

כדי לעבוד עם מתזמן המשימות של Windows אתה צריך להתקין את החבילה 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"

דוגמה לקריאת משתנים מתצורה ב-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. כדי לתזמן הפעלה של קובץ זה באופן קבוע, בצע את השלבים הבאים:

1. כתוב את הנתיב לתיקיה שבה מותקן R במשתנה מערכת הנתיב; ב-Windows, הנתיב יהיה בערך כך: C:Program FilesRR-4.0.2bin.
2. צור קובץ bat בר הפעלה עם שורה אחת בלבד R CMD BATCH C:rscriptscheck_botcheck_bot.R. החלף C:rscriptscheck_botcheck_bot.R לנתיב המלא לקובץ R שלך.
3. לאחר מכן, השתמש ב-Windows Task Scheduler כדי להגדיר לוח זמנים להפעלה, לדוגמה, כל חצי שעה.

מסקנה

במאמר זה, הבנו כיצד ליצור בוט ולהשתמש בו כדי לשלוח הודעות שונות בטלגרם.

תיארתי את המשימה של ניטור מתזמן המשימות של Windows, אבל אתה יכול להשתמש בחומר במאמר זה כדי לשלוח הודעות, החל מתחזית מזג האוויר ועד שערי המניות בבורסה, מכיוון R מאפשר לך להתחבר למספר עצום של מקורות נתונים.

במאמר הבא נבין כיצד להוסיף פקודות ומקלדת לבוט כך שהוא יוכל לא רק לשלוח הודעות, אלא גם לבצע פעולות מורכבות יותר.

מקור: www.habr.com