Telegram-бот на Python с нуля: от идеи до первого сообщения

Несложно догадаться, что слово «бот» — это сокращение от «робот». То есть Telegram-бот — это робот, которого вы можете создать и «поселить» прямо в устройствах пользователей мессенджера. Тогда в зависимости от ваших пожеланий он будет делиться с ними контентом, помогать в проведении торговых и финансовых операций или решении бытовых задач, например при заказе еды или выборе подходящего сеанса в ближайшем кинотеатре. 

Сегодня для создания Telegram-ботов уже не нужно изобретать велосипед: чтобы максимально упростить разработку чаще всего используются готовые библиотеки и фреймворки. Однако стоит знать, что в основе любого из этих инструментов лежит бот API — нативный интерфейс от создателей мессенджера, например, Telegram API.

Зачем вам бот: цели и задачи

Telegram-бот — это рабочий инструмент. Но работать на пользу бизнеса или проекта он будет только в том случае, если научить его решать те задачи, которые актуальны для ваших пользователей и сотрудников. 

Цели бизнеса при создании ботов могут быть разными, например:

• Увеличение продаж. С помощью ботов удобно запускать маркетинговые кампании и собирать контактную информацию пользователей. 

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

• Улучшение клиентского сервиса и имиджа компании. Быстро реагировать на запросы пользователей и помогать им в решении задач? Запросто! С Telegram-ботом, умеющим отвечать на часто задаваемые вопросы или предоставлять подробную информацию об услугах и продуктах по запросу. А с помощью сервиса Evolution Managed RAG бота можно научить использовать в ответах пользователям документацию вашего проекта.

Перед тем, как начать работу над созданием бота, его нужно зарегистрировать — сформировать API-токен. Давайте разберемся, как это делается. 

Создание нового бота через BotFather

Чтобы зарегистрировать нового бота, действуйте пошагово: 

• Зайдите в телеграм, найдите «отца» всех ботов, введя в поисковой строке мессенджера @BotFather, и перейдите к нему.

• Нажмите Start в верхней части окна. 

• Выберите команду /newbot.

• Придумайте имя и юзернейм для бота — при желании их можно дублировать.

Бот создан! Обязательно сохраните полученный API-токен, чтобы использовать его для авторизации и дальнейшей работы с ботом. 

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

• Есть сам язык Python: скачать подходящую версию можно на сайте разработчика. Самая актуальная версия на август 2025 — Python 3.13.

• Установлена среда разработки для Python, например это может быть PyCharm, Visual Studio или Spyder. 

Также нужно выбрать одну из библиотек, о которых мы говорили выше. В этой статье в качестве примера будем применять руTelegramBotAPI. Чтобы начать ее использовать в терминале Linux, введите: 

В командной строке Windows: 

А в терминале на Mac: 

Создание виртуального окружения

Перед началом работы с ботом рекомендуется создать виртуальное окружение venv (или virtualenv для более ранних версий Python) — с его помощью удастся изолировать проект, соорудив для него так называемую песочницу. В ней будет удобно запускать приложение вместе со всеми зависимостями, не влияя на другое запущенное в среде ПО. 

Venv на Windows

На Windows специально устанавливать venv не придется — оно является частью стандартной библиотеки Python 3 и поставляется вместе с интерпретатором. Для активации утилиты в этой операционной системе введите в командной строке: 

А после активируйте виртуальную среду с помощью скрипта: 

Venv на Linux

Чтобы создать виртуальное окружение venv на Linux, действуйте следующим образом: 

• Сперва используйте команду, чтобы установить venv: 

• Затем установите дополнительные пакеты Python, чтобы гарантированно избежать ошибок при сборке: 

• Запустите venv с помощью команды: 

• Активируйте окружение: 

Venv на macOS

Чтобы активировать виртуальное окружение venv на maсOS также примените команду python3 -m venv venv, а после активируйте ее с source venv/bin/activate. 

Теперь все готово, чтобы начать работу по запуску Telegram-бота. 

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

Далее объявите получателя сообщений бота и определите тип контента, на который он будет реагировать. 

Кстати, значение content_types можно изменить или расширить. Например, написав: 

Теперь самое время добавить боту функциональности, чтобы в ответ на «Привет», он отвечал «Привет, что я могу для тебя сделать?». Для этого добавьте команду: 

Чтобы все заработало, вбейте: 

По команде выше бот будет постоянно делать запрос на сервер Telegram, чтобы оперативно ответить, если ему кто-нибудь напишет. 

В финале сохраните файл и добавьте в консоль команду, где «bot» — имя бота: 

Создание простого эхо-бота

Чтобы еще немного потренироваться в написании кода для Telegram-бота, попробуйте создать эхо-бота — он будет «передразнивать» пользователя, отвечая на сообщения его же словами. Сделайте такого, добавив несколько простых команд: 

Теперь при общении с ботом вы будете наблюдать такую картину: 

Если вам недостаточно того, что написанный бот умеет лишь получать и отправлять текстовые сообщения, его функциональность можно расширить.

Добавление логики обработки сообщений

Первым делом попробуйте с помощью бота побольше узнать про пользователя, с которым он общается. Чтобы узнать его имя, фамилию и возраст, добавьте: 

Использование кнопок

А чтобы уточнить полученную информацию, добавив кнопки Да и Нет, измените блок кода get_age следующим образом:

Далее, чтобы кнопки Да и Нет стали кликабельными в чате с ботом, впишите метод-обработчик: 

И подытожьте работу с помощью команды: 

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

Чтобы запуск бота прошел гладко, протестировать его работу можно на локальном сервере. 

Запуск бота на локальном сервере

Запустите скрипт на своем компьютере — бот будет получать сообщения через long-polling. Проверьте все сценарии: команды, кнопки, обработку разных типов сообщений. Это поможет найти ошибки и оценить стабильность работы без риска для пользователей.

Основные ошибки и их отладка

Вот ошибки, которые чаще всего встречаются при работе с ботами в Telegram: 

• Бот не отвечает — проверьте интернет-соединение и наличие bot.polling() в коде.

• Ошибка аутентификации — убедитесь в том, что добавили корректный токен.

• Падение скрипта — добавьте логирование скрипта и обработку исключений с помощью команды:

Захостить — то есть разместить Telegram-бота на сервере так, чтобы он был доступен в сети — можно тремя способами: на виртуальном сервере (VPS/VDS), в облаке или с помощью специализированного сервиса, например Repl.it, Heroku, Netlify. О первых двух вариантах поговорим немного подробнее.

Хостинг бота на виртуальном сервере и в облаке

VPS/VDS. Чтобы выполнить деплой бота на виртуальном сервере, нужно действовать пошагово: 

• Сперва выберите VPS-провайдера и арендуйте виртуальный сервер — определитесь с его операционной системой и настройте подходящие конфигурации: процессор, память, пространство на диске. 

• Подключитесь к серверу по SSH и установите на него все необходимые пакеты: Python, менеджер пакетов pip и библиотеку для работы с Telegram API. Затем создайте виртуальное окружение для изолированной работы зависимостей бота. 

• Через панель управления VPS загрузите на сервер файлы бота. 

Облако. Разместить Telegram-бота в облаке тоже не составит труда. Например, на платформе Cloud.ru Evolution для этого нужно сперва построить Docker-контейнер и настроить его для работы с Telegram API, а затем запустить бота на виртуальной машине в облаке. Попробуйте сами с помощью нашей пошаговой инструкции, а также небольшого и понятного видео: 

Безопасность и лучшие практики

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

• Берегите API-токен бота. Не передавайте токен в открытых чатах и файлах, а также не храните в коде. А еще ограничьте доступ к серверу, на котором развернут бот. 

• Фильтруйте поток входящих данных. Чтобы защитить бота от взлома, валидируйте входные данные, ограничивайте число запросов и используйте антиспам-фильтры. 

• Защищайте вебхуки — коллбеки, которые позволяют боту автоматически получать обновления с сервера Telegram. Ограничьте для них список IP-адресов, от которых принимаются запросы, а также шифруйте трафик и используйте секретные пути, а не стандартные URL. 

• Ограничьте права доступа бота. Например, не давайте ему прав на удаление клиентских записей.

• Не забывайте про обновление библиотек и модулей бота. А также настройте мониторинг и логирование. 

Создание Telegram-бота на Python — это простой и эффективный способ автоматизировать общение с пользователями, улучшить клиентский сервис или даже увеличить продажи. В этой статье мы разобрали основные шаги: от регистрации бота через @BotFather и настройки среды разработки до написания кода и размещения бота в продакшене.

Теперь вы знаете, как создать своего Telegram-бота и провести его первоначальную настройку. В дальнейшем такого бота можно развивать, добавляя ему новые функции: подключать платежные системы, базы данных или AI-инструменты, например, RAG-сервис Evolution Managed RAG, с помощью которого бот будет отвечать на вопросы на основе загруженных данных.