Основы создания Телеграм-бота на Python. Урок для начинающих/чайников. Изучаем среду разработки Python. Запустить код из Python в Телеграм⁠⁠

Основы создания телеграмм бота на 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-файла, можно по ссылке:
https://vk.com/doc-214311508_675564464?hash=dYryOBipjbYrTCHr...

НАЧАЛО КОДА.

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), и открываем его.

Откроется программа 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, и реакция БОТА НА ЭТИ КОМАНДЫ.

Вводим слово "Привет", на что бот должен ответить
-"Привет, чем я могу тебе помочь?"

При введении другой фразы, бот должен ответить:
-"Я не знаю такой команды"