Строим Telegram-бот в Яндекс.Облаке

  • Tutorial
Создание телеграм-бота

Сегодня из подручных материалов мы соберём в Яндекс.Облаке Telegram-бот с использованием Yandex Cloud Functions (или Яндекс-функции — для краткости) и Yandex Object Storage (или Объектное хранилище — для ясности). Код будет на Node.js. Однако, имеется одно пикантное обстоятельство — некая организация под названием, скажем так, РоссКомЦензур (цензура запрещена статьёй 29 Конституции РФ), не позволяет интернет-провайдерам России передавать запросы в Telegram API по адресу: https://api.telegram.org/. Ну мы и не будем — нет так нет. Ведь в нашем саквояже имеются т.н. вебхуки — с их помощью мы не делаем запросы на конкретный адрес, а всего лишь шлём свой запрос в качестве ответа на любой запрос к нам. То есть, как в Одессе — отвечаем вопросом на вопрос. Поэтому Telegram API в нашем коде фигурировать не будет.

Дисклеймер
Упомянутые в данной статье названия каких-либо государственных организаций являются вымышленными, а возможные совпадения с названиями реально существующих организаций — случайными.

Итак, мы сделаем бота, который будет нас снабжать умными мыслями. Точно такого, как на картинке:

Телеграм бот Умные Мысли

Можете испытать его в деле — вот имя: @SmartThoughtsBot. Обратили внимание на кнопочку «Навык Алисы»? Это потому, что бот является своеобразным «компаньоном» для одноименного навыка Алисы, т.е. он выполняет те же функции, что и навык Алисы и, возможно, что они смогут мирно сосуществовать рекламируя друг-друга. О том как создать навык Умные Мысли рассказано в статье Алиса приобретает навык. Сейчас (после внесения некоторых изменений уже после публикации вышеупомянутой статьи) на смартфоне этот навык будет выглядеть примерно так:

Навык Алисы Умные Мысли

Создание бота


Мне бы хотелось, чтобы этот туториал был полезен всем, в т.ч. и начинающим «ботостроителям». Поэтому в этом разделе я довольно подробно опишу как вообще создавать в Telegram'е ботов. Для тех кому эта информация не требуются — переходите к следующим разделам.

Открываем приложение Telegaram, зовём отца всех ботов (у них всё как у людей) — @BotFather — и для начала дадим ему команду /help, чтобы освежить в памяти, что мы можем делать. Сейчас нас будет интересовать команда /newbot.

Создание нового бота

Поскольку описываемый здесь бот уже создан, для демонстрационных целей я создам на короткое время другого бота (потом его удалю). Назову его DemoHabrBot. Имена (username) всех телеграм-ботов должны заканчиваться на слово bot, например: MyCoolBot или my_cool_bot — это для ботов. Но сначала даём боту название (name) — а это для людей. Название может быть на любом языке, содержать пробелы, не обязано заканчиваться на слово bot, и даже не обязано быть уникальным. В данном примере я назвал этот бот Демо Хабр.

Название бота

Теперь выбираем боту имя (username, то, которое для ботов). Назовём его DemoHabrBot. Всё что относилось к названию бота (name) совсем не относится к его имени — username (или относится, но с точностью до наоборот). После успешного создания уникального имени бота, нам надо скопировать и сохранить (в строжайшей тайне!) токен, показанный на скриншоте красной стрелкой. С его помощью мы чуть позже установим исходящий из Telegram'а вебхук на нашу Яндекс-функцию.

Имя бота

А сейчас дадим команду отцу всех ботов: /mybots, и он покажет нами список всех созданных нами ботов. Давайте пока оставим в покое свежеиспечённый бот Демо Хабр (он был создан чтобы показать как создавать ботов, но мы ещё им сегодня воспользуемся для других демонстрационных целей), и рассмотрим бот Умные Мысли (@SmartThoughtsBot). Нажимаем в списке ботов кнопку с его именем.

Настройки бота

Здесь мы можем настроить нашего бота. Нажав кнопку Edit... мы перейдём на редактирование той или иной опции. Например, нажав на кнопку Edit Name мы можем изменить название бота, скажем вместо Умные Мысли, написать Бредовые Идеи. Botpic — это аватар бота, должен быть не менее 150 x 150 px. Description — это краткое описание, который пользователь видит при первом запуске бота, в качестве ответа на вопрос: Что может делать этот бот? About — ещё более краткое описание, которое передаётся с ссылкой на бот (https://t.me/SmartThoughtsBot) или при просмотре информации о нём.

Бот: описание и краткая информация

Нам осталось только настроить команды. Для этого нажимаем кнопку Edit Commands. Для стандартизации пользовательской практики Telegram рекомендует всегда использовать две команды: /start и /help, а если боту необходимы настройки — дополнительную команду /settings. Наш бот прост как шар, поэтому настройки ему пока не нужны. Прописываем две первых команды, которые потом мы обработаем в коде. Теперь, если в поле ввода пользователь введёт слеш (знак косой черты: /), появится список команд для их быстрого выбора. Всё как на картинке: слева — устанавливаем команды через бота-отца; справа эти команды уже доступны пользователям в нашем боте.

Установка и использование в боте команд

Яндекс-функция


Теперь, когда наш бот создан, переходим в Яндекс.Облако, чтобы создать функцию, которая будет выполнять код нашего бота. Если вы ещё не работали с Яндекс.Облаком почитайте материал Алиса в стране Битрикс, а затем — Яндекс-функции рассылают почту. Я почти уверен, что двух этих относительно небольших статей вам вполне будет достаточно для базового понимания предмета.

Итак, в консоли Яндекс.Облака в левом навигационном меню выбираем пункт Cloud Functions, и затем нажимаем кнопку Создать функцию. Присваиваем ей имя, а для себя — краткое описание.

Создание Яндекс-функции

После нажатия кнопки Создать и прошествии пары секунд, новая функция появится в списке всех функций. Нажимаем на её имя — это приведёт нас на страницу Обзор нашей функции. Здесь надо включить (On) переключатель Публичная функция, чтобы она стала доступна из внешнего (для Яндекс.Облака) мира, а значение полей Ссылка для вызова и Идентификатор — хранить в глубокой тайне от всех кроме себя самого и Telegram'a, чтобы вашу функцию не могли вызывать различные аферисты.

Свойства Яндекс-функции

Теперь с помощью левого меню переходим в Редактор функции. Давайте пока отложим на короткое время в сторону наши Умные Мысли, и создадим минимальную функцию-шаблон для проверки работоспособности нашего бота… Впрочем, в данном контексте эта функция и есть наш бот… Короче говоря, сейчас и прямо вот здесь мы сделаем простейшего бота, который будет «зеркалить» (т.е. отправлять назад) запросы пользователей. Этот шаблон можно использовать всегда при создании новых телеграм-ботов, чтобы убедиться, что связь с Telegram'ом работает нормально. Нажимаем Создать файл, называем его index.js, и в он-лайн Редакторе кода вставляем в этот файл следующий код:

module.exports.bot = async (event) => {
  
  const body = JSON.parse(event.body);

  const msg = {
    'method': 'sendMessage',
    'chat_id': body.message.chat.id,
    'text': body.message.text
  };

  return {
    'statusCode': 200,
    'headers': {
      'Content-Type': 'application/json'
    },
    'body': JSON.stringify(msg),
    'isBase64Encoded': false
  };
};

В консоли Яндекс.Облака это должно выглядеть примерно так:

Код простейшего бота на Яндекс-функциях

Далее чуть ниже указываем Точку входаindex.bot, где index это имя файла (index.js), а bot — имя функции (module.exports.bot). Все остальные поля оставляем «как есть», и в правом верхнем углу нажимаем кнопку Создать версию. Через несколько секунд эта версия функции будет создана. В скором времени, после тестирования вебхука, мы создадим новую версию — Умные Мысли.

Точка входа Яндекс-функции

Объектное хранилище


Теперь, когда у нас создана Яндекс-функция, давайте, пока мы находимся в консоли Яндекс.Облака, создадим т.н. бакет (bucket, т.е. ведро по-русски, отнюдь не букет) для хранения файлов изображений, которые будут использоваться в нашем боте Умные Мысли. В левом навигационном меню выбираем пункт Object Storage, нажимаем кнопку Создать бакет, придумываем ему название, например, img-bucket, и, главное, Доступ на чтение объектов делаем публичным — иначе Telegram'у наших картинок не видать. Все остальные поля оставляем без изменений. Нажимаем кнопку Создать бакет.

Создание бакета.

После этого список всех бакетов может выглядеть примерно так (если это ваш единственный бакет):

Список бакетов

Сейчас я предлагаю нажать на имя бакета, и внутри него создать папку, чтобы упорядочить хранение картинок для разных своих приложений. Например, для телеграм-бота Умные Мысли я создал папку под названием tg-bot-smart-thoughts (ничего, я пойму этот шифр). Создайте и вы какую-нибудь.

Создание папки внутри бакета

Теперь можно нажать на имя папки, зайти в неё и загружать файлы:

Загрузка файла в папку в бакете

А нажав на имя файла — получить его URL для использования в нашем боте, и вообще — где либо (но, не публикуйте этот URL без надобности, поскольку трафик с Объектного хранилища тарифицируется).

Получение адреса файла в Объектном хранилище

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

Вебхук


Сейчас мы установим вебхук — т.е. когда бот получит обновление (например, сообщение от юзера), с сервера Telegram в нашу Яндекс-функцию будет отправлен запрос (request) с данными. Вот строка, которую можно просто вставить в адресное поле браузера, и затем обновить страницу (это надо сделать всего один раз): https://api.telegram.org/bot{bot_token}/setWebHook?url={webhook_url}
Только заменим {bot_token} на токен полученный нами от бота-отца при создании нашего бота, а {webhook_url} — на URL нашей Яндекс-функции. Минутку! Но ведь РоссКомЦензур запрещает провайдерам в РФ обслуживать адрес https://api.telegram.org. Да, верно. Но вы придумайте что-нибудь. Ведь можно же, например, попросить об этом свою бабушку в Украине, Израиле или Канаде — там нет никаких «росскомцензур», и один бог ведает, как люди живут без этого. В итоге, запрос-ответ при установки вебхука должен выглядеть так:

Установка вебхука

Тестируем. Должно «зеркалить».

Первое тестирование бота

Так и есть. Наши поздравления — теперь Яндекс-функция стала Telegram-ботом!

Умные Мысли


А теперь делаем Умные Мысли. Код открыт и и лежит на GitHub. Он довольно хорошо прокомментирован, и в нём всего сотня строк. Читайте его как оперная дива либретто!

Код бота Умные Мысли

Склонируйте проект и установите зависимости:

git clone https://github.com/stmike/tg-bot-smart-thoughts.git
cd tg-bot-smart-thoughts
npm i

Внесите необходимые вам изменения в файл index.js (опционально; можно ничего не менять). Создайте zip-архив, с файлом index.js и папкой node_modules внутри, например, под названием smart.zip.

ZIP архив бота Умные Мысли

Теперь перейдите в консоле к нашей Яндекс-функции, выберите вкладку ZIP-архив, нажмите кнопку Выбрать файл, и загрузите наш архив smart.zip. Наконец, в правом верхнем углу нажмите кнопку Создать версию.

Создание рабочей версии бота

Через несколько секунд, когда функция обновится, протестируем снова нашего бота. Теперь он уже не «зеркалит», а поставляет умные мысли!

Завершение создания бота Умные Мысли

На сегодня всё. Другие статьи следуют. Кому подобное читать интересно — подписывайтесь на уведомления о новых статьях. Подписаться можно здесь, или на Telegram-канал IT Туториал Захар, или Twitter @mikezaharov.

Ссылки


Код на GitHub
Yandex Cloud Functions
Yandex Object Storage
Bots: An introduction for developers
Telegram Bot API

Донаты


Донаты
AdBlock похитил этот баннер, но баннеры не зубы — отрастут

Подробнее
Реклама

Комментарии 27

    +5
    Ну незнаю, я не стану размещать своих ботов в яшаоблаке (как и виртуалки, базы и прочее) до тех пор пока они не скажут роскомпозору нет. Не моя забота как и какой ценой. Они взрослые ребята, пусть сами придумают.
      0
      Проблема серьёзная — недостаточно просто сказать «нет» — это однозначно бы привело к выходу из бизнеса в РФ. Заинтересованы ли мы (пользователи и разработчики) в этом? Думаю, что нет. Поэтому тактикой должна стать не обструкция провайдеров, а обструкция «роскомпозора», как вы хорошо выразились. Обструкция же, на мой взгляд, должна заключаться в публичном неприятии этой практики, и доведение её до смехотворности. В этом случае власти придётся потихоньку свести её на нет. Она и так уже пытаются это сделать, но боится «потерять лицо», поэтому общественное давление на эту её болевую точку должно усиливаться.
        0
        Нет, не привело бы. Сотни тысяч курьеров и таксистов оставшиеся без того что приносило им заработок способны моментально вразумить роскомнадзор.
          0
          Вы ослеплены яростью. Роскомнадзор является федеральным органом исполнительной власти. Нарушение — блокировка. Они блокируют нарушителей, как робот на автомате. Проблема не в Роскомнадзоре.
      –1
      Это кастратное решение. Использование только вебхука начисто лишает бота какой либо самостоятельной функциональности, вопрос — быстрый ответ, и всё.
        0
        Да, webhook — не на все случаи жизни, но на многие. Long polling с территории РФ, по-видимому, пока недоступен (по крайней мере легально).
          0
          С каких пор прокси в РФ нелегальны?
            0
            А, ну да — через прокси, пожалуй, ОК — но надо поговорить с юристом. :) Но тогда я бы лучше вынес код в другую юрисдикцию — чтобы не иметь дополнительную временную задержку на проксирование.
        0

        Через google apps script (GAS) к api.telegram.org доступ есть, только сам GAS своеобразный.

          +2

          Зачем использовать облако Яндекса если есть лучше, дешевле и безопасней — Amazon/Do/Aruba/Google ?

            0
            Согласен. Лично я сам использую некоторые из перечисленных вами. Но бывают обстоятельства (например, у юрлиц), когда нужен именно отечественный сервис. В общем я не призываю пользоваться именно им, просто показываю как это можно сделать, если потребуется.
              0
              Насчет дешевле я бы небыл так котегоричен.
              Сравним цены например на S3
              Яндекс стандартное хранилище 1,26 за ГБ
              Амазон 1,44
              Также трафик у амазона подороже
                0
                Облако изначально строилось как оптимизация недоеденных своими сервисами ресурсов. Причём распределение мощностей идёт по остаточному принципу, сейчас когда сервис стал публичным — могли докупить железа. S3 строился с другой целью и принципами. Хотя я уже за отсутствие товарища майора готов доплатить разницу.
                  0
                  Отсутствие товарища майора вам не обещалось (по крайней мере под юрисдикцией РФ).
                    0
                    Когда пообещают — тогда пусть и приходят со своим облаком.
              0
              Подскажите вот в этом виде, сколько это всё стоит, я долго пытался там посчить на калькуляторах, и у меня выходило дешевле свой vps иметь
                0
                Мы используем функции, тарификация которых зависит от кол-ва вызовов, времени выполнения, и выделенной памяти. Поэтому надо считать в каждом конкретном случае. Например, 1M вызовов стоит 10 руб. Подробности посмотрите здесь: cloud.yandex.ru/docs/functions/pricing
                  0
                  ну вот у них там в примере 10М и стоимость 3900. если по их калькулятору тогда выходит 390 рублей. Плюс у вас 128 мегабайт а у них 512, в итоге получается 97 рублей.

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

                  Видимо надо тестировать и смотреть.
                    0
                    Верно — у описываемого бота время вызова 100 мс.
                    Log
                    И это при том, что он обращается по HTTP к стороннему API.
                0

                Так вебхуки не спасут ситуацию с ркн от отправления ответа юзеру. Через вебхук можно получить команду пользователя к боту, но чтоб отправить ответ, придется обращаться к домену апи, который у нас заблокирован.

                  0
                  Здесь мы рассуждали о функциях, которые должны корректно отвечать на запросы от Telegram. И сделали это через вебхуки. А как юзеру пользоваться Telegram в РФ — это он должен сам позаботиться (законом ему пользоваться не запрещено).
                    0
                    Как вы умудряетесь получать вебхуки и при этом не посылать ничего на заблокированный адрес?
                    HTTP GET request and reply over TCP
                    image
                      0
                      Мы просили бабушку это сделать (один раз).
                  0
                  опросить об этом свою бабушку в Украине, Израиле или Канаде — там нет никаких «росскомцензур»
                  Я так понимаю вы данный вопрос не изучали и взяли примеры наугад?
                  Ведь в Украине мало того, что есть есть интернет-цензура (указ № 133/2017), так еще и конкретно все сервисы Яндекса как раз под неё попали. Так что тамошняя бабушка с Яндекс.Облаком вам не поможет.
                  Вот Израиль и Канада в данном конкретном случае звучат надежно.
                    0
                    Это аллегория — дело не в какой-то конкретной стране…
                    0

                    Хм. У используемого мной хостинг-провайдера (РФ) блокировки нет, так что вопрос регулирования для меня открыт, должно ли оно быть или это инициатива Яндекса

                      0
                      Строгость российских законов смягчается необязательностью их исполнения. (с) Салтыков-Щедрин. :)

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

                    Самое читаемое