Botxona

Первый бот за 10 минут

Это руководство проведёт вас от начала до конца: даже если у вас пока нет ни одного бота, в итоге у вас будет работающий бот, которого можно проверить в Telegram.

Шаги

1. Получите токен (BotFather)

Откройте в Telegram чат с @BotFather, отправьте /newbot, задайте боту имя и username. В ответ вы получите длинный токен — это «ключ» вашего бота. Подробнее: Получение токена.

2. Подготовьте код бота

Если код у вас есть — упакуйте его в ZIP. Если нет — отправьте AI готовое задание из Библиотеки промптов, и он напишет код для вас. Код должен соответствовать 6 правилам — например, токен берётся из переменной окружения BOT_TOKEN, а данные хранятся внутри DATA_DIR.

3. Загрузите ZIP-файл

В панели нажмите кнопку «Новый бот», выберите ZIP-файл (или вставьте ссылку на GitHub-репозиторий), дайте боту имя и введите токен. Требования к файлу: Подготовка ZIP.

Можно и без сайта, прямо в Telegram: отправьте /newbot боту @botxona_uz_bot — он попросит токен, после чего вы отправляете ZIP-файл как документ (или выбираете одного из готовых ботов). Результат проверки, а также кнопки теста и оплаты приходят в этот же чат.

4. Посмотрите результат проверки

После загрузки система автоматически проверяет код по 6 правилам и на безопасность, а затем собирает его в docker-контейнере. Если результат 🟢 (зелёный) или 🟡 (жёлтый), можно продолжать. Если 🔴 (красный) — будет показана причина и готовый AI-промпт для исправления. Подробнее: Как читать результат проверки.

5. Протестируйте

Если сборка прошла успешно, бот запускается в режиме 15-минутного бесплатного теста. Перейдите к своему боту в Telegram и отправьте /start — должен прийти ответ.

6. Оплатите

Если во время теста бот вам понравился, выберите тариф и оплатите его — картой, на точную сумму. Подробнее: Как проходит оплата. После подтверждения оплаты бот переходит в режим работы 24/7.

Типичные ошибки

  • Токен введён неправильно — скопируйте всю строку из сообщения BotFather (последовательность цифр:букв и символов), без пробелов.
  • Несколько папок внутри ZIP — одна папка проекта в корне архива — не проблема, но если не найден requirements.txt/package.json, будет ошибка. См.: Подготовка ZIP.
  • Файл .env попал в архив — в целях безопасности такой файл автоматически удаляется; настройки вы вводите отдельно в панели.

Следующий шаг

Когда бот запущен: Обзор панели управления, Как читать логи, Аналитика.