Как через бота отправить сообщение в телеграмм
Перейти к содержимому

Как через бота отправить сообщение в телеграмм

  • автор:

Настройка telegram бота для отправки сообщений

Настройка telegram бота для отправки сообщений

Cкриптом напрямую отправлять сообщения в телеграм не получится, но у нас есть возможность делать GET или POST запросы к api ботам. А Telegram Bot — уже может отправлять пользователю любые сообщения. Поэтому перед написанием php скрипта, нужно создать телеграм бота. Тут все просто и займет всего пару минут. Переходим по ссылке на официальный верифицированный бот: @BotFather. Открываем его в телеграм и выбираем команду «/newbot».
Далее прямо в чате телеграм придумываем и вписываем новое название и логин своему боту.
После успешного создания, BotFather в чат пришлет токен созданного бота для отправки запросов к api (token to access the HTTP API).
После этого нам еще нужно получить id пользователя телеграм, которому и будут в дальнейшем отправляться сообщения.
Чтобы узнать свой telegram id перейдите по ссылке: @getmyid_bot и запустите бота в своем телеграм. В ответ вы получите свой идентификатор — ID.

Полученные данные от @BotFather и @getmyid_bot отправляете разработчикам вашего сайта, которые добавят их в форму обратной связи и с сайта начнут приходить сообщения в телеграм.

Отправка телеграм сообщения через строку браузера

Чтобы отправить сообщение себе через telegram бота, воспользуйтесь API методом sendMessage. Для в вашем браузере прописываем следующий адрес, и вместо token и chat_id ставим свои данные. Вводим запроc, нажимаем на enter и наш бот получает первое сообщение!

Отправка телеграм сообщения на PHP через форму обратной связи

У сервиса Telegram есть документация с подробным описанием всех функций и методов api, для использования. Ссылка на документацию тут: https://core.telegram.org/bots/api. Для разработки сайта на PHP в Киеве можно воспользоваться примером отправки POST запроса с функцией telegram API — sendMessage

Помогла ли вам статья?

Глава 1 Создаём бота, и отправляем с его помощью сообщения в telegram

В этой главе мы разберёмся как создать телеграм бота, и отправлять с его помощью уведомления в telegram.

1.1 Создание телеграм бота

1.1.1 Видео урок о создании telegram бота через BotFather

1.1.2 Конспект о создании telegram бота через BotFather

Для начала нам необходимо создать бота. Делается это с помощью специального бота BotFather, переходим по ссылке и пишем боту /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 попросит вас ввести имя и логин бота.

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 .

Более подробно о возможностях BotFather можно узнать из этой публикации. На этом шаге подготовительные работы по созданию бота завершены.

1.2 Установка пакета для работы с телеграм ботом на R

Я предполагаю, что у вас уже установлен язык R, и среда разработки RStudio. Если это не так, то вы можете посмотреть данный видео урок о том, как их установить.

Для работы с Telegram Bot API мы будем использовать R пакет telegram.bot.

Установка пакетов в R осуществляется функцией install.packages() , поэтому для установки нужного нам пакета используйте команду install.packages(«telegram.bot») .

Более подробно узнать об установке различных пакетов можно из этого видео.

После установки пакета его необходимо подключить:

library(telegram.bot)

1.3 Отправка сообщений из 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(«~») ) текстовый файл с названием .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() , позволяет получить идентификатор чата, из которого было отправлено сообщение. Этот идентификатор нам нужен для отправки сообщений от бота.

Помимо 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" )

Если вам необходимо отправить сообщение от бота не в чат, а в публичный канал, то в chat_id указывайте адрс вашего канала, например ‘@MyTGChannel’ .

При необходимости отправить сообщение в приватный канал, вам необходимо скопировать ссылку на любое сообщение данного канала, из ссылки получить его идентификатор, и к этому идентификатору добавить -100.

Соответвенно, к id 012345678 вам необходимо добавить -100, в таком случае в chat_id надо указать -100012345678.

Основы форматирования 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 .

      Помимо отправки данных бот имеет и ряд других методов:

      • deleteMessage() — Удалить сообщение
      • editMessageText() — Редактирвать текст сообщения
      • editMessageCaption() — Редактировать описание изображения, файла и т.д.
      • forwardMessage() — Переслать сообщение
      • getFile() — Подготовка файла к скачиванию
      • getMe() — Получить информацию о боте
      • getUpdates() — Получить список обновлений бота
      • getUserProfilePhotos() — Получить аватар пользователя
      • leaveChat() — Выйти из группы
      • clean_updates() — Очистить очередь обновлений

      1.4 Как отправить в telegram таблицу

      К сожалению на момент написания книги telegram не поддерживает полноценные таблицы в HTML или Markdown, но вы можете иметировать подобие таблицы. Для этого воспользуйтесь кодом представленной ниже функции to_tg_table() :

      library(purrr) library(tidyr) library(stringr) # функция для перевода data.frame в telegram таблицу  to_tg_table  function( table, align = NULL, indents = 3, parse_mode = 'Markdown' )  # если выравнивание не задано то выравниваем по левому краю if ( is.null(align) )  col_num  length(table) align  str_c( rep('l', col_num), collapse = '' ) > # проверяем правильно ли заданно выравнивание if ( length(table) != nchar(align) )  align  NULL > # новое выравнивание столбцов  side  sapply(1:nchar(align), function(x)   letter  substr(align, x, x) switch (letter, 'l' = 'right', 'r' = 'left', 'c' = 'both', 'left' ) >) # сохраняем имена t_names  names(table) # вычисляем ширину столбцов names_length  sapply(t_names, nchar)  value_length  sapply(table, function(x) max(nchar(as.character(x)))) max_length  ifelse(value_length > names_length, value_length, names_length) # подгоняем размер имён столбцов под их ширину + указанное в indents к-во пробелов  t_names  mapply(str_pad, string = t_names, width = max_length + indents, side = side) # объединяем названия столбцов str_names  str_c(t_names, collapse = '') # аргументы для фукнции str_pad rules  list(string = table, width = max_length + indents, side = side) # поочереди переводим каждый столбец к нужному виду t_str  pmap_df( rules, str_pad )%>% unite("data", everything(), remove = TRUE, sep = '') %>% unlist(data) %>% str_c(collapse = '\n')  # если таблица занимает более 4096 символов обрезаем её if ( nchar(t_str) >= 4021 )  warning('Таблица составляет более 4096 символов!') t_str  substr(t_str, 1, 4021) > # символы выделения блока кода согласно выбранной разметке code_block  switch(parse_mode, 'Markdown' = c('```', '```'), 'HTML' = c('', '')) # переводим в code res  str_c(code_block[1], str_names, t_str, code_block[2], sep = '\n') return(res) >

      С помощью этой функци вы можете преобразовать любой data.frame и отправить в telegram:

      # преобразуем таблицу iris  tg_table  to_tg_table( head(iris, 15) ) # отправляем таблицу в telegram bot$sendMessage(194336771, tg_table, "Markdown")

      В telegram это буедет выглядеть так:

      У функции to_tg_table() есть несколько дополнительных аргументов:

      • align — выравнивнивание столбцов, тектовая строка, каждая буква соответвует одному столбцу, пример ‘llrrc’ :
        • l — выравнивание по левой стороне
        • r — выравнивание по правой стороне
        • c — выравнивание по центру

        Пример с выравниванием столбцов:

        # преобразуем таблицу iris  tg_table  to_tg_table( head(iris, 15), align = 'llccr') # отправляем таблицу в telegram bot$sendMessage(194336771, tg_table, "Markdown")

        1.5 Как добавить в сообщение Emoji

        Требования к телеграм ботам могут быть разные, в том числе заказчик может попросить вас добавить в сообщения бота какие то Emoji.

        Получить полный список доступных смайлов можно по этой ссылке.

        Из таблицы нас интересует поле Unicode. Скопиройте код нужного вам смайла, и замените U+ на \U000 . Т.е. если вам необходимо отправить смайл, код котого в таблице U+1F601 , то в коде на R вам необходимо добавить его в текст сообщения вот так — \U0001F601 .

        bot$sendMessage(chat_id, 'Сообщение со смайлом \U0001F601 код которого в таблице U+1F601')

        Результат:

        1.6 Проверка планировщика задач Windows, и отправка уведомления о задачах, работа которых была завершена аварийно

        1.6.1 Видео урок о разработке бота для контроля планировщика заданий

        1.6.2 Конспект о разработке бота для контроля планировщика заданий

        Для работы с планировщиком заданий 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 у нас теперь список задач, работа которых завершилась ошибкой, этот список нам надо отправить в 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 чата и токен. Читать конфиг можно например с помощью пакета configr .

        [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

        1.7 Настраиваем расписание запуска проверки задач

        Наиболее подробно процесс настройки запуска скриптов по расписанию описан в этой статье . Тут я лишь опишу шаги, которые для этого необходимо выполнить. Если какой-то из шагов вам не понятен, то обратитесь к статье на которую я указал ссылку.

        Предположим, что мы сохранили код нашего бота в файл check_bot.R . Для того, что бы запланировать регулярный запуск этого файла выполните следующие шаги:

        1. Пропишите в системную переменную Path путь к папке в которой установлен R, в Windows путь будет примерно таким: C:\Program Files\R\R-4.0.2\bin .
        2. Создайте исполняемый bat файл, в котором будет всего одна строка R CMD BATCH C:\rscripts\check_bot\check_bot.R . Замените C:\rscripts\check_bot\check_bot.R на полный путь к вашему R файлу.
        3. Далее настройте с помощью планировщика задач Windows расписание запуска, например на каждые пол часа.

        1.8 Заключение

        В этой главе мы разобрались с тем, как создать бота, и отправлять с его помощью различные уведомления в telegram.

        Я описал задачу контроля планировщика заданий Windows, но вы можете использовать материал этой главы для отправки любых уведомлений, от прогноза погоды до котировок акций на фондовой бирже, т.к. R позволяет вам подключиться к огромному количеству источников данных.

        В следующей главе мы с вами разберёмся с тем, как добавить боту команды и фильтры сообщений, для того, что он мог не только отправлять уведомления, но и выполнять более сложные действия.

        1.9 Тесты и задания

        1.9.1 Тесты

        Для закрепления материла рекомендую вам пройти тест доступный по ссылке.

        1.9.2 Задания

        1. Создайте с помощью BotFather бота.
        2. Перейдите к диалогу с ботом, и узнайте идентификатор вашего с ботом чата.
        3. Отправьте с помощью созданного бота в telegram первые 20 строк из встроенного в R набора данных ToothGrowth .

        Если вы всё сделали правильно то результат будет следующим:

        Отправить сообщение в Telegram

        Команда Отправить сообщение в Telegram отправляет текстовое сообщение в указанный Telegram канал с помощью бота.

        API токен бота
        Укажите API токен бота, который будет отправлять сообщение. Бот должен быть в группе администраторов канала и иметь права на публикацию сообщений. В целях безопасности не рекомендуется явно указывать токен бота в этом параметре.

        1154149:AAEAro5-cFiWcIKXX5SsYoa3YE 2#mybot#

        Имя или ID канала
        Укажите имя публичного канала, куда будет отправлено сообщение. Например, @mychannel. Если вы отправляете сообщение в частный канал, то необходимо указать его идентификатор. Например, -10023673443.

        Текст
        Текст отправляемого сообщения.

        Завершать работу при ошибке
        Отметьте этот чекбокс, если вы хотите прекратить выполнение скрипта в случае неудачной отправки сообщения. В этом случае, текст ошибки будет содержать ответ от Telegram сервера.

        Как создать бота и частный Телеграм канал

        1. Найдите бота “botfather” в Телеграм клиенте.
        2. Отправьте /newbot для создания нового бота. Вам следует указать наименование и пользовательское имя бота. Если бот успешно создан, то вы увидите API токен бота подобно 356111742:cFiWcIKXX5SsYHDRDj34oa3YE. Вы не должны никому сообщать этот токен.
        3. Создайте публичный канал с подходящим именем.
        4. Добавьте вашего бота в список администраторов созданного канала. Как минимум, бот должен иметь права на публикацию сообщений.

        На данном этапе вы уже можете отправлять сообщения в созданный канал. Если вы хотите сделать канал частным, то перед этим вам необходимо получить идентификатор канала, так к частным каналам нельзя обращаться по имени. Для этого укажите в браузере следующий адрес https://api.telegram.org/bot[API_TOKEN_BOT]/sendMessage?chat_id=[CHANNEL_NAME]&text=Test, где [API_TOKEN_BOT] — это токен бота, а [CHANNEL_NAME] — имя канала, например @mychannel. Если вы все указали правильно, то вы получите ответ подобно этому

         1 2 "message_id":14, 3 "sender_chat": < 4 "id":-1001345116849, 5 "title":"eonza","type":"channel">, 6 "chat": < 7 "id":-1001345116849, 8 "title":"eonza", 9 "type":"channel">, 10 "date":1610522226,"text":"Test" 11>>

        В параметре id указан идентификатор канала. После этого, вы можете сделать канал частным, а этот идентификатор использовать вместо имени канала.

        Как отправить сообщение в группу Telegram

        Вы можете не только использовать ботов Aimylogic чтобы отправлять личные сообщения в Telegram, но и добавлять их в групповые чаты в Telegram.

        Мы предполагаем, что вы уже создали сценарий бота и знаете, как его опубликовать в канале Telegram, поэтому здесь мы рассмотрим только, как отправлять сообщения в групповой чат.

        Подготовьте сценарий​

        В первую очередь, в качестве стартового экрана добавьте в сценарий текстовый блок, в который скопируйте и вставьте: $rawRequest.message.chat.id

        Этот экран должен быть самым верхним и самым левым, чтобы бот выводил это сообщение первым.

        Добавьте переменные в сценарий​

        Также ваш сценарий должен уметь отправлять данные в Telegram. Для этого их нужно записывать в переменную.

        Например, добавим блок text to $var, с помощью кото

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *