Создание Телеграмм бота с нуля на Python. Пошаговая инструкция для новичков/чайников
В этой небольшой инструкции, вам будет пошагово показано, как создается Бот для мессенджера Телеграм, как установить среду разработки Python (какие программы нужны).
*
В данном случае, основы языка Python, особо не будут рассмотрены.
Т.к цель статьи - показать как вставить и применить готовый код легкой программы, в среде разработки Python, или в самом мессенджере Телеграм.
*
Данный материал нужен для тех, кто хочет понять общие принципы разработки Телеграм-ботов и программ на языке Python.
*
Предупреждение:
*
1. Эта инструкция написана для новичков, поэтому все тут подробно будет расписано!
*
2. Данный Телеграм-бот будет работать ,только пока на вашем компьютере запущен проект в программе "PyCharm Community Edition".
*
После команды "Stop" в программе PyCharm , и закрытия программы PyCharm , созданный бот в Телеграмме, перестанет отвечать на вводимые в него команды.
*
Но когда вы снова запустите проект в PyCharm, Телеграм-бот исполнит все команды, которые ранее он не мог исполнить.
*
3. Отступы в строках кода на языке Python, играют важную роль, иначе среда разработки и бот, не будут выполнять код, и выдадут ошибку или игнор.
*
НАЧАЛО РАБОТЫ.
*
Ставим необходимые программы для разработки.
*
1) Скачиваем и устанавливаем интерпретатор языка Python.
*
Скачивать надо с официально сайта https://www.python.org, страница загрузки находится по ссылке, где выбираем стабильный релиз, для вашей ОС.
https://www.python.org/downloads/windows/
*
2) Скачиваем среду разработки.
В данном случае это "PyCharm Community Edition". В данном случае программа была скачана из
https://www.jetbrains.com/pycharm/download/other.html
*
Создаем самого бота в Телеграм.
*
Ищем в поиске Телеграма, бота с ником @botfather.
Это бот, который и создает нужные нам боты, управляет ими, дает необходимую информацию о созданных ботах и т.д.
*
ВНИМАНИЕ!
У бота должна стоять белая галочка в синем кружке, которая доказывает, что бот настоящий, а не поддельный(иначе можно попасться на вредоносный бот).
Запускаем сам бот командой /start или нажимаем появившуюся кнопку START.
*
После запуска бота @BotFather , пишем команду: /newbot
Бот-конструктор попросит нас указать "ИМЯ создаваемого нами бота"
Пишем любое свободное слово.
*
В качестве пример, был введено имя Winkiway
*
Затем бот-конструктор попросит назначит НИК к нашему боту.
Ник обязательно должен оканчиваться на bot.
В качестве пример, был назначен ник "Winkiway_bot".
*
Вводим в бот-конструктор команду:
/token
*
Далее нажмите на появившуюся кнопку, с названием вашего бота (в данном случае Winkiway_bot).
*
Эта команда просит бот-конструктор, показать токен (длинный набор символов), который позволяет коду нашего созданного бота, запускаться в Телеграм.
УСТАНОВКА модуля telebot для Python.
*
Запускаем диалоговое окно "Выполнить" в Windows.
Для этого, одновременно зажмите клавиши Win + R.
В открывшемся окне , отобразиться строка для запросов.
Введите команду(в окне "Выполнить"):CMD
*
Кликните по кнопке «ОК» или клавише Enter, чтобы открыть утилиту.
*
Откроется терминальное окно команд Windows, в виде черного экрана с текстом.
*
В появившемся терминальном окне команд Windows, введите следующую командуpip install pyTelegramBotAPI
Если установка начала выполняться, и все пошло успешно, то отобразятся различные строки, как на скриншоте ниже.
ПЕРЕЙДЕМ К НАПИСАНИЮ КОДА СОЗДАВАЕМОГО ТЕЛЕГРАМ-БОТА
*
Создаем папку проекта-бота под название :
Winkiway_bot
*
Открываем стандартную программу БЛОКНОТ, и вставляем туда следующий код.
*
Примечание:
Строка начинающаяся с bot = telebot.TeleBot ("ТОКЕН ВАШЕГО БОТА"), содержит индивидуальный токен вашего бота, который дает доступ к управлению вашим ботом.
*
Если этот токен станет известен посторонним, то они смогут управлять вашим ботом.
Держите ТОКЕН в секрете, как пароль.
*
Токен вашего бота, выдается ботом конструктором https://t.me/BotFather, при введении в него команды:
/token
*
Вот как должен правильно выглядеть код, со всеми нужным отступами. Нарушение отступов, вызывает ошибку и не позволяет выполнить код!
*
Скачать исходный код данного примитивного Телеграм-бота, с необходимыми отступами в формате TXT-файла, можно по ссылке:
Вот как должен правильно выглядеть код, со всеми нужным отступами. Нарушение отступов, вызывает ошибку и не позволяет выполнить код!
НАЧАЛО КОДА.
import telebot
# токен бота
bot = telebot.TeleBot("сюда вставляем ТОКЕН ВАШЕГО БОТА")
@bot.message_handler(content_types=['text'])
def get_text_messages(message):
if message.text == "Привет":
bot.send_message(message.from_user.id, "Привет, чем я могу тебе помочь?")
elif message.text == "/help":
bot.send_message(message.from_user.id, "Напиши привет")
else:
bot.send_message(message.from_user.id, "Я не знаю такой команды. Напиши /help.")
bot.polling(none_stop=True, interval=0)
КОНЕЦ КОДА.
В созданной ранее папке Winkiway_bot, сохраняем весь этот код в файле формата PYТ.е в итоге файл должен называться как:Winkiway_bot.py
В созданной ранее папке Winkiway_bot, сохраняем весь этот код в файле формата PYТ.е в итоге файл должен называться как:Winkiway_bot.py
Зайдите в папку с вашим файлом, Winkiway_bot.py), и открываем его.
*
Откроется программа PyCharm Community Edition .
Разрешите ей создать проект со всеми полномочиями доступом в интернет/сеть.
*
В появившемся окне выбираем кнопку с надписью "OPEN IN PROJECT".
В следующем окне выбираем папку вашего проекта (в данном случае: папку Winkiway_bot), и нажимаем OK.
Далее появится окно TRUST PROJEKT, где нужно нажать на кнопку "TRUST PROJEKT".
В итоге, будет создан проект вашего бота Winkiway_bot, в программе PyCharm Community, при этом проект будет открыт на редактировании основного файла Winkiway_bot.py с главным кодом.
*
После запуcка проекта, нажмите на зеленую стрелочку с подсказкой RUN, чтобы приложение Telegram, могло выполнять код вашего бота у себя.
*
Рядом находится зеленая кнопка в виде круглой шестеренки, это кнопка DEBUG.
*
ЗАПУСК ВАШЕГО БОТА В ТЕЛЕГРАМ
*
В строке поиска Телеграм, вводим имя вашего бота, в данном случае
Winkiway_bot.
*
Нажимаем именно на этого бота Winkiway_bot.
*
Так же, этот бот, всегда доступен по ссылке https://t.me/Winkiway_bot, ели его запускать в браузерной версии Телеграм)
После нажатие на название бота Winkiway_bot, в всплывающем меню итогов поиска, в Телеграм в правой части телеграмма отобразиться интерфейс бота Winkiway_bot, с кнопкой START.
*
Запускаем сам бот Winkiway_bot, командой "/start", или нажимаем появившуюся кнопку START.
*
После нажатия кнопки "СТАРТ", появится строка ввода команд для бота Winkiway_bot
ВАЖНОЕ ПРИМЕЧАНИЕ:
*
Бот в Телеграм, очень чувствителен к регистру букв.
*
Т.к в коде программы (код в файле "Winkiway_bot.py"), слово "Привет" пишется с большой буквы, то бот распознает слово "Привет", только с большой буквы. И только тогда он сможет ответить фразой
-"Привет, чем я могу тебе помочь?"
*
Если в строку команд Телеграм-бота Winkiway_bot, слово "Привет", будет написано с маленькой буквы (привет), то Телеграм-бот распознает слово уже как другое слово, и уже как другую команду,
*
В итоге , тогда бот ответит фразой, которая заготовлена для всех остальных команд-слов за исключением слова "Привет" с большой буквы.:
"Я не знаю такой команды".
*
ВВОД КОМАНД В Телеграм-Бот Winkiway_bot, и реакция БОТА НА ЭТИ КОМАНДЫ.
*
Вводим слово "Привет", на что бот должен ответить
-"Привет, чем я могу тебе помочь?"
*
При введении другой фразы, бот должен ответить:
-"Я не знаю такой команды".