Быстрый старт

Коротко о том, как за несколько минут поставить Telegram-бота онлайн: нужен репозиторий на GitHub и токен от @BotFather. Сервер, Docker и терминал не нужны.

Что понадобится

  • Репозиторий на GitHub с кодом бота. Публичный подключается ссылкой, для приватного нужен токен доступа (см. раздел «Как подготовить репозиторий»).
  • Токен бота от @BotFather — строка вида 123456789:AAH... (см. раздел «Токен бота»).
  • Аккаунт AutoHoster: регистрация по email и паролю или вход через Telegram, VK ID, Яндекс. Тариф «Пробный» бесплатный на 7 дней. Чтобы создать бота, новые пользователи привязывают карту: проверочная блокировка 1 ₽ сразу снимается. Когда пробный период закончится, с карты спишется месяц тарифа, который подходит вашим ботам; автопродление можно выключить в «Тариф и оплата».

Шаг 1. Добавьте бота

Откройте табло ботов (/app) и нажмите «Добавить бота». Мастер спросит:

  1. Название — как бот будет подписан на табло.
  2. Ссылку на репозиторий и ветку (по умолчанию main). Для приватного репозитория — токен GitHub.
  3. Токен бота. Платформа сразу проверит его через Telegram (getMe) и покажет имя и @username бота. Неверный токен не пропустит.
  4. Переменные окружения (необязательно) — например, ID администратора или ключи сторонних API. Токен Telegram добавлять не нужно: он попадёт в окружение автоматически под именем TELEGRAM_BOT_TOKEN (имя можно изменить).

По умолчанию после сохранения сразу запускается первая сборка.

Шаг 2. Дождитесь сборки

Платформа клонирует выбранную ветку, определяет язык по файлам в корне (Python или Node.js, либо берёт ваш Dockerfile), собирает образ и запускает контейнер. Обычно это занимает 1–3 минуты; живой лог сборки — во вкладке «Сборки» на странице бота.

Если сборка не удалась, в конце лога написано, что пошло не так: строка начинается с ✗. Типовые причины разобраны в разделе «Типовые ошибки».

Шаг 3. Проверьте статус

Когда на табло у бота горит «Работает», он отвечает в Telegram. Дальше бот живёт сам: при падении контейнер перезапускается автоматически, а если включить автодеплой — каждый push в выбранную ветку будет собирать и выкатывать новую версию.

Что дальше

  • Переменные и секреты, папка /app/data для файлов — раздел «Переменные окружения и данные».
  • Сборки, логи, откат к прошлой версии, автодеплой — раздел «Сборки и деплой».
  • Лимиты тарифа (сколько ботов, памяти и места для данных) — раздел «Тарифы и оплата».