Telegram 청중은 매일 기하 급수적으로 증가하고 있으며 이는 메신저의 편리함, 채널의 존재, 채팅 및 물론 봇 생성 기능으로 인해 촉진됩니다.

봇은 고객과의 커뮤니케이션 자동화부터 자체 작업 관리까지 완전히 다른 목적으로 사용될 수 있습니다.

기본적으로 텔레그램을 사용하면 봇을 통해 데이터 전송 또는 요청, 서버에서 작업 실행, 데이터베이스에 정보 수집, 이메일 보내기 등 모든 작업을 수행할 수 있습니다.

나는 작업 방법에 대한 일련의 기사를 쓸 계획입니다. 텔레그램 봇 API, 필요에 맞게 봇을 작성하세요.

이 첫 번째 기사에서는 텔레그램 봇을 만들고 이를 사용하여 텔레그램으로 알림을 보내는 방법을 알아봅니다.

결과적으로 Windows 작업 스케줄러에서 모든 작업의 ​​마지막 실행 상태를 확인하고 작업 중 하나라도 실패하면 알림을 보내는 봇을 갖게 됩니다.

하지만 이 기사 시리즈의 목적은 특정하고 좁은 작업을 위한 봇 작성 방법을 가르치는 것이 아니라 일반적으로 패키지 구문을 소개하는 것입니다. telegram.bot, 그리고 자신의 문제를 해결하기 위해 봇을 작성할 수 있는 코드 예제입니다.

내용

데이터 분석에 관심이 있다면 제 글에도 관심이 있으실 겁니다. 전보 и 유튜브 채널. 대부분의 콘텐츠는 R 언어에 전념합니다.

1. 텔레그램 봇 만들기
2. R에서 텔레그램 봇 작업을 위한 패키지 설치
3. R에서 텔레그램으로 메시지 보내기
4. 작업 검사 실행 일정 설정
5. 결론

텔레그램 봇 만들기

먼저 봇을 만들어야 합니다. 이 작업은 특수 봇을 사용하여 수행됩니다. 봇 아버지, 이동 링크 그리고 봇에 글을 쓰세요 /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 개발 환경이 설치되어 있다고 가정합니다. 그렇지 않은 경우에는 이것을 볼 수 있습니다. 비디오 урок 설치 방법에 대해.

Telegram Bot API를 사용하기 위해 R 패키지를 사용합니다. 텔레그램봇.

R에서 패키지 설치는 다음 함수를 사용하여 수행됩니다. install.packages(), 필요한 패키지를 설치하려면 다음 명령을 사용하십시오. install.packages("telegram.bot").

다양한 패키지 설치에 대해 자세히 알아볼 수 있습니다. 이 비디오.

패키지를 설치한 후 연결해야 합니다.

library(telegram.bot)

R에서 텔레그램으로 메시지 보내기

귀하가 생성한 봇은 생성 시 지정된 로그인을 사용하여 Telegram에서 찾을 수 있습니다. 제 경우에는 @my_test_bot.

봇에게 "Hey 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"
)

마크다운 서식 기본 사항:

• 굵은 글꼴은 *로 강조 표시됩니다.
  • 예 : *жирный шритф*
  • 결과 : 볼드체
• 기울임꼴은 밑줄로 표시됩니다.
  • 예 : _курсив_
  • 결과 : 이탤릭체
• 일반적으로 프로그램 코드를 강조 표시하는 데 사용되는 고정폭 글꼴은 아포스트로피(`:)를 사용하여 지정됩니다.
  • 예: `고정 폭 글꼴`
  • 결과 : моноширинный шрифт

HTML 마크업 형식 지정의 기본 사항:
HTML에서는 강조 표시해야 하는 텍스트 부분을 태그로 묶습니다. 예를 들면 다음과 같습니다. <тег>текст</тег>.

• <태그> - 여는 태그
• - 닫는 태그

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

}

위의 예를 사용할 때 봇 토큰과 채팅 ID를 코드로 대체하세요.

예를 들어 시스템 작업을 제외하고 자신이 생성한 작업만 확인하는 등 작업 필터링 조건을 추가할 수 있습니다.

다양한 설정을 별도의 구성 파일에 넣고 채팅 ID와 토큰을 저장할 수도 있습니다. 예를 들어 패키지를 사용하여 구성을 읽을 수 있습니다. configr.

ini 구성 예시

[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. Path 시스템 변수에 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 작업 스케줄러를 사용하여 시작 일정(예: XNUMX분마다)을 설정합니다.

결론

이번 글에서는 봇을 생성하고 이를 사용하여 텔레그램으로 다양한 알림을 보내는 방법을 알아보았습니다.

Windows 작업 스케줄러를 모니터링하는 작업에 대해 설명했지만 이 기사의 자료를 사용하여 일기 예보에서 증권 거래소의 주식 시세에 이르기까지 모든 알림을 보낼 수 있습니다. R을 사용하면 수많은 데이터 소스에 연결할 수 있습니다.

다음 기사에서는 봇이 알림을 보낼 뿐만 아니라 더 복잡한 작업을 수행할 수 있도록 명령과 키보드를 봇에 추가하는 방법을 알아 보겠습니다.

출처 : habr.com