Справка по админ-панели Ever

Что такое админка и как ей пользоваться

Админ-панель — это сайт, на котором вы настраиваете MAX-бота: создаёте мероприятия, кнопки меню и спикеров. Всё, что вы здесь делаете, пользователи видят в боте.

Шапка сайта:

• Мероприятия — список мероприятий и создание новых.
• Пользователи — список тех, кто хотя бы раз нажал /start в боте; здесь же можно выгрузить их в CSV.
• Аналитика — сводки по мероприятию (какие кнопки нажаты, какие спикеры просмотрены, какие презентации скачаны) и список пользователей, упорядоченный по последнему действию.
• Админы — видна только суперадмину: добавление и удаление учётных записей админов.
• Справка — эта страница.
• Выход — выход из учётной записи.

После входа вы попадаете на список мероприятий. Чтобы настроить кнопки, программу выступлений и спикеров конкретного мероприятия, нажмите «Управлять» у нужной строки.

Мероприятия

Мероприятие — это «сцена» бота: название, даты, приветственный текст и набор кнопок (меню). Пользователь при нажатии /start видит одно активное мероприятие.

Список мероприятий

• Сверху отображаются грядущие (ближайшее по дате первое), ниже — прошедшие.
• В колонке «Активно» может быть «Да» только у одного мероприятия — это то, что видит пользователь в боте. Если вы поставите галочку «Активно» у другого мероприятия, у предыдущего она автоматически снимется.

Создать мероприятие

1. Нажмите «Создать мероприятие».
2. Заполните: Название, Дата начала, Дата окончания, Приветственный текст (этот текст пользователь видит под названием и датой при /start).
3. Если дата и время не указаны, подставляются текущие (момент открытия формы); окончание — плюс один день.
4. Фото или видео к приветствию — необязательно. Если загружено, при /start пользователь получит это фото или видео с подписью (название, дата, текст).
5. Галочка «Активно» — если включена, это мероприятие сразу станет тем, что показывается в боте (у остальных активность снимется).
6. Нажмите «Сохранить».

В полях даты и времени год ограничен четырьмя цифрами; при удалении (Backspace) в зоне года удаляется один символ, а не весь блок.

Ограничения при сохранении

• Дата окончания не может быть раньше даты начала.
• Прошедшее мероприятие (дата окончания в прошлом) нельзя сделать активным — система выдаст ошибку.

Изменить или удалить

• Изменить — откроется форма с текущими данными, можно править и сохранить.
• Удалить — мероприятие будет удалено вместе со всеми кнопками и спикерами. Подтверждение запрашивается.
• Управлять — переход к настройке кнопок и спикеров этого мероприятия (вкладки «Кнопки» и «Спикеры»).

Кнопки меню

Кнопки — это то, что пользователь видит под приветственным сообщением в боте. Настраиваются в разделе мероприятия: нажмите «Управлять» → вкладка «Кнопки».

Добавить кнопку

1. Нажмите «Добавить кнопку».
2. Название — текст на кнопке (например: «Спикеры», «Регистрация», «Программа»).
3. Тип — от него зависит, что произойдёт при нажатии:
   • link — открывается ссылка (URL). В поле «URL» укажите полный адрес (https://…).
   • pdf — один или несколько PDF (можно выбрать сразу несколько в поле загрузки). У каждого файла можно задать имя при отправке — так будет подписано сообщение и имя файла у пользователя; если пусто, используется название кнопки.
   • video — отправляется видео. Загрузите файл через поле «Видеофайл».
   • submenu — открывается подменю (список кнопок). В поле «Callback» укажите submenu_обозначение (например submenu_products); часть после submenu_ — это ключ раздела для остальных кнопок.
4. Подменю — выпадающий список, где показывать кнопку:
   • Главное меню — под приветствием (/start). Для кнопки, которая открывает подменю (тип submenu), выберите главное меню и задайте callback submenu_имя.
   • После сохранения такой кнопки в списке появится раздел с обозначением имя — его выбирайте для кнопок внутри этого подменю (ссылки, PDF, видео и т.д.).
5. Сохраните форму.

Порядок кнопок

В таблице кнопок можно менять порядок перетаскиванием: зажмите значок ⋮⋮ слева в строке и перетащите строку выше или ниже. Порядок сохраняется автоматически.

Программа (выступления)

В разделе мероприятия: «Управлять» → вкладка «Программа». Здесь задаётся расписание выступлений: время, место, тема, презентация и спикеры. В боте программа отображается как список выступлений по времени.

Текст под датой в боте

Над таблицей выступлений — поле «Текст под датой в боте». После сохранения этот текст показывается в MAX один раз в начале программы выступлений (сразу после названия раздела, перед блоками по дням), по смыслу как приветствие мероприятия, но для блока программы.

Таблица выступлений

• Показаны все выступления выбранного мероприятия в хронологическом порядке (время, место, тема, презентация, спикеры).
• Редактировать — открывает форму: время начала и конца, место, тема, файл презентации (PDF/PPTX), название файла презентации (как оно будет отображаться), выбор одного или нескольких спикеров.
• Удалить выступление — удаляет выступление из программы. Подтверждение запрашивается.

Добавить выступление

1. Сначала добавьте спикеров на вкладке «Спикеры».
2. Нажмите «Добавить выступление».
3. Выберите одного или нескольких спикеров (множественный выбор).
4. Укажите начало и конец (дата и время). Если не заполнены, подставляются текущее время и текущее + 1 час.
5. Заполните при необходимости место, тему, загрузите презентацию (PDF/PPTX) и при желании — название файла презентации (например: «Презентация доклада.pdf»).
6. Сохраните форму.

Во всех формах с датой и временем: если поле пустое при открытии, подставляется текущее время (для «Конец» — плюс 1 час).

Спикеры

Спикеры — карточки с фото, описанием и (при необходимости) презентацией. Настраиваются в разделе мероприятия: «Управлять» → вкладка «Спикеры».

Добавить спикера

1. Нажмите «Добавить спикера».
2. Заполните Имя и Описание.
3. Фото — загрузите изображение (JPG, PNG и т.п.).
4. Сохраните. После сохранения станут доступны кнопки «Изменить» и «Выступления».

Выступления спикера

У каждой строки спикера есть кнопка «Выступления». По нажатию открывается панель внизу: список выступлений этого спикера и форма добавления нового.

• Добавить выступление — укажите начало и конец (если пусто, подставляются текущее время и +1 час), место, тему, при необходимости загрузите презентацию (PDF/PPTX) и введите название файла презентации (как на вкладке «Программа»).
• Удалить — удаляет выступление из программы. Удалить можно из карточки любого спикера, привязанного к этому выступлению.

Приветственное видео

• Поле «Приветственное видео» — необязательно. Загрузите видео (mp4, mov, avi, webm).
• В боте в карточке спикера остаётся фото; под карточкой появится кнопка «Смотреть приветственное видео». По нажатию пользователю отправляется видео отдельным сообщением (так же как презентация по кнопке).

Презентации (PDF, PPTX)

• После сохранения спикера можно добавить одну или несколько презентаций (PDF или PPTX).
• Укажите название (или оставьте пустым — подставится имя файла), выберите файл — он загрузится и привяжется к спикеру.
• У одного спикера может быть одна активная презентация. Именно она предлагается пользователю для скачивания в боте.
• Название презентации можно править прямо в таблице; изменения сохраняются при потере фокуса поля.

Пользователи бота

Вкладка «Пользователи» в шапке показывает всех, кто хотя бы раз отправил боту команду /start (или нажал «Обновить меню»).

Таблица

• MAX user ID — внутренний идентификатор пользователя в MAX.
• Имя — как в профиле MAX.
• Username — @ник (если указан).
• Первое появление — когда пользователь впервые обратился к боту.
• Мероприятие — к какому мероприятию он привязан (то, которое было активным при последнем обращении).

Выгрузка в CSV

Кнопка «Скачать CSV» выгружает список пользователей в файл. Важно выбрать кодировку:

• UTF-8 с BOM (Excel / Windows) — рекомендуется для открытия в Excel на Windows: кириллица отображается без «иероглифов».
• UTF-8 — универсальная кодировка.
• Windows-1251 — для старых программ под Windows.

Аналитика

Вкладка «Аналитика» показывает сводки и графики по выбранному мероприятию:

• График по спикерам — круговая диаграмма: распределение просмотров карточек спикеров.
• График по кнопкам — круговая диаграмма: по каким кнопкам чаще кликали. Кнопка «Спикеры» в этот график не входит.
• География — распределение пользователей по языку интерфейса MAX (ру — русский, en — английский и т.д.), что приблизительно отражает регион (в %).
• Таблицы — кнопки, просмотры спикеров, скачивания презентаций.
• Пользователи — таблица, отсортированная по последнему действию.

Админы (только суперадмин)

Вкладка «Админы» видна только пользователям с ролью суперадмин. Обычный админ её не видит.

• Суперадмин — полный доступ плюс возможность добавлять и удалять админов.
• Админ — доступ к мероприятиям, кнопкам, спикерам, пользователям; без управления учётными записями.
• Первый вход в админку выполняется по логину и паролю из настроек (ADMIN_USERNAME, ADMIN_PASSWORD в .env) — это суперадмин. Остальных админов создаёт суперадмин в разделе «Админы».

Что видит пользователь в боте

• При команде /start или при нажатии «Обновить меню» пользователь видит активное мероприятие: название, дату проведения и приветственный текст. Если в мероприятии загружено фото или видео к приветствию, оно отправляется с этой подписью. Под сообщением — кнопки главного меню (с подменю main).
• Кнопка типа link открывает указанную ссылку; pdf / video отправляют файл; submenu открывает список кнопок соответствующего подменю (продукция, эксперты, спикеры).
• В подменю «Спикеры» отображаются карточки спикеров (фото, описание). Под карточкой — кнопка «Скачать презентацию» (если есть) и при наличии приветственного видео — кнопка «Смотреть приветственное видео».

Техническая документация API

Для разработчиков и интеграций доступна полная документация по HTTP API.