В данном кейсе вы узнаете основы написания чат-ботов на питоне, научитесь работать с библиотекой pyTelegramBotAPI, а также создадите своего первого бота!
Технологии, которые мы будем использовать:
Python
Высокоуровневый язык программирования общего назначения, ориентированный на повышение производительности разработчика, читаемости кода и его качества.
pyTelegramBotAPI
Библиотека для взаимосвязи языка программирования Python и Telegram API. Документация
Visual Studio Code
Редактор исходного кода. Позиционируется как "легкий" редактор кода для кроссплатформенной разработки веб- и облачных приложений. Установка простая, ссылка - https://code.visualstudio.com/download
Git Bash
Приложение для сред Microsoft Windows, эмулирующее работу командной строки. Установка простая, ссылка - https://gitforwindows.org
Установка Python
Переходим на сайт https://www.python.org/downloads/ и нажимаем кнопку Download Python 3.10.2 (на момент написания кейса версия 3.10.2)
Открываем .exe установщик, который скачали. Будет называться python-3.10.2-amd64.exe. После открытия установки обязательно ставим галочку у пункта Add Python to PATH, далее жмем Install Now
Откройте VSC, слева найдите боковую панель, а на ней "Extensions" (Расширения)
В открывшейся вкладке введите "Python" и нажмите "Install" (на скрине он уже установлен)
Создайте папку в удобном для вас месте. После этого в VSC нажмите "File - Open Folder" (Файл - Открыть Папку). Найдите вашу папку, выберите ее и нажмите "Открыть". Слева появится ваша папка и все внутренние файлы. Пока что папка пустая (называется "test").
Сверху найдите вкладку "Terminal", выберите "New Terminal". Снизу появится Терминал с указанием места нахождения
В правой стороне терминала найдите "+" со стрелкой вниз. Нажмите на стрелку и выберите Git Bash. В результате терминал поменяет свой вид.
->
Создание проекта
В терминале запустите команду pip install pyTelegramBotAPI. Дождитесь окончания установки
Терминал будет выглядеть примерно так:
Необходимо создать чат-бота в телеграмм. Для этого найдите Отца Ботов (BotFather):
Нажмите кнопку Start и напишите команду /newbot. Благодаря данной команде мы начнем создавать бота. На скрине ниже видно, что для создания требуется имя. Можете написать любое:
Далее необходимо создать username для вашего бота, которое ОБЯЗАТЕЛЬНО должно оканчиваться на Bot или _bot:
На скрине выше видно, что название justbot_bot уже занято. Постарайтесь придумать уникальное название. Если вы все сделали правильно, то в ответ вам будет выдан токен - уникальный ключ доступа для вашего бота (красный на скрине). Токен частично замазан для безопасности. По ссылке (выделена синим) вы можете перейти в чат к своему боту
Python код
Возвращаемся в VSC. В Проводнике слева щелкаем правой кнопкой мыши на New File (Создать файл). Затем впишите название файла: test_bot.py и нажмите Enter:
Запишите следующий код в ваш файл:
Для запуска файла нажмите на стрелочку в правом верхнем угла. При наведении появится фраза Run Python File. Если вы все сделали правильно, то терминал будет выглядеть так, как на скрине ниже. Обратите внимание, что в терминале справа ниже Git появился Python. Для остановки бота достаточно навести на Python и выбрать Delete (Удалить):
Перейдите в телеграмм и отправьте вашему боту команду /start. В ответ вы должны получить "Привет":
Сделаем бота умнее!
Давайте добавим боту возможность как-то реагировать на любое пришедшее слово, если оно не является командой. Добавим следующий код:
Проверим его работоспособность:
Дадим боту возможность отправлять по команде /cat рандомную картинку с котиком. Для этого скачайте 10 любых картинок, разместите их в папке с файлом программы и назовите их цифрами от 1 до 10. Все файлы должны быть в формате .jpg или .png. Если все сделано правильно, проводник будет выглядеть так:
Добавим в код новый импорт и новую функцию. Проверим работоспособность:
Надеюсь у тебя все получилось! Можешь продолжить развивать своего бота самостоятельно. У тебя обязательно получится!