Документация

Руководство пользователя

Всё что нужно знать для работы с Bot Constructor

Установка

Bot Constructor доступен для Windows, Linux и macOS.

Windows

  1. Скачайте установщик BotConstructor-Setup.exe
  2. Запустите файл и следуйте инструкциям
  3. После установки запустите приложение из меню Пуск

Linux

tar -xzf bot-constructor-linux.tar.gz
cd bot-constructor
./bot-constructor

macOS

  1. Откройте DMG файл
  2. Перетащите приложение в Applications
  3. При первом запуске разрешите в настройках безопасности

Первый бот

Создание бота занимает несколько минут:

Шаг 1: Получите токен

  1. Откройте @BotFather в Telegram
  2. Отправьте команду /newbot
  3. Следуйте инструкциям и скопируйте токен

Шаг 2: Создайте проект

  1. Запустите Bot Constructor
  2. Нажмите «Новый проект»
  3. Введите название и вставьте токен

Шаг 3: Добавьте команды

В левой панели выберите «Команды» и нажмите «Добавить». Настройте текст ответа и при необходимости добавьте клавиатуру.

Интерфейс

Приложение состоит из нескольких основных областей:

  • Боковая панель — навигация между разделами
  • Рабочая область — редактирование элементов
  • Панель свойств — настройка выбранного элемента
  • Предпросмотр — как будет выглядеть бот

Команды

Команды — это основной способ взаимодействия с ботом. Они начинаются с символа /.

Создание команды

  1. Перейдите в раздел «Команды»
  2. Нажмите «Добавить команду»
  3. Укажите имя (например, /start)
  4. Введите текст ответа
  5. При необходимости прикрепите клавиатуру

Команда /start вызывается автоматически при первом запуске бота пользователем.

Клавиатуры

Telegram поддерживает два типа клавиатур:

Inline клавиатуры

Кнопки отображаются под сообщением. Могут содержать callback или URL.

Reply клавиатуры

Заменяют стандартную клавиатуру. Отправляют текст как сообщение.

Обработчики

Обработчики позволяют реагировать на различные события:

  • Текстовые сообщения — ответ на определённый текст
  • Callback — нажатия на inline кнопки
  • Regex — сообщения по шаблону

Экспорт в Python

Для экспорта бота:

  1. Нажмите «Экспорт» в верхнем меню
  2. Выберите формат (ZIP архив)
  3. Укажите папку для сохранения

Вы получите готовый проект с:

  • bot.py — основной файл бота
  • requirements.txt — зависимости
  • .env.example — пример конфигурации
  • README.md — инструкция по запуску

Деплой бота

Для запуска бота на сервере:

Локальный запуск

cd your_bot
pip install -r requirements.txt
cp .env.example .env
# Отредактируйте .env и добавьте токен
python bot.py

Docker

docker build -t mybot .
docker run -d --env-file .env mybot

Хостинги

Бот можно разместить на:

  • Railway
  • Heroku
  • VPS (DigitalOcean, Vultr)
  • Собственный сервер