ACLClouds
ACLClouds

Руководство: создать бота Telegram и разместить его бесплатно

Создать бота Telegram через BotFather, написать минимальный код на Python или Node.js и бесплатно разместить его 24/7: каждый шаг и частые ошибки.

Чтобы бесплатно разместить бота Telegram, нужны три вещи: токен от BotFather, десяток строк кода на Python или Node.js и машина, которая остаётся включённой вместо вашей. Это руководство проходит эти три шага по порядку, до первого ответа бота на команду /start. В нём используется polling: боту не нужны ни публичный адрес, ни сертификат HTTPS.

  • BotFather создаёт бота и выдаёт его токен по команде /newbot.
  • Код читает токен из переменной окружения TELEGRAM_TOKEN и никогда не хранит его прямо в файле.
  • В режиме polling боту не нужны ни публичный адрес, ни сертификат HTTPS.
  • Тариф Free от ACLClouds запускает 1 бота на Node.js или Python с 315 МБ ОЗУ, без банковской карты.
  • Ошибка 409 Conflict означает, что две копии бота работают с одним и тем же токеном.

Создать бота через BotFather

В Telegram откройте чат с @BotFather, официальным аккаунтом для управления ботами, и отправьте /newbot. Он спросит отображаемое имя, затем имя пользователя, которое должно заканчиваться на bot, например mon_premier_bot. В ответ он пришлёт токен: набор цифр и букв, разделённых двоеточием.

  • Токен даёт полный контроль над ботом: не помещайте его ни в код, ни на снимок экрана.
  • Если токен утёк, отправьте BotFather команду /revoke: старый токен перестанет работать, и будет создан новый.
  • В группе бот по умолчанию получает только команды. Чтобы читать все сообщения, отключите режим приватности командой /setprivacy.

Минимальный код на Python

Чаще всего используют библиотеку python-telegram-bot. Создайте файл requirements.txt со строкой python-telegram-bot, затем файл bot.py. Программа читает токен из переменной окружения TELEGRAM_TOKEN, объявляет команду /start и запускает приём сообщений.

  • Создайте приложение: Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build().
  • Напишите асинхронную функцию start(update, context), которая отвечает через await update.message.reply_text("Привет").
  • Привяжите её к команде через add_handler(CommandHandler("start", start)), затем завершите вызовом run_polling().
  • Пакет для установки называется python-telegram-bot, а импорт пишется так: from telegram.ext import Application, CommandHandler.

Тот же бот на Node.js

В Node.js ту же задачу решают Telegraf и grammY. С Telegraf файл package.json содержит зависимость telegraf и скрипт start, который запускает node index.js. Файл index.js занимает четыре строки.

  • Подключите библиотеку: const { Telegraf } = require("telegraf").
  • Создайте бота с токеном из окружения: const bot = new Telegraf(process.env.TELEGRAM_TOKEN).
  • Ответьте на /start через bot.start((ctx) => ctx.reply("Привет")), затем вызовите bot.launch().

Разместить бота бесплатно

Тариф Free хостинга ботов от ACLClouds держит программу на Node.js или Python запущенной постоянно, без банковской карты. Он представлен для Discord, но бот Telegram в режиме polling работает на нём так же: это программа, которая открывает исходящее соединение. При заказе выберите Python или Node.js, затем замените пример проекта своими файлами через вкладку «Файлы» или по SFTP на порту 2222.

  • На вкладке «Запуск» добавьте переменную окружения с именем TELEGRAM_TOKEN и токеном от BotFather. Поле «Токен Discord-бота» остаётся пустым.
  • Не загружайте node_modules и .venv: зависимости устанавливаются на сервере из requirements.txt или package.json.
  • Чтобы загрузить файлы через FileZilla, следуйте руководству развернуть бота по SFTP.

Запустить и проверить

Запустите бота из консоли, затем откройте чат со своим ботом в Telegram и отправьте /start. Ответ приходит через одну-две секунды. Если ничего не пришло, причина показана в консоли: прочитайте первую строку ошибки.

  • 401 Unauthorized: токен неверный или был отозван. Скопируйте его заново из BotFather.
  • 409 Conflict: другая копия бота уже работает с тем же токеном, часто на вашем компьютере. Остановите её. Если когда-то был установлен webhook, удалите его методом deleteWebhook.
  • No module named telegram: в requirements.txt нет строки python-telegram-bot. См. руководство ModuleNotFoundError.
  • В группе не приходит ни одного сообщения: включён режим приватности, доходят только команды.

Что позволяет тариф Free

Бот Telegram с командами расходует мало ресурсов: в большинстве случаев ему хватает тарифа Free. Его лимиты открыты, а условие бесплатности состоит в продлении вручную.

  • 1 бот на аккаунт, 315 МБ ОЗУ, 0,25 vCPU и 715 МБ хранилища.
  • Бесплатное продление каждые 4 дня со страницы бота. Без продления бот приостанавливается.
  • Бот не засыпает между сообщениями и сам перезапускается после неожиданной остановки.
  • Polling или webhook, частота отправки и память: эти вопросы разобраны в руководстве бот Telegram 24/7.

Часто задаваемые вопросы

Может ли бот Telegram работать на тарифе, рассчитанном на Discord?

Да. Тариф выполняет программу на Node.js или Python: бот Telegram в режиме polling запускается на нём так же, как бот Discord. Меняется только имя переменной с токеном.

Нужны ли доменное имя или сертификат HTTPS?

Нет, в режиме polling не нужны: бот сам опрашивает Telegram. А вот для webhook нужен адрес HTTPS, доступный из Интернета.

Отвечает ли бот, когда мой компьютер выключен?

Да. Он работает на инфраструктуре ACLClouds. Достаточно бесплатно продлевать тариф Free каждые 4 дня со страницы бота.

Какую библиотеку выбрать для начала?

python-telegram-bot для Python, Telegraf или grammY для Node.js. Все три хорошо документированы, и их хватает для бота с командами. Берите язык, который вы уже знаете.