Полное руководство для оператора: две платформы ботов (Telegram и MAX), мероприятия, контент и эксплуатация без предварительного обучения.
Назначение. Здесь настраиваются мероприятия, меню бота, программа, спикеры, напоминания и рассылки. Изменения применяются к подключённым ботам Telegram и MAX (если для мероприятия включены соответствующие платформы).
Макет экрана.
Мероприятие — это контекст для бота: даты, приветствие, часовой пояс, меню, программа и спикеры. У каждого мероприятия свой набор кнопок и данных.
| Колонка | Значение |
|---|---|
| ID | Внутренний номер. По умолчанию таблица отсортирована по ID по убыванию (новые сверху). Над таблицей доступны сортировка по колонкам из выпадающего списка, направление (возр./убыв.), размер страницы и листалка — отдельного поля поиска по названию нет. |
| Название | Отображаемое имя мероприятия. |
| Активно Telegram | Галочка: это мероприятие считается активным для Telegram-бота. Одновременно активным для Telegram может быть только одно мероприятие — при включении галочки у другого оно снимется. |
| Активно MAX | Галочка: активное мероприятие для MAX-бота. Одновременно для MAX активно только одно мероприятие. То же мероприятие может быть активным и в Telegram, и в MAX. |
| Действия |
Управлять — открыть вкладки Кнопки / Программа / Спикеры / Напоминания. Изменить — форма названия, дат, часового пояса, приветствия и медиа. Удалить — удалить мероприятие и связанные данные (с подтверждением). |
Кнопка Создать мероприятие или Изменить у строки.
| Секция / поле | Описание |
|---|---|
| Основная информация | |
| Название | Обязательно. |
| Дата начала / окончания | Обязательны. Если при создании не трогать — подставятся текущие дата-время и +24 часа. Окончание не может быть раньше начала. Прошедшее по дате окончания мероприятие нельзя сделать активным для платформы. |
| Часовой пояс (UTC offset) | Целое число часов от −12 до +14. Используется для отображения локального времени и расчёта напоминаний «в локальном времени события». |
| Приветствие и медиа | |
| Приветственный текст | Текст под заголовком при запуске бота. Если пусто, в Telegram и MAX подставляются название и даты мероприятия по правилам бота. |
| Фото или видео к приветствию | Необязательно. Отправляется одним сообщением с подписью (название, даты, текст). Можно удалить файл с сервера кнопкой под полем. |
Раздел в левом меню (иконка «громкоговоритель»). Рассылка идёт по всем строкам таблицы пользователей в базе (каждая запись — отдельное сообщение в Telegram и/или MAX). Параллельно может выполняться не более одной рассылки в статусе «в очереди» или «в процессе»: закрытие вкладки браузера не останавливает отправку на сервере.
Ниже — таблица последних заданий: статус, дата создания, число получателей, отправлено, ошибки, платформы. Клик по строке открывает детали выбранной рассылки. Пока открыт раздел «Оповещения» и вкладка браузера активна, список может периодически обновляться (чтобы видеть прогресс).
Для задания со статусом «завершено с ошибками» может быть доступна кнопка повторной отправки только неудавшимся получателям (если предусмотрено в интерфейсе).
После Управлять открывается экран с заголовком мероприятия и четырьмя вкладками. Кнопка ← К мероприятиям возвращает к списку.
Вкладка Кнопки. Это элементы клавиатуры под приветственным блоком в боте.
| Колонка | Описание |
|---|---|
| (первая колонка ≡) | Зона захвата для перетаскивания строки. Отпустите в нужном месте — порядок сохранится на сервере автоматически. |
| Название | Текст на кнопке. |
| Тип | Бейдж: тип кнопки (LINK, PDF, VIDEO, SUBMENU). Если кнопка относится не к главному меню, рядом показывается группа подменю (например PDF · products). Для главного меню (main) дополнительная метка не дублируется. |
| Действия | Изменить и Удалить. |
Основная информация: название; тип — link / pdf / video / submenu.
submenu_speakers) и выбор Подменю: главное меню или группа, созданная другой кнопкой-submenu./start или эквивалент в MAX), чтобы увидеть актуальный набор кнопок.Вкладка Программа.
Вкладка Спикеры.
В ботах карточка спикера показывает выступления с заголовком «Выступления спикера» и блок описания «Описание спикера». Если есть фото — оно идёт вместе с текстом; если есть и фото, и приветственное видео, в Telegram фото крепится к тексту, видео — следующим сообщением (в MAX логика согласована с этим подходом).
Вкладка Напоминания. Отправляются пользователям, которые есть в базе для данного мероприятия, на платформах, для которых мероприятие активно (Telegram и/или MAX), при наличии рабочих токенов ботов на сервере (в базе инсталляции или в .env — см. раздел Токены).
Колонки: когда отправить, текст, документы, статус, время фактической отправки, действия. Доступна кнопка Отправить сейчас — принудительная отправка (в том числе повторно, если напоминание уже отправлялось).
Раздел в левом меню (иконка «люди»). Список пользователей привязан к выбранному мероприятию: в выпадающем списке сверху выберите мероприятие.
| Колонка | Описание |
|---|---|
| Платформа | Telegram или MAX. |
| ID | Идентификатор пользователя на платформе. |
| Имя | Отображаемое имя из профиля. |
| Username | Для Telegram при наличии — ссылка на профиль t.me/.... |
| Обращение | Пользовательское имя для рассылок; можно изменить кнопкой Изменить в строке. |
| Первое появление | Первое обращение к боту в контексте учёта. |
| Мероприятие | Привязка к событию. |
Скачать CSV — выгрузка списка; выберите кодировку (для Excel на Windows удобен UTF-8 с BOM).
Раздел в левом меню. Сначала выберите мероприятие.
language_code) — ориентир по аудитории; для пользователей MAX язык может быть не задан.Записи о действиях в админке: кто, что изменил, для какой сущности и мероприятия.
Раздел в левом меню. Удаление сохранённых в базе сообщений бота (и при принудительной очистке — сообщений пользователя в пределах ограничений API) для Telegram и MAX.
docs/CHAT_CLEANUP.md).Видно только суперадмину. Учётная запись из переменных окружения (ADMIN_USERNAME / ADMIN_PASSWORD) в списке не показывается, но имеет полный доступ.
Видно только суперадмину. Кнопка Токены в верхней панели справа (между «Справка» и «Выход») открывает раздел с токенами Telegram и MAX для всей установки (один бот на платформу на сервер).
BOT_TOKEN и MAX_SEND_TOKEN в файле .env на сервере. Пустое значение в базе означает: использовать то, что задано в .env.getMe; MAX — лёгкий запрос к API платформы).main.py (Telegram), main_max.py (MAX) и процесс админки должны быть перезапущены, чтобы боты подняли новые секреты из памяти. Сама админка после сохранения подтягивает токены из БД для своих фоновых задач; настройка автоматического рестарта через systemd описана в docs/DEPLOYMENT.md (раздел про токены и whitelist-команду).MAX_USE_LONG_POLLING в .env на сервере.docs/DEPLOYMENT.md, docs/GITVERSE_DEPLOY.md (если код на GitVerse) и docs/HANDOVER_CHECKLIST.md.main.В веб-интерфейсе действуют ограничения: до 10 файлов в одной «пачке» загрузки в форме и до 50 МБ на один файл (если сервер не настроен иначе). При превышении появится сообщение об ошибке.
Интерактивные страницы, сгенерированные FastAPI из кода админки:
/swagger (удобно для «попробовать запрос»)./api (читабельная вёрстка схем).Текстовое описание эндпоинтов и соглашений — в репозитории файл docs/API.md.