Адмін-інструкція: Infobot & Interfacebot

Короткий гайд для керування контентом інфобота та роботою інтерфейс-бота.

1. Загальна структура

Система складається з двох основних компонентів:

2. Керування контентом Infobot

Редагування текстів відбувається прямо в Telegram через меню адміністратора.

2.1. Вхід в адмін-меню

Надішліть інфоботу команду /start (якщо вперше). Якщо ви у списку адмінів, у меню з’явиться кнопка «Інтерфейс користувача» та «Редагувати інтерфейс користувача».

2.2. Перегляд поточного контенту

  • Кнопки «Де ми?», «Про нас?», «Початківцям», «Тренування?», «Спаринги», «Задати питання» показують поточні тексти користувачам.
  • Щоб побачити актуальний текст без редагування, просто натисніть відповідну кнопку в основній клавіатурі та перегляньте відповідь бота.

2.3. Редагування текстів

  1. Увійдіть у режим редагування: оберіть «Редагувати інтерфейс користувача».
  2. Виберіть розділ для редагування, наприклад «Ред. Де ми?» або «Ред. Про нас?».
  3. Бот покаже поточний текст. Відповідним повідомленням надішліть новий текст, або натисніть «Скасувати».
  4. Після збереження бот підтвердить оновлення. Контент відразу бачать користувачі.
Порада: Тексти зберігаються в локальних .txt файлах, тож редагуйте обережно: видалення повністю замінить файл.

3. Робота з Interfacebot

Інтерфейс-бот — головний інструмент для управління опитуваннями та розсилками.

3.1. Головне меню

Після команди /start адміну доступні кнопки:

  • Керування опитуваннями
  • Керування розсилками
  • Налаштування (таймер розсилок тощо)
  • Інші службові/відладочні меню (залежно від конфігурації)

3.2. Керування опитуваннями

  • Створити опитування — покроковий майстер:
    1. Питання
    2. Варіанти відповіді через кому
    3. День тижня та час публікації
    4. Затримка перед нагадуванням (формати: H5 — через 5 годин, D2 — через 2 дні, M30 — через 30 хвилин)
  • Переглянути розклад — показує всі заплановані опитування з часом.
  • Редагувати опитування — можна змінити день та час поточного опитування.
  • Видалити опитування — видаляє опитування та всі пов’язані записи. Після видалення знову показується список; є кнопка «Назад».
  • Список тих, хто проголосував — оберіть опитування та отримайте перелік ID/юзернеймів, які проголосували (з урахуванням виключень).
Важливо: Опитування надсилає інфо-бот, а закріплює його юзербот. Якщо у бота немає прав на закріплення, перевірте права юзербота.

3.3. Керування розсилками

  • Запланувати розсилку — створює запис з:
    • Назвою
    • Контентом (текст, фото, альбом до 10 фото, аудіо/voice, відео, відеокружок, документ — бот попросить текст, якщо підпис відсутній)
    • Метою (в чат / користувачам / обом)
    • Перiодичністю (одноразова vs постійна)
    • Затримкою перед нагадуванням (формат як в опитуваннях)
  • Переглянути розклад — таблиця з усіма розсилками (день, час, затримка, статус).
  • Редагувати розсилку — оновлення назви, контенту, дня/часу, затримки.
  • Видалити розсилку — показує список і кнопки управління.
  • Налагодження — відладочні сценарії:
    • Надіслати опитування в чат
    • Запустити розсилку (через юзербота) у чат або користувачам
    • Скинути цикл опитувань / запустити розсилку вручну

3.4. Налаштування

Пункт «Налаштування» дозволяє:

  • Змінити таймер автоматичних розсилок (у годинах, тільки додатні цілі значення).
  • Миттєво запустити регулярну розсилку (створює фоновий таск).

4. Одноразова розсилка (команда /message)

Команда /message дозволяє одноразово розіслати повідомлення без збереження в розкладі.

  1. Викличте /message.
  2. Надішліть контент:
    • Текст
    • Фото (одне або альбом)
    • Аудіо, голосове, відео, відеокружок, документ — бот попросить текст, якщо не було підпису
  3. Дочекайтесь підтвердження «✅ Розсилку завершено.»
Примітка: Медіа файли скачуються через офіційний бот, після чого юзербот надсилає їх усім користувачам з бази. Ліміти Telegram (30 повідомлень → пауза 1 година) збережені.

5. Нагадування про опитування

6. Поради з безпеки

7. Швидкий чекліст перед запуском