Справка

Общая информация

5вёрст.bot — это Telegram-бот и веб-панель, которые помогают паркам и их командам автоматизировать рутину: модерацию чатов, оповещения и анонсы, работу с обращениями (репортами), а также управлять ролями и доступами.

• Первый шаг: один раз введите /start в личных сообщениях (ЛС) с ботом — это разрешит боту писать вам (требование Telegram).
• Контекст команд: часть команд работает только в ЛС, часть — только в общих чатах, некоторые — как ответ на сообщение. Бот сам «подсказывает», если команда введена не там.
• Секретные чаты команды: после сохранения ID секретного чата в настройках парка бот не читает и не логирует сообщения внутри него, но отправляет туда служебные уведомления (например, по /report).
• Антиспам/антифлуд: для защиты от злоупотреблений есть лимиты частоты (например, по репортам — не чаще 1 раза в минуту и не более 5 в сутки с одного пользователя).
• Защита от дублей: бот проверяет уникальность входящих событий и игнорирует повторные апдейты, которые Telegram иногда присылает при входе/выходе участников.

Как изменить личные данные?*

1. Авторизуйтесь на сайте через Telegram и перейдите в личный кабинет.
2. Заполните или измените поля «Имя» и «Фамилия» (дату рождения см. ниже).
3. Нажмите «Сохранить».

*Доступ к персональным данным есть у пользователей с административными ролями (команда парка, амбассадоры, штаб, администраторы системы) в объёме, определённом политикой конфиденциальности.

Как указать дату рождения?

Дата рождения указывается один раз и используется для сервисных функций (например, поздравлений).

• Укажите дату в профиле личного кабинета и сохраните.
• После сохранения изменить дату нельзя самостоятельно — при ошибке обратитесь в поддержку.
• Внутреннее расписание поздравлений учитывает часовой пояс Europe/Moscow.

Как сменить домашний парк?

Отправьте /park в Telegram-чате нужного парка — бот обновит привязку.

• Команда в ЛС выдаст подсказку, но привязка выполняется в чате парка.
• Привязку можно менять — при переходе в другой парк просто повторите шаг.
• Некоторые команды и уведомления зависят от текущего «домашнего» парка.

Роли и уровни доступа

• Пользователь — личный кабинет, привязка к парку, отправка репортов на сообщения нарушителей.
• Команда парка — приём репортов, модерация, настройка бота и шаблонов оповещений, управление составом команды.
• Руководитель парка — всё, что у команды; не может быть исключён из команды.
• Амбассадор / Штаб — добавление новых парков, доступ к настройкам и wiki, можно совмещать с ролью в парке.
• Система — техническая роль для автоматизации и внутренних задач.
• ROOT — полный административный доступ, управление правами и серверной инфраструктурой.

Команды взаимодействия с ботом

/start

• Где: ЛС с ботом.
• Что делает: разрешает боту писать вам и показывает стартовую информацию. Обязателен один раз.

/help

• Где: ЛС и общий чат.
• Что делает: показывает доступные вам команды и ссылку для быстрой авторизации на 5api.ru.

/getid

• В ЛС: пришлёт ваш Telegram ID.
• В общем чате: команда удалится из чата, а в ЛС придут ID чата (формат -100…) и права бота.
• Зачем: используется при подключении парка и для служебных задач.

/report

• Где: общий чат, вводится как ответ на сообщение нарушителя.
• Что делает: удаляет вашу команду из чата, отправляет уведомление в секретный чат команды (если указан) или руководителю парка, и пишет вам в ЛС о результате.
• Ссылка на сообщение: формируется, если у чата есть публичный @username; в приватных чатах Telegram не даёт прямых ссылок — уведомление будет без ссылки.
• Лимиты: не чаще 1 раза в минуту и до 5 репортов в сутки на пользователя.

/ban

• Где: общий чат, как ответ на сообщение.
• Кто может: команда парка и выше.
• Что делает: блокирует пользователя в текущем чате.

/allban

• Где: общий чат, как ответ на сообщение.
• Кто может: руководитель парка и выше.
• Что делает: меняет статус профиля нарушителя; при последующих попытках писать/входить в любые чаты с ботом — пользователь блокируется.

/park

• Где: в чате нужного парка.
• Что делает: привязывает/перепривязывает ваш профиль к парку.

/contact

• Где: ЛС или общий чат.
• Что делает: показывает контакты парка. В ЛС — контакты вашего привязанного парка, в общем чате — контакты парка чата.
• Особенности: ссылки на сервисы (Telegram, Instagram, сайт и т.д.) формируются автоматически после заполнения контактов в панели управления парка.

Добавление парка (действия выполняет руководитель парка)

1. Добавьте бота @VerstaRobot в общий чат как администратора. Минимальные права: удаление сообщений и блокировка пользователей.
2. В ЛС с ботом введите /getid — получите свой Telegram ID и сообщите его амбассадору/штабу.
3. В общем чате введите /getid — команда удалится из чата, а вам в ЛС придут ID группы и статус прав бота. Передайте ID амбассадору/штабу.
4. После добавления парка на сайте откроется доступ к его настройкам.
5. Заполните карточку парка и добавьте команду (модераторов). При желании укажите секретный чат команды — после сохранения его ID бот перестанет реагировать на сообщения внутри, но будет присылать туда уведомления.
6. Базовая настройка завершена.

Разметка Markdown в Telegram

Telegram поддерживает MarkdownV2 для форматирования сообщений. Ниже — быстрые примеры:

Технический бот для проверки разметки: @verst5_debug_bot

• Жирный: *Жирный текст* → Жирный текст
• Курсив: _Курсивный текст_ → Курсивный текст
• Подчёркнутый: __Подчёркнутый__ → Подчёркнутый
• Зачёркнутый: ~Зачёркнутый~ → Зачёркнутый
• Спойлер: ||Скрытый текст||
• Моноширинный текст: \`код\` → код
• Блок кода:
  ```код```
  →
  

  код

• Код с языком:
  ```python\nprint("Пример")\n```
  →
  

  print("Пример")

• Сложное форматирование:
  *жирный _курсив ~зачёркнутый __подчёркнутый||спойлер||__~_* *
• Ссылка: [Открыть сайт](https://example.com)
• Упоминание пользователя: [Нажми](tg://user?id=123456789)
• Эмодзи по ID: ![?](tg://emoji?id=5368324170671202286)

Цитаты и блоки:

>Это начало цитаты
>Это продолжение
>Последняя строка
                

**>Это сворачиваемый блок цитаты**
>Он скрыт по умолчанию
>Раскрывается при нажатии
>||Скрытая часть||
                

Пользуйтесь разметкой осознанно: длинные инструкции — в блоки кода и цитаты, короткие акценты — жирный/курсив.

📅 Настройка времени в формате CRON

📩 Поддержка