Регистрация бота и получение API токена через BotFather
Начинать нужно с официального инструмента. В Telegram есть специальный бот, который управляет созданием других ботов. Он называется BotFather. Его легко найти в поиске Telegram. Это единственный официальный способ получить доступ к API. Не нужно пользоваться сторонними сервисами, которые обещают создать бота «в один клик» за деньги. Все делается бесплатно и напрямую через интерфейс мессенджера.
Когда вы найдете BotFather, нажмите кнопку «Запустить» или введите команду /start. Появится список команд. Нас интересует команда /newbot. Введите её. Система попросит придумать имя. Это то, как бот будет отображаться в списке контактов. Можно написать любое имя на русском или английском. Главное, чтобы оно было понятным пользователям.
После названия нужно придумать уникальный юзернейм. Он обязательно должен заканчиваться на слово «bot». Например, my_super_shop_bot или news_daily_bot. Система проверит, свободен ли этот адрес. Если кто-то уже занял такое имя, придется придумать другое. Это адрес, по которому люди будут находить вашего бота в поиске.
Если юзернейм свободен, BotFather пришлет длинный код. Это API токен. Его нужно скопировать и сохранить в безопасном месте. Токен — это ключ доступа к вашему боту. С его помощью программа отправляет команды от имени бота. Никому не передавайте этот токен. Если он попадет в чужие руки, злоумышленники смогут управлять вашим ботом. В случае утечки токен можно отозвать в BotFather и сгенерировать новый.
В BotFather также можно настроить другие параметры. Там меняется описание бота, аватарка и список команд, которые появляются в меню. Это важно для UX. Если бот имеет сложную функциональность, стоит прописать команды вроде /start, /help, /settings. Это поможет пользователям быстрее ориентироваться. Не пренебрегайте этим шагом, даже если бот кажется простым.
Обратите внимание на настройку «Приватность». В BotFather можно включить или выключить режим приватности. По умолчанию он включен. Это значит, что бот не будет видеть сообщения в группах, если его не упомянут по имени или не ответить на его сообщение. Для большинства личных ботов это нормально. Но если вы делаете бота для работы в чатах, эту функцию нужно отключить. Тогда бот сможет читать все сообщения в группе и реагировать на них.
Также сразу стоит добавить картинку. Бот без аватарки выглядит подозрительно и неопрятно. Загрузите логотип или понятную иконку. Заполните поле «О боте». Коротко расскажите, что он делает и зачем ему нужны права доступа. Эти простые настройки повышают доверие пользователей.
Для создания бота лучше всего подходит язык Python. Он простой, читаемый и имеет огромную библиотеку готовых решений. Вам не нужно писать запросы к API с нуля. Есть обертки, которые делают всю грязную работу за вас. Самые популярные библиотеки — pyTelegramBotAPI (Telebot) и Aiogram. Telebot проще для новичков. Aiogram мощнее и быстрее, но требует понимания асинхронности. Начнем с Telebot, чтобы понять принципы.
Сначала нужно установить Python на компьютер. Скачайте установщик с официального сайта. При установке обязательно поставьте галочку «Add Python to PATH». Это нужно, чтобы система могла найти питон из командной строки. После установки откройте терминал или командную строку. Создайте папку для проекта. В ней создайте виртуальное окружение. Это хорошая практика, чтобы библиотеки разных проектов не мешали друг другу. Команда для создания окружения: python -m venv venv. Затем его нужно активировать.
Написание кода и запуск бота на Python
Далее установим библиотеку. Команда простая: pip install pyTelegramBotAPI. После этого можно создавать файл с кодом. Назовите его main.py. Откройте в любом редакторе кода. VS Code или PyCharm подойдут отлично. Начнем с импорта библиотеки и создания экземпляра бота. Вам понадобится тот самый токен, который вы получили от BotFather.
В коде это выглядит так: import telebot; bot = telebot.TeleBot(‘ВАШ_ТОКЕН’). Теперь бот создан в памяти, но он ничего не делает. Нужно научить его отвечать на сообщения. В библиотеке Telebot используются декораторы. Это специальные конструкции, которые говорят программе: «если пришло такое-то сообщение, выполни эту функцию». Самая базовая функция — ответ на текст «Привет».
Напишем обработчик. @bot.message_handler(commands=[‘start’]) def start_message(message): bot.send_message(message.chat.id, ‘Привет! Я бот.’). Это простейшая команда. Когда пользователь напишет /start, бот ответит приветствием. Важно понимать, что у каждого пользователя есть свой уникальный chat.id. Бот должен знать, кому отвечать. Объект message хранит всю информацию о входящем сообщении, включая id чата.
Добавим бесконечный цикл опроса серверов. В самом конце файла нужно написать bot.polling(). Эта команда заставляет программу постоянно спрашивать сервер Telegram: «Есть ли для меня новые сообщения?». Если сообщения есть, программа перенаправляет их в нужные функции. Без этой строки бот запустится и сразу выключится.
Теперь можно запустить файл. В терминале пишем python main.py. Если нет ошибок, бот начнет работать. Напишите ему в личку /start. Если ответ пришел — поздравляю, вы написали своего первого бота. Если бот не отвечает, проверьте токен и подключение к интернету. Частая ошибка — опечатка в токене или забытая кавычка в коде.
Для усложнения логики можно добавлять условия. Python позволяет использовать стандартные if/else. Например, вы можете проверить текст сообщения и выдать разный ответ. if message.text == ‘Как дела?’: bot.send_message(message.chat.id, ‘Все отлично!’). Это основы диалоговой логики. Так создаются простые викторины или справочные боты.
Не забывайте про обработку ошибок. Если в функции произойдет сбой, бот может остановиться. Чтобы этого избежать, оборачивайте код в блоки try…except. Это позволит перехватить ошибку, записать её в лог и продолжить работу, не выключаясь целиком. Надежность важна, когда бот работает на сервере 24/7.
Текст — это хорошо, но интерактив лучше. В Telegram есть мощный инструмент — кнопки. Они бывают двух видов: обычные (ReplyKeyboardMarkup) и инлайн-кнопки (InlineKeyboardMarkup). Обычные кнопки появляются прямо на клавиатуре пользователя вместо стандартной набора алфавита. Инлайн-кнопки прикрепляются к сообщению и часто используются для ссылок или действий внутри бота.
Создать обычную клавиатуру просто. Нужно создать объект разметки, добавить кнопку и прикрепить её к сообщению. Пример: markup = types.ReplyKeyboardMarkup(resize_keyboard=True); item1 = types.KeyboardButton(‘Кнопка 1’); markup.add(item1). При отправке сообщения добавьте параметр reply_markup=markup. Пользователь увидит кнопку и сможет нажать её. Бот получит текст с этой кнопки как обычное сообщение.
Инлайн-кнопки сложнее, но интереснее. Они не отправляют текст, а передают callback-запрос. Это значит, что нажатие обрабатывается скрыто. Для этого нужен отдельный декоратор: @bot.callback_query_handler(func=lambda call: True). Внутри функции можно анализировать call.data и выполнять действия. Это удобно для меню, каталогов или голосований. Также инлайн-кнопки могут содержать URL-ссылки. Пользователь переходит по ней, не покидая Telegram.
Добавление кнопок, клавиатур и размещение на сервере
Когда бот готов на локальном компьютере, его нужно переносить в «облако». Держать бот включенным на ноутбуке неудобно. Если компьютер уснет или отключится интернет, бот перестанет отвечать. Нужен сервер (VPS), который работает круглосуточно. Популярные варианты: Timeweb, Beget, DigitalOcean или зарубежные Heroku, AWS. Для Python-ботов подойдет простейший тариф с Ubuntu.
Подключение к серверу происходит через SSH. Это протокол удаленного управления. На сервере нужно установить те же программы, что и дома: Python, pip, библиотеку. Код бота лучше заливать через Git. Это профессиональный подход. Вы создаете репозиторий на GitHub, пушите туда код, а на сервере делаете git clone. Так вы всегда сможете обновить бота одной командой.
Запуск бота на сервере отличается от локального. Если вы просто запустите python main.py и закроете терминал, бот выключится. Нужны инструменты, которые держат процесс в фоне. Самый простой способ — утилита screen или tmux. Они создают виртуальную консоль. Более надежный вариант — systemd. Это служба в Linux, которая может запускать программы при старте сервера и перезапускать их при падении.
Для настройки systemd нужно создать файл конфигурации. В нем указывается путь к исполняемому файлу Python, путь к вашему скрипту и пользователь, от имени которого запускается бот. После этого команды systemctl start mybot и systemctl enable mybot запустят бота и добавят его в автозагрузку. Теперь бот будет работать даже после перезагрузки сервера.
Важный момент — логирование. На сервере вы не видите вывода print в консоль. Все ошибки нужно писать в файл. Настройте библиотеку logging так, чтобы она записывала информацию в bot.log. Если бот перестанет отвечать, первым делом смотрите этот файл. Там будет написано, в какой функции произошла ошибка. Без логов отладка на сервере превращается в гадание.
Не забывайте про безопасность. Не храните токен прямо в коде, если вы заливаете его в открытый репозиторий типа GitHub. Используйте переменные окружения. Создайте файл .env, добавьте его в .gitignore, и считывайте токен оттуда. Это защитит вашего бота от взлома, если код случайно станет публичным.
Разработка бота — это итеративный процесс. Начните с простого, запустите его, проверьте. Потом добавляйте кнопки, сложную логику, работу с базами данных. PostgreSQL или SQLite помогут сохранять данные пользователей, чтобы бот помнил их при следующем визите. Постепенно вы перейдете от простых эхо-ботов к полноценным сервисам.
Данная статья носит информационный характер.