Итак, могу поздравить вас с крещением. В этой статье мы начнём осваивать ботов "под капотом", то есть, учиться писать их с нуля. Начнём мы, как вы уже могли понять, с простейших команд со знаком /. Например, самым распространённым представителем является команда /start, которая используется почти в каждом боте.

Давайте же приступим, но перед этим ознакомимся с содержанием статьи:

Прежде, чем приступить к работе, нам понадобится установить некоторые приложения и библиотеки. Для начала скачиваем язык программирования Python. Версии 3.13 вам будет достаточно. Кто хочет, может поставить и повыше. Его установите самостоятельно и не забывайте обратить внимание на вашу операционную систему и её разрядность.

Затем нам понадобится компилятор. Советую поставить PyCharm или можете поставить VSCode. Тоже попрошу установить самостоятельно.

Курс будет вестись на PYCharm. Если есть желание, то можете работать на любом другом компиляторе.

Итак, скачали, открыли. Что делаем? Создаём проект, а дальше у нас будет несколько вариантов, как установить пакет необходимых библиотек. Либо вы через (верхний левый угол) File -> Settings ->Python Interpreter -> + и в строку поиска вбиваем python-telegram-bot -> Install Package.

Либо можете скачать через терминал. Для этого воспользуйтесь командой:

pip install python-telegram-bot --upgrade

Готово. Этого пока что достаточно. Другие библиотеки, которые мы будем использовать, в основном являются встроенными в язык.

Давайте рассмотрим базовые понятия в написании ботов. Для этого нам просто необходимо создать самого простейшего бота, который будет иметь всего три команды: /start, /help, /hello.

Процесс создания (чтобы не было проблем с понятностью кода) следует делить на составляющие:

P.S.: Я не хочу призывать вас делать, как я. Если вам удобнее писать иначе, пишите иначе. Я только за!

Вначале программы прописываются import-ы. Для первого бота нам понадобится рассмотреть несколько основных import-ов из библиотек. По большей части на них держится всё создание ботов. Давайте же их импортируем:

from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes

А теперь по порядку. Что есть что?

1. Update - специальная функция, которая будет принимать все действия от пользователя: нажатые кнопки, отправленные сообщения, картинки и подобное. Содержится в библиотеке telegram.
2. Application - можно сказать, что это "мозг" бота. Через этот объект бота мы и будем управлять всеми процессами. Даже запуск бота происходит через него. Далее все объекты будут из библиотеки telegram.ext.
3. CommandHandler - обработчик команд типа /start, а также то, с чем мы в основном и будем работать.
4. MessageHandler - обработчик обычных сообщений.
5. filters - набор фильтров, которые определяют, какие сообщения будут обрабатываться. Например, только картинки. В этот раз он нам не понадобится, но мы к нему подойдём вплотную.
6. ContextTypes - используется для настройки возвращаемых данных.

Далее пропишем наш API в виде переменно (так как использоваться он может несколько раз и это просто удобнее)

TOKEN = "Ваш API-токен, копируем из BotFather"

Некоторой небольшой традицией у программистов стало вывод строки "Hello, World!" в консоль. Давайте сделаем это в ботах, а заодно заложим шаблон для дальнейшей работы с ботом.

Начнём с функции /start. Обычно в ней выводят либо приветствие, либо основные сведения о боте. Так как мы уже сделали оформление нашего бота в прошлом эпизоде, то заставим нашего бота выводить просто приветствие. Для этого пропишем следующий код:

async def start(update: Update, context:ContextTypes.DEFAULT_TYPE):    
      await update.message.reply_text("Привет! Я твой первый бот 🤖\nНапиши /help, чтобы узнать команды.")

Теперь немного остановимся на коде. async def - это асинхронная функция, которая вызывается сама по себе, чтобы исполнить определённое действие. То есть, её не нужно дополнительно вызывать. В данном случае она ожидает сообщения /start от пользователя.

update: Update, context:ContextTypes.DEFAULT_TYPE - указывается у любых команд, которые будут работать напрямую с пользователем. Это, можно сказать, основа функций бота. Update будет принимать всё от пользователя, context же наоборот будет хранить особые функции, чтобы обработать эти сообщения.

await - это способ дождаться выполнения асинхронной операции (update.message.reply_text("Привет! Я твой первый бот 🤖\nНапиши /help, чтобы узнать команды.")

message.reply_text - функция, чтобы сообщением отправить ответ пользователю (именно сообщения в качестве ответа, а ни как-то иначе, что в данном контексте будет правильнее).

Теперь пропишем оставшиеся функции. Их код очень похож на функцию \start

Функция /help. Обычно она отвечает за показ всех команд, которые используются в боте. Её код будет следующим:

async def help(update: Update, context:ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Список команд бота:\n/start - перезапуск бота\n/help - выводит "
                                        "список команд\n/hello - выводит самый простейши код бота")

Функция /hello. Её цель просто вывести пользователю сообщение "Hello, World!". Рассмотрим и её код:

async def hello(update: Update, context:ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("HELLO, WORLD!!!!!!!!!!!!!!!!")

Далее нам понадобится где-то указать, что именно после команды /start у нас будет срабатывать функция start. Для этого нам понадобится базовая функция языка программирования main. Код почти полной функции будет следующим:

def main():
    app = Application.builder().token(TOKEN).build()
    
    app.add_handler(CommandHandler("start", start))    
    app.add_handler(CommandHandler("help", help))    
    app.add_handler(CommandHandler("hello", hello))

Тут уже дам следующий комментарий.

app = Application.builder().token(TOKEN).build(), где происходит вот что:

Application.builder() - создаёт “строитель” бота (builder)

.token(TOKEN) - передаёт токен твоего бота (мы его писали ранее)

.build() - собирает готовое приложение (объект бота)

По сути, это команда: "Создай бота и подключи его к Telegram API".

Затем происходит регистрация команд. Бот выстраивает среду команд: /start, /help и /hello. Мы даём ему понять через CommandHandler, что это будет команда (со знаком /), а также название команды, а затем передаём функцию, к которой мы обратимся после принятия этой команды.

Мы продолжаем находиться во всё той же функции main. Остался последний штрих: запустить бота. Но перед этим укажу ещё одну фишку.

Как себя контролировать? Вы точно уверены, что ваш код работает корректно? Тогда перед запуском либо функции, либо всего бота пропишите строчку:

print("Бот запущен...")

Эта строчка выведет вам в консоль, что всё хорошо. Это лёгкий способ, далее мы посмотрим более точный.

Теперь давайте же запустим бота:

app.run_polling()

Но, если мы попробуем запустить, будет не совсем корректно. Далее, уже после функции main() нам нужно прописать следующую команду:

if __name__ == "__main__":
    main()

Зачем она нужна? По сути она сигнализирует о запуске бота напрямую. А если точнее, то у неё следующие функции:

1. предотвращает автозапуск кода при импорте;
2. позволяет запускать бота только намеренно;
3. делает код чище, правильнее и модульнее.

Теперь публикую полный код, который мы написали с комментариями, чтобы вам было легче разобраться и запомнить:

from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes #импорт необходимых библиотек
TOKEN = "ВАШ ТОКЕН" #ваш токен
async def start(update: Update, context:ContextTypes.DEFAULT_TYPE): #функция для команды /start    
    await update.message.reply_text("Привет! Я твой первый бот 🤖\nНапиши /help, чтобы узнать команды.")
async def help(update: Update, context:ContextTypes.DEFAULT_TYPE): #функция для команды /help
    await update.message.reply_text("Список команд бота:\n/start - перезапуск бота\n/help - выводит "
                                          "список команд\n/hello - выводит самый простейши код бота")
async def hello(update: Update, context:ContextTypes.DEFAULT_TYPE): #функция для команды /hello
    await update.message.reply_text("HELLO, WORLD!!!!!!!!!!!!!!!!")
def main(): #функция для общей обработки и сборки бота
     app = Application.builder().token(TOKEN).build() #основная переменная сбрки (основа - ваш API)    
     app.add_handler(CommandHandler("start", start))  #обработка каждой  команды    
     app.add_handler(CommandHandler("help", help))    
     app.add_handler(CommandHandler("hello", hello))    
     
     print("Бот запущен...") #сигнал, что бот запущен    
     app.run_polling() #запуск бота 
if __name__ == "__main__": #проверка, что запущен напрямую
     main()

Теперь полюбуемся нашим результатом:

Также посмотрим, что наш сигнал сработал:

Итог будет разделяться на несколько этапов. Вначале намекну на следующее занятие.

Итак, мы подошли вплотную к моменту, а что если пользователь будет отправлять не то, что мы задумывали? Например, вместо команд скинет картинку или скинет неизвестную команду. Это может вызвать ошибку и экстренно завершить работу бота.

Что же с этим делать? Узнаете на следующем занятии, но советую прочитать про фильтры. Всю официальную информацию по библиотеке можно найти в их руководстве: https://docs.python-telegram-bot.org/en/stable/index.html.

Да, теперь с этого момента у нас будет дз, так как, чтобы научиться программировать, необходимо получать опыт. Дз мы будем разбирать в спец выпуске, который будет выходить тут же, так что, не переживайте.

Сегодня вам следующие задания:

На сегодня достаточно.

Итак, начинающий программист, поздравляю тебя с первыми успехами в написании ботов. Дальше будет интереснее, главное продолжать работать)

В целом, это довольно просто. Библиотека включает в себя в районе 100 самых часто используемых программ. Всё остальное используется редко.

Ботов можно отлично монетизировать, так что, дерзайте)

А с вами была Территория СВПиД и её ведущий, S. Успехов вам и всем до встречи, не прощаюсь)

Сегодня разговор поёдет об основных функциях BotFather помимо получения API токена. А теперь перейдем к конкретике. Сегодня вы научитесь:

1. Делать дизайн (оформление для своего бота);
2. Настраивать бота.

Соответственно, на основе этих целей мы и строим содержание этой статьи.

Charles Eames, Designer

Зачем нам вообще необходим дизайн?

Дизайн в Telegram-боте - это не «красота ради красоты». Он влияет на удобство, понимание, скорость действий пользователя и эффективность бота. Вот зачем он нужен:

• Удобство и скорость взаимодействия (хорошо продуманные кнопки, меню и структура позволяют пользователю быстро находить нужные функции.
  Без дизайна человек может запутаться, нажать не туда или вообще подумать, что бот “сломан”);
• Повышение доверия (Аккуратные кнопки, иконки, внятные тексты и логичная навигация создают ощущение, что бот сделан профессионально - это повышает доверие к продукту или бренду);
• Снижение нагрузки на поддержку (если человек всё понимает с первого раза, он меньше задаёт вопросов);
• Увеличение вовлечённости (красивые карточки, удобные формы, продуманная механика → пользователь дольше остаётся в боте, чаще возвращается, быстрее выполняет нужные действия);
• Понятные сценарии для пользователя (дизайн - это не только кнопки, но и: структура диалогов, названия пунктов меню, последовательность вопросов, подача информации. Хороший сценарий экономит десятки лишних шагов);
• Унификация (если у бота есть единый стиль (картинки, формулировки, структура), пользователь интуитивно понимает, как с ним работать - даже если функционал расширяется);
• Конверсия (для коммерческих ботов (заказы, бронь, продажи) дизайн влияет на число завершённых действий. Удобный, прозрачный интерфейс = больше заказов/лидов).

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

Для этого вновь открываем BotFather и пишем /start:

Далее выбираем команду /mybots, а затем выбираем нужного бота:

После всех выборов перед вами появится окно с Inline-кнопками (да, их тоже мы научимся делать):

Теперь поговорим о каждой кнопке:

1. API Token - позволяет увидеть токен вашего бота и в случае необходимости изменить его:

Если нажать Revoke current token, то BotFather создаст вам новый токен:

Далее вернёмся в другим кнопкам (с помощью кнопки Back to Bot).

2. EditBot - здесь мы в основном и будем работать над дизайном ботов:

Перед вами появилось следующее окно. Давайте разберёмся, что делает каждая из кнопок:

1) Edit Name - позволяет поменять имя бота:

Также оно поменяться и здесь (это касается всех кнопок: по мере оформления это окно будет заполняться):

2) Edit About - позволяет задать описание бота. Обычно сюда указывают предназначение бота и способы обратиться к создателю бота. Я укажу только первое:

Этот текст будет виден здесь:

3) Bot Description - добавляет на задний фон в момент открытия бота табличку, где будут написаны основные функции бота (что он может делать?). Можно указать и что-то другое, но обычно указывают следующее:

Увидеть его можно здесь:

4) Edit Description Picture поможет вам прикрепить картинку к табличке описания из прошлой кнопки. Оптимальные размеры 640 на 360. Вот как это будет выглядеть:

Про остальные ограничения мы поговорим позже в статье. А сейчас посмотрим на результат:

5) Edit Botpic - кнопка для создания Botpic. Что это? Так называется лого бота. Оно должно быть размером 150 на 150 пикселей. Загрузим его:

И посмотрим на результат:

6) Edit Commands. Эта кнопка позволит создать меню со списком команд, которые будут особыми. Например, \star - запуск бота, \register - пройти регистрацию, а также другие. Ввод происходит следующим образом:

команда 1 - описание 1

команда 2 - описание 2

Команды будут появляется здесь:

Чтобы такое окно появилось, нужно будет нажать кнопочку Меню в левом нижнем углу:

7) Edit Privacy Policy. Эта кнопка поможет вам поставить свою политику конфиденциальности для бота. Обычно она используется для установления определённых правил использования бота, например, Телеграмм может посмотреть данные бота в случае необходимости. Через эту кнопку вы можете поставить свою политику конфиденциальности:

Я этого делать не буду, оставлю стандартную. Пойдём далее.

Вернёмся в основное меню (Back to Bot). Следующей кнопкой, которую мы посмотрим будет Bot Settings:

Здесь есть:

1) Inline Mode - особый режим, который позволит работать вашему боту в любом чате. Почитать можно здесь. В своём курсе (по крайней мере пока что) я не планирую рассматривать эту функцию.

2) Business Mode - особый режим, который позволит вам давать разрешение на подключение вашего бота другими пользователями. То есть, вашего бота смогут использовать в группе (изменив), например, за определённую плату. Почитать об этом режиме подробнее можно здесь.

3) Allow groups? - тоже режим, позволяющий подключать вашего бота куда-либо. Например, в каналы или группы. Также, здесь будут высвечиваться все группы, куда будет подключён ваш бот.

4) Group Privacy - режим конфиденциальности групп для бота. О нём можете почитать здесь.

5) Group Admin Rights - здесь сможете настроить доступные права для людей, которые будут добавлять вашего бота в группы (например, запретить отправлять боту картинки и так далее).

6) Channel Admin Rights - то же, что и с группами, но для каналов.

7) Payments - кнопка, которая позволит вам подключить способы оплаты за использование услуг бота. Выглядит это следующим образом:

8) Menu Button - кнопка, позволяющая сделать меню бота в виде сайта. Значительно расширяет возможности создания меню.

9) Configure Mini App - эта кнопка позволит вам подключить мини приложение к боту.

10) Paid Broadcast - кнопка, позволяющая настраивать вещание. Например, если вам необходимо скинуть всем пользователям вашего тгк какую-нибудь информацию. Подробнее можете почитать здесь.

Мы идём далее. Остались ещё несколько аспектов, которые мы рассмотрим в этой статье.

Вернёмся в меню и посмотрим на последние три кнопки.

Payments - ранее уже встречалось. Здесь вы можете подключить оплату для вашего бота. Кто-то захотел использовать вашего бота? Вы получили деньги. Всё просто. Выглядит это так:

Следующие две кнопки являются особа опасными, поэтому будьте с ними предельно осторожны.

Transfer Ownership - кнопка, которая позволит вам передать права владения вашим ботом другому пользователю.

Delete Bot - удалит вашего бота НАВСЕГДА. Будьте аккуратны с этими кнопками.

Основные ограничения (лимиты) следующие:

Некоторые лимиты можно расширить с помощью платных подписок. Также об ограничениях можете почитать тут.

Также оставлю вам один неплохой сайт, где вы сможете найти бесплатные статьи о работе с телеграмм ботами (именно настройке). Ссылочка: https://zabotov.ru/blog.

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

С вами был S, вы находились на территории СВПиД. Подписывайтесь, до встречи)

Приветствую всех, вы попали на территорию СВПиД. Сегодня ваш ведущий S.

Сегодня поговорим о работе с BotFather, боте, с помощью которого вы сможете создать своих ботов и получить свой собственный API. Для начала пробежимся по содержанию статьи и рассмотрим самые важные вопросы.

Русифицируем термин API (Application Programming Interface) — интерфейс прикладного программирования.

API (Application Programming Interface) в контексте Telegram-бота — это набор методов, с помощью которых бот получает и отправляет данные, выполняет команды и взаимодействует с пользователями.Telegram для разработки ботов используется Telegram Bot API — HTTP-интерфейс, созданный для управления ботами.

Таким образом, API необходим для автоматизации различных задач: обработки сообщений, авто-ответа на сообщения и других. API — это переводчик с человеческого языка на язык, понятный боту.

Всё об API можете почитать здесь. Мы же пойдём дальше.

Ответ на первый вопрос лежит в вопросе заголовка. Откуда же взять API? Конечно же из BotFather. Чтобы получить API, переходим по ссылочке: https://t.me/BotFather.

Этот телеграмм-бот и называется BotFather ("Отец ботов" - на русский лад). Но, как мы увидим в дальнейшем, с помощью этого бота можно создавать не только ботов, но и интерактивные веб-приложения и игры. Эти функции в данном курсе мы рассматривать не будем, но, если вы проявите желание в познании этой области, то я сделаю курс на эту тематику.

Переходим по ссылке в этого телеграмм-бота. Затем пишем /start (начало) (обычно это происходит автоматически). Вам "вылезет" следующий ответ:

Затем нам понадобится создать нового бота, так что, пишем команду /newbot (новый бот). Придумайте ему любое название. Я введу для примера MyNewBot (мой новый бот):

Теперь вам предстоит создать username. Что это? Имя, которое будет отображаться в строке при поиске. Подобное есть и у самого BotFather (@BotFather). Я их называю "ака".

"Ака" подчиняется одному правилу: она обязательно должна заканчиваться на bot (бот).

Создадим и для нашего бота:

После указания "аки" вы сможете найти бота в поиске (можете найти в том числе моего), ведь ваш новый бот создан:

А теперь вернёмся к картинке выше. Когда мы создали бота, BotFather отправил нам новое сообщение, где есть такая строка: "Use this token to access the HTTP API:". После этого сообщения идет код, который связан с API. Это его токен (номер, код). Это означает, что вы создали свой собственный API.

Введём ещё одно правило: API ни в коем случае нельзя распространять.

Поздравляю! Это уже второй ваш шаг к получению умения создания ботов.

В BotFather есть ещё множество функций, о которых мы поговорим в следующей статье. Например, я научу вас создавать описание вашего бота, лого и другому. Также мы посмотрим на иные функции, которые предложит нам "Отец ботов".

Всем спасибо за прочтение данной статьи. Желаю вам дальнейших успехов в изучении ботов!

А я не прощаюсь, ваш S.

Thinking about the bot as a frontend representative of your product or service can make a lot of sense, and having a delightful bot that provides a useful service can generate strong attachment to your brand.

Amir Shevat. Designing Bots: Creating Conversational Experiences

Аудио-подкаст к статье здесь.

Приветствую всех. Вы попали на территорию СВПиД. Что это? Это "территория свободного взаимодействия программистов и дизайнеров". Сегодня ваш ведущий: S.

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

Итак, пробежимся по содержанию статьи. Сегодня мы поговорим о:

Что за курс статей?

Данный курс статей, как и сказано ранее, будет посещён телеграмм ботам, но это широкое определение. Перейдём к более узкому. Пройдя этот курс вы:

• Получите понимание о телеграмм-ботах
• Научитесь их создавать
• Получите много практики по написанию телеграмм-ботов
• Получите несколько реальных проектов для своего портфолио

Курс будет основан на языке Python с использованием библиотеки python-telegram-bot.

Особое внимание обратим на то, что этот курс рассчитан на то, что читатель уже будет знать язы программирования на этом языке. Если же нет, поговорим об этом в статье далее.

Перед тем, как ознакомиться с этой серией статей задайтесь вопросом: "А зачем мне нужно уметь делать ботов?"

Существует несколько ответов на данный вопрос в зависимости от того, откуда растут руки? Рассмотрим несколько примеров:

1. Если вы бизнесмен или маркетолог, вам скорее всего необходимо постоянно общаться с клиентами. Но клиенты очень часто любят задавать похожие вопросы. Например, какая цена вашей услуги? В чём вы можете помочь? Какой у вас опыт? А также множество других вопросов. Всё это можно автоматизировать с помощью ботов;
2. Если вы занимаетесь сбором каких-то данных, то очень часто этот процесс организуется с помощью тестов. С помощью тг-ботов очень просто сделать тест и организовать базу данных с его результатами;
3. Распространение своего продукта. Представим, что вы занимаетесь продажей курсов для подготовки к тому же ЕГЭ. Неплохо бы было сделать какой-нибудь сервис, который мог бы за несколько минут дать возможность любому человеку записаться на ваш курс перед этим заплатив "денежку". Поздравляю, тг-бот для этого отлично подойдёт. Многие люди так делают, и это действительно показывает высокую эффективность;

Таких примеров ещё очень много, но основной смысл понятен: тг-боты могут облегчить многие процессы.

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

Я же, в свою очередь, постараюсь поддерживать и сопровождать вас в течении всего пути обучения. Поэтому заранее оставлю свои контакты. Основной контакты - это наш телеграмм-канал. Также можете писать мне лично.

Во-вторых, для освоения курса вам понадобятся некоторые знания языка Python. Этот цикл статей имеет немного другую цель, поэтому, если вы не знаете основ языка Python, советую ознакомиться с ним. Разумеется, дорогой читатель, я подготовил для тебя несколько ссылок, которые смогут облегчить самостоятельное изучение:

В третьих, свободный botAPI. Я покажу, где его достать в дальнейшем.

Вот, собственно, всё, что нам понадобится.

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

Список скорее всего будет меняться, но, в целом, структура останется +- такой же.

Поздравляю, вы дочитали до конца. Курс будет действительно интересным и увлекательным. Тем, кто хотел бы начать в IT он тоже подойдёт, так как не включает в себя таких сложный и премудрых веще, но при здесь будут обсуждаться не такие базовые темы, как основы того или иного языка программирования.

У вас обязательно всё получится, уж тем более с моей помощью! Желаю успехов и удачи! Ваш S.