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

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

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

Кусок кода (там, где "погрызено" - функции, которые не используются и не влияют на чтение; отступы маленько засрались). save_txt в JSONе равен True.

import json

import os

data_path=('/content/gdrive/MyDrive/sd/stable-diffusion-webui')

config_filename = os.path.join(data_path, 'config.json')

config_path = os.path.dirname(config_filename)

assert os.path.exists(config_path), "Config path not exist!"

assert os.path.isfile(config_filename), "Config file not exist!"

print(config_filename)

class OptionInfo:

def __init__(self, default=None, label="", component=None, component_args=None, onchange=None, section=None, refresh=None):

self.default = default

self.label = label

self.component = component

self.component_args = component_args

self.onchange = onchange

self.section = section

self.refresh = refresh

def options_section(section_identifier, options_dict):

for k, v in options_dict.items():

v.section = section_identifier

return options_dict

options_templates = {}

options_templates.update(options_section(('saving-images', "Saving images/grids"), {

"save_txt": OptionInfo(False, "Create a text file next to every image with generation parameters."),

}))

options_templates.update()

print(options_templates.items());

class Options:

data = {}

data_labels = options_templates

typemap = {int: float}

def __init__(self):

""" self.data = {k: v.default for k, v in self.data_labels.items()} """

for k, v in self.data_labels.items():

self.data.setdefault(k, v.default)

print("self.data.items()")

print(self.data.items())

def __getattr__(self, item):

if self.data is not None:

if item in self.data:

return self.data[item]

if item in self.data_labels:

return self.data_labels[item].default
return False

... погрызено ...

def load(self, filename):

print(filename)

with open(filename, "r", encoding="utf8") as file:

self.data = json.load(file)

print("self.data.items() after json.load(file)") 

print(self.data.items())

... погрызено ...

opts = Options()

if os.path.exists(config_filename):

opts.load(config_filename)

print(opts.save_txt)

И вывод (переводы строки добавлены для ясности):

/content/gdrive/MyDrive/sd/stable-diffusion-webui/config.json

dict_items([('save_txt', <__main__.OptionInfo object at 0x7f7cb44ee6a0>)])

self.data.items()

dict_items([('save_txt', False)])

/content/gdrive/MyDrive/sd/stable-diffusion-webui/config.json

self.data.items() after json.load(file)

dict_items([('save_txt', False)])

False

Примечания.

1) Закомментированная строчка

self.data = {k: v.default for k, v in self.data_labels.items()}

по какой-то причине не делает в моем коде ничего; хотя в оригинальном, очевидно, работает.

2) Также в оригинале стоит не data = {}, а data = None - но у меня что-то так тоже не отработало, эмпирически решил инициализировать как пустой dict.

3) Да, не все лишнее выковыряно, в частности - не нужные вне ВЕБ-интерфейса секции, но причина вряд ли в этом.

4) Первая мысль проверить, что читается что-то не то - но файл /content/gdrive/MyDrive/sd/stable-diffusion-webui/config.json 100% существует, и содержит много ключиков; выставленные в начале ассерты тоже проходятся бз ошибок.

5) Но на выходе после self.data = json.load(file) получаем то же самое, что на входе.

6) Если не инициализировать self.data в _init__(self), то на выходе после json.load(file) будет просто пусто и выдастся ошибка.

Какая может быть причина такой печали, что еще можно покрутить? Фантазии уже нет.

Ссылочки на меня:

https://zen.yandex.ru/id/vrom1990

https://t.me/vrom1990pb

https://pikabu.ru/@vrom1990

https://archive.org/details/python-tupyh

https://vk.com/vrom1990pb

https://www.youtube.com/c/ВячеславРоманьков