Как вести клуб через бота

01Роли и как стать администратором

В боте три уровня доступа.

Таблица прокручивается вбок →

Как становятся админом клуба

Два пути:

• Вы подаёте заявку сами — /profile → 🎪 Открыть свой клуб (или команда /organizer). Укажите город, название клуба и контакт; суперадмин рассмотрит заявку.
• Суперадмин назначает напрямую — через справочники бота.

В обоих случаях нужно хотя бы один раз написать боту /start — иначе бота не с кем связать. После назначения в главном меню появится кнопка 🛠 Админка.

02Админ-панель

Нажмите 🛠 Админка в меню бота или отправьте команду /admin.

Откроется админ-панель с кнопками:

• 🎲 Мои игры — список ваших игр и управление каждой.
• ➕ Создать игру — новая игра.
• 📢 Канал клуба — привязать или отвязать канал клуба.
• 📍 Площадки — площадки вашего клуба.
• ⛔ Чёрный список — заблокировать или разблокировать игроку запись в клубе.

03Площадки клуба

Игры проводятся на площадках — это конкретный адрес со своей таймзоной. Прежде чем создать первую игру, у клуба должна быть хотя бы одна площадка.

Откройте 📍 Площадки. Здесь можно:

• ➕ Добавить площадку — бот спросит название, адрес и таймзону. Таймзону выбирают кнопкой из списка (например, Asia/Ashgabat, Europe/Berlin) или вводят строкой в формате IANA.
• Поменять адрес или таймзону существующей площадки.
• 🟢 Включить / 🔴 Выключить площадку. Выключенная не предлагается при создании новой игры, но уже созданные на ней игры не пропадают.

Вы видите и меняете только площадки своего клуба.

04Создание и ведение игры

Создать игру

Админ-панель → ➕ Создать игру. Бот проведёт по шагам:

1. Площадка — из площадок вашего клуба.
2. Название игры — например, «Спортивная мафия».
3. Дата и время начала — в формате ДД.ММ.ГГГГ ЧЧ:ММ, по времени площадки (например, 20.07.2026 19:00). Дата должна быть в будущем.
4. Количество мест — число посадочных мест за столом.

После этого игра сразу создаётся открытой для записи, и — если к клубу привязан канал — в канал автоматически публикуется анонс со списком и кнопками записи (см. раздел 9).

Карточка игры

Откройте игру из списка 🎲 Мои игры. В карточке видно название, дату и время, площадку, занятость мест и статус. Кнопки управления:

Таблица прокручивается вбок →

Гости игроков (+1)

Игрок может привести на игру одного гостя — человека без аккаунта в боте. Гость занимает отдельное место (учитывается в «занято / всего», как обычный участник). Добавляет гостя сам игрок в личном чате с ботом, к своей подтверждённой записи; из канала это сделать нельзя.

• По умолчанию гости разрешены на каждой игре. Управляется кнопкой 🚻 Гости в карточке игры — состояние меняется сразу по нажатию.
• Если запретить гостей — новых добавить будет нельзя (у игроков пропадёт кнопка). Уже добавленные до запрета гости остаются: их места уже забронированы.
• Гость привязан к пригласившему. Если игрок отписывается сам или вы снимаете его через 👥 Игроки, гость снимается вместе с ним — освобождаются оба места, и лист ожидания подтягивается.
• Где виден гость. В списке игроков, в посте канала и в CSV гость показан отдельной строкой вида «Гость: имя (от ник игрока)» и без телефона — контакт гостя это сам пригласивший.
• Уведомления (напоминания, перенос, отмена) гость не получает — их получает пригласивший игрок.

05Мои игры и фильтры

Админ-панель → 🎲 Мои игры. Показаны игры вашего клуба: все ближайшие плюс прошедшие за последние 7 дней. Прошедшие помечены значком 🕓.

Над списком есть фильтры по статусу:

• Все — как по умолчанию.
• Открытые — идёт запись.
• Прошедшие — завершённые игры.
• Отменённые — отменённые игры.

Фильтры полезны, когда игр много: например, чтобы найти завершённую игру для экспорта списка или отметки посещаемости.

06Работа с игроками

Карточка игры → 👥 Игроки. Вы увидите два блока: Записаны и Лист ожидания. Рядом с каждым игроком его контакты: телефон 📱 (если игрок его указал) и @username.

Здесь же доступно:

• ❌ снять игрока — кнопка с именем игрока убирает его запись. Освободившееся место сразу занимает первый из листа ожидания, а снятый игрок получает уведомление.
• ➕ Добавить игрока — записать человека вручную по @username или Telegram ID. Игрок должен был хотя бы раз написать боту, иначе бот его не найдёт. Если по @username найдено несколько человек — укажите Telegram ID.
• ✍️ Вписать по имени — записать человека, у которого нет телеграма или который никогда не писал боту. Введите только имя — так он и будет виден в составе. Такая запись занимает место наравне с остальными, а если свободных мест нет — встаёт в лист ожидания.

07Посещаемость и завершение игры

После игры отметьте, кто пришёл.

Карточка игры → ✅ Посещаемость. По каждому подтверждённому игроку две кнопки:

• ✅ имя — пришёл;
• 🚫 имя — не пришёл.

Внизу — 🏁 Завершить игру. Завершение переводит игру в статус «прошедшая»; если к клубу привязан канал, пост открепляется и помечается как завершённый.

08Рассылка и экспорт списка

Написать всем записавшимся

Карточка игры → 📢 Написать игрокам. Введите текст — бот разошлёт его всем записавшимся на эту игру, и подтверждённым, и стоящим в листе ожидания. После отправки бот покажет, скольким сообщение ушло и сколько человек не открывали бота: им написать нельзя, пока человек сам не начал диалог с ботом — это ограничение Telegram.

Типичное применение: «Игра переносится на 20:00», «Не забудьте прийти», «Есть свободное место».

Экспорт списка в CSV

Карточка игры → 📄 Экспорт CSV. Бот пришлёт файл со списком участников: имя, @username, телефон, статус, позиция в листе ожидания. Файл открывается в Excel или Google Sheets.

09Канал клуба

Бот умеет жить в канале или чате клуба: публиковать анонс игры со списком игроков, закреплять его, обновлять по мере записи — и принимать записи прямо из канала.

Как привязать канал

1. Добавьте бота в свой канал и сделайте его администратором с правами публиковать, редактировать и закреплять сообщения.
2. В боте: админ-панель → 📢 Канал клуба.
3. Выберите свой канал из списка — в нём только каналы, где бот уже администратор.
4. Готово: канал привязан к клубу.

Чтобы это сработало, должны выполняться три условия — и бот их проверяет:

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

Если чего-то не хватает, бот подскажет — например: «Бот не администратор канала. Дайте боту права публиковать, редактировать и закреплять».

🔌 Отвязать в том же разделе отвязывает канал. Уже опубликованные посты останутся, но обновляться перестанут.

Что происходит дальше

• При создании игры пост с составом автоматически уходит в канал и закрепляется.
• Пост сам обновляется при каждой записи, отписке, снятии, отметке и так далее.
• Кнопкой 📢 Опубликовать заново в карточке игры можно переопубликовать пост — если вы привязали канал уже после создания игры или пост случайно удалили.
• При отмене или завершении игры пост помечается соответствующе и открепляется.

Как игроки записываются из канала

Под постом — кнопки ✅ Записаться и ❌ Отписаться:

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

10Чёрный список клуба

Если игрок систематически опаздывает, не приходит или мешает — его можно заблокировать в клубе: он не сможет записаться на игры вашего клуба, пока вы его не разблокируете.

Админ-панель → ⛔ Чёрный список.

Заблокировать

1. Если у вас несколько клубов — выберите клуб.
2. Введите @username или Telegram ID игрока.
3. Бот покажет найденного игрока — нажмите ⛔ Заблокировать.
4. Укажите причину (например, «частые опоздания») или отправьте /skip, чтобы пропустить.

Что происходит при блокировке:

• игрок больше не может записаться на игры этого клуба — ни сам, ни через канал, ни даже ручным добавлением;
• его предстоящие записи в клубе отменяются, места освобождаются (лист ожидания подтягивается), игрок получает уведомление.

Разблокировать

В том же разделе — список заблокированных с причиной и датой. Кнопка ✅ Разблокировать: имя снимает блокировку; после этого игрок снова может записываться.

11Частые вопросы