/ Пишем код

Создаём своего первого робота в Telegram при помощи Python 3

Доброго времени суток, читатель.

Как я и говорил в своей первой записи, на страницах этого дневника я собираюсь написать немного буковок на тему создания роботов (или ботов, как тебе нравится?) в Telegram. Собственно говоря, для создания таковых, я сам использую Python третьей версии, из чего следует то, что рассказывать буду я именно о Python.

Кто такие роботы и зачем они нужны

Робот (да, мне нравится называть их так) — это такой же пользователь Telegram (как @kozak, как и ты), только с определёнными функциями (или умениями). Если ты пользуешься Telegram, то наверняка уже сталкивался с некоторыми из них. Чего стоит один только Фридрих (спасибо Даше, она первая рассказала мне об этом роботе).

На самом деле роботы могут делать очень много интересных вещей, начиная рассылкой погоды, новостей, записей из ВКонтакте, поиском и скачиванием книг, музыки... в общем потенциал роботов ограничен разве что фантазией разработчика и API Telegram для ботов (последний ну очень уж богат возможностями).

К чему я всё это? Чтобы сложить небольшое представление о том, что мы будем делать дальше. Робот — это программа, написанная, кстати сказать, на любом языке программирования, и запущенная на каком-нибудь сервере (или на компьютере разработчика, в крайнем случае).

Пришло время начинать

Итак, для того, чтобы сделать своего первого робота, тебе потребуются:

  • Компьютер (ну а как же без него?) на macOS, Linux или Windows;
  • Telegram, желательно также на компьютере, можно воспользоваться веб-версией, если лень скачивать;
  • Python 3 и менеджер пакетов pip для него (всё это мы будем устанавливать ниже, не переживай).

Если всё готово, есть хотя бы компьютер и Telegram, то можем начинать.

Устанавливаем Python 3

Python 3 по-разному устанавливается на разные OS (уж простите за тавтологию), поэтому ниже тебе нужно найти твою OS.

Если у тебя macOS

Отправляемся на официальный сайт Python и загружаем (можешь нажать прямо здесь) .pkg установщик последней стабильной версии Python 3.5.2. Запускаем и устанавливаем Python на наш компьютер. После завершения установки можно открыть Terminal и попробовать выполнить команду python3. Если всё установилось правильно (как на картинке ниже), то у тебя на macOS теперь можно смело начинать программировать на Python.

Выполнение команды python3 на macOS.

Менеджер пакетов pip устанавливается автоматически вместе с Python3, выполнение команды pip3 -V должно вывести в терминал следующее:

pip 8.1.2 from /Library/Frameworks/Python.framework/Versions/3.5/lib/python3.5/site-packages (python 3.5)

Где вместо 8.1.2 будет указана твоя версия pip.

Если у тебя Windows

Переходим на официальный сайт Python и выбираем нужную нам версию 3.5.2: для 32-разрядных или версию для 64-разрядных систем (зависит от твоего компьютера; узнать разрядность можно, открыв ПроводникЭтот компьютер — и по нажатию на правую кнопку мыши выбрать пункт Свойства).

Когда мы скачали нужную версию Python, запускаем установщик. Важно: на самом первом этапе установки необходимо отметить Add Python 3.5 to PATH, это очень упростит нашу работу в будущем. Затем нажимаем на Install now и ждём окончания установки.

Установка Python 3 на Windows.

Чтобы проверить, правильно ли установился Python, открываем меню Пуск и в строке поиска набираем командная строка (в Windows 10 открыть поиск можно, просто нажав на лупу рядом с кнопкой Пуск).

В открывшемся окне командной строки выполняем команду python. В ответ должна открыться консоль Python (начинается с >>>) как на картинке ниже.

Запуск Python из командной строки Windows.

Выполняем команду exit(), чтобы выйти из режима интерпретатора Python. Менеджер пакетов pip так же должен быть установлен, чтобы проверить, выполни команду pip -V. В ответ в консоли должна отобразиться версия pip:

pip 8.1.1 from c:\users\hpstr\appdata\local\programs\python\python35\lib\site-packages (python 3.5)

В Linux и другие Unix-системы Python 3.5 устанавливается аналогично macOS.

Таким образом, мы подготовили наш компьютер для программирования и исполнения программ на Python 3.

Подготавливаем Python для создания роботов

Что такое “менеджер пакетов pip” и для чего он нужен нам, спросишь ты. Так вот, менеджер пакетов — это такая утилита, с помощью которой можно скачивать (и сразу устанавливать) различные модули для Python. В macOS нужно использовать команду pip3 вместо pip (команда pip здесь используется для встроенной версии Python 2.7).

Возвращаемся в терминал (или в командную строку) и выполняем следующую команду:

pip install pyTelegramBotAPI

Что здесь просиходит? Мы обращаемся к pip (помни: в macOS это pip3) и хотим установить (install) волшебный модуль pyTelegramBotAPI, который и отвечает за создание и работу ботов.

Устанавливаем pyTelegramBotAPI

Если модуль успешно установился, то мы должны увидеть надпись Successfully installed pyTelegramBotAPI-x.x.x. Собственно говоря, существует множество других модулей для Python (и не только), с помощью которых можно быстро запустить Telegram-бота; простыми словами pyTelegramBotAPI — это такой “конструктор”, в котором содержатся все необходимые нам компоненты-“кубики”.

Можно переходить к самой интересной части — написанию кода нашего робота.

Пишем код нашего первого робота

Для того, чтобы писать код, нам понадобится редактор. Можно, конечно, воспользоваться и Блокнотом, но лично я бы не советовал. Лучше всего скачать бесплатный редактор Atom от создателей GitHub. Или Sublime Text 3 (но он платный, вроде бы). Я пользуюсь Sublime Text, и писать код буду в нём. Ну, а тебе уж решать самому.

Перво-наперво подключаем модуль telebot, который мы установили с помощью pip. Делаем это так:

import telebot

Теперь нам нужно зарегистрировать нашего робота в Telegram. Для этого открываем приложение Telegram (либо веб-версию) и переходим к боту @BotFather. Запускаем бота и отправляем ему команду /newbot.

Первым делом нас спросят о названии бота, именно об имени, то, что будет отображаться в списке диалогов рядом с аватаркой. Назовём нашего бота Первый робот, отправим это сообщение @BotFather. Теперь нужно придумать уникальный логин бота, который должен оканчиваться на bot. Пусть будет JustARobot. Помни: логин робота в дальнейшем изменить нельзя.

Регистрирация робота в Telegram.

Если логин никем не занят, то Bot Father отпавит нам сообщение об успешном создании нового бота. Всё, что нам нужно узнать из полученного сообщения — длинную строку, TOKEN бота. Это ключ, с помощью которого мы сможем управлять нашим роботом через Python.

В моём примере ключ: 242589731:AAGDz-F8q5TN0IfD3Y_D4WB0BmerHm1UYiw. Можешь не пытаться его использовать, он уже обновлён 😏

Возвращаемся в текстовый редактор, и добавляем следующую строку, где присваиваем переменной TOKEN наш ключ-строку:

TOKEN = 'здесь_должен_быть_ключ' # полученный у @BotFather

Теперь можно создать объект нашего робота, так и назовём его — bot. В аргументах указываем ключ для аутентификации в Telegram:

bot = telebot.TeleBot(TOKEN)

Отлично, мы зарегистрировали бота и смогли передать его управление Python.

А сейчас нужно подумать (а может, думать надо было с самого начала?) о том, что будет делать наш робот. Поскольку эта запись посвящена созданию “первого” робота в Telegram, я думаю, не стоит делать нашего бота очень сложным.

Пусть будет так: когда кто-то запускает робота, то робот спрашивает имя пользователя, и после того, как получает имя, приветствует его.

Наша библиотека pyTelegramBotAPI (модуль для Python) поддерживает обработчики (или хэндлеры), с помощью которых можно научить робота отвечать на различные сообщения. Подробнее об обработчиках можно почитать здесь. Создадим обработчик, который будет отвечать на команду /start (эта команда соответствует нажатию кнопки Start или Запустить в профиле бота в Telegram); внутри обработчика создадим функцию, в которой будем спрашивать пользователя его имя.

@bot.message_handler(commands=['start'])
def start(message):
    sent = bot.send_message(message.chat.id, 'Как тебя зовут?')
    bot.register_next_step_handler(sent, hello)

Объясню каждую строку кода:

  1. Обработчик, который отвечает на команду /start (или любые другие, какие указаны в списке);
  2. Функция в обработчике, которая спрашивает у пользователя его имя;
  3. В переменную sent записывается объект отправленного текстового сообщения с вопросом “Как тебя зовут?”; первый аргумент функции send_message — уникальный ID пользователя Telegram (получаем его из предыдущего сообщения message.chat.id), который обратился к нашему боту, и которому нужно отправить сообщение; второй аргумент — строка, текст сообщения;
  4. Функция register_next_step_handler, принимающая в аргументы объект отправленного сообщения и имя следующей функции hello отвечает за то, что следующее сообщение от пользователя будет обработано функцией hello.

Далее создадим саму функцию hello, в которой и будем приветствовать нашего дорогого пользователя:

def hello(message):
    bot.send_message(message.chat.id, 'Привет, {name}. Рад тебя видеть.'.format(name=message.text))
  1. Создаём функцию (в аргументы, кстати, и hello и start принимают объект входящего сообщения от пользователя, там есть текст, ID, и многое другое);
  2. Отправляем сообщение с приветствием, в name подставляем текст полученного сообщения от пользователя (то есть его имя).

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

Последнее, что осталось добавить в код:

bot.polling()

Зачем? Можно, конечно, запустить робота и без этой строки, но тогда он проработает не более одной секунды (а может и меньше). Суть в том, что при помощи функции polling наш робот постоянно обращается к серверам Telegram и как бы спрашивает “есть ли новые сообщения для меня (т. е. робота)?”, получая ответы от Telegram.

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

Код робота на Python.

Сохраняем код нашего робота в файл с расширением .py, например robot.py. Важно знать папку, в которую мы сохранили файл.

Возвращаемся в терминал (или командную строку) и выполняем следующую команду:

python полный/путь/к/файлу/robot.py

Команда для запуска робота в macOS.

Замечу, что в Windows используется команда python, а в macOS python3 (поскольку в macOS ещё установлен Python 2.7).

Нажимаем Enter.

Запуск робота в macOS.

Ничего не происходит? Замечательно, всё так и должно быть. Может даже показаться, что терминал завис, но это совсем не так.

Не закрываем терминал (оставляем всё как есть) и открываем нашего робота в Telegram (по логину, у нас был @JustARobot, либо по ссылке из сообщения от @BotFather). Запускам робота кнопкой Start (или Запуск, зависит от локализации).

Если ты всё правильно сделал, то робот должен ответить:

Наш робот в Telegram.

Отправляем роботу наше имя.

Ответ от робота.

Прекрасно! Всё работает ☺️

Чтобы выключить робота, вернись в терминал и нажми сочетание клавиш Ctrl + c.

У тебя получилось сделать своего первого робота, поздравляю 👍

Что дальше?

А дальше только твоя фантазия и желание учиться. Я оставлю ссылки, которые помогли (и помогают до сих пор) мне в этом деле. Если у тебя есть вопросы, ты всегда можешь задать их в комментариях ниже.

  • Учебник по Python 3 (http://pythonworld.ru) — отличный русскоязычный сайт с которого можно начать изучать Python;
  • Курс по Python на CodeCademy (https://www.codecademy.com/learn/python) — англоязычный курс по Python 2.7, лично я начинал своё знакомство с этим языком программирования именно здесь;
  • Уроки по созданию ботов Telegram от @Groosha (https://www.gitbook.com/book/kondra007/telegram-bot-lessons/details) — всё, что нужно знать о роботах Telegram на Python, очень подробно и понятно рассказано о многих аспектах роботодела; отдельно хочу сказать спасибо @Groosha — много раз помогал мне в этом деле 😉
  • Репозиторий pyTelegramBotAPI на GitHub (https://github.com/eternnoir/pyTelegramBotAPI) — подробная англоязычная документация по модулю telebot, описаны все функции и есть несколько примеров в каталоге examples;
  • Telegram Bot API (https://core.telegram.org/bots/api) — полная официальная англоязычная документация с описанием всех возможностей и функций API Telegram для ботов.

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