Tavora

Руководство

Подключение Telegram-групп

Группы Telegram — это место, где проходят голосования и используются групповые команды. Организация может подключить до 50 групп, и каждая получает только те функции, которые вы для неё включите.

1Для чего нужны группы

Организация Tavora живёт в группах Telegram, которые вы к ней подключаете: именно там участники голосуют за предложения, получают задачи, мероприятия и объявления и пользуются командами вроде /board, /newtask, /done.

В одной организации может быть несколько групп — одна для участников, одна для правления, по одной на каждый отдел, — и в каждой включены свои функции. Максимум 50 групп на организацию: лимит не увеличивается, поэтому, чтобы подключить ещё одну группу, сначала нужно отключить другую.

2Способ 1: добавить бота в группу

Чтобы подключить группу, нужны две вещи сразу: право «Подключить группы» в организации (у основателя и администраторов оно уже есть) и статус администратора группы Telegram. Бот тоже должен быть администратором группы.

Самый быстрый способ: нажмите «Добавить меня в группу» (в конце создания или на главном экране организации, пока у неё нет групп) или «Добавить группу» (на главном экране бота) и выберите группу. Telegram сразу попросит выдать боту права администратора: подтвердите, и бот войдёт в группу уже администратором. Кнопка «Добавить меня в группу» знает, из какой организации вы её нажали: если там у вас есть право подключать группы, группа сразу подключится к этой организации, без выбора, даже если организаций у вас несколько. Если же вы нажали «Добавить группу» и у вас одна организация, группа подключится сразу; если их несколько, бот напишет вам в личные сообщения, чтобы вы выбрали (названия ваших организаций в группе никогда не появляются).

Если же вы добавили бота как обычного участника, назначьте его администратором: как только вы это сделаете, он сам предложит подключение. Или нажмите «🔗 Подключить эту группу» под его приветственным сообщением, или напишите /link в группе: поведение то же (одна организация → подключено сразу, несколько → выбор придёт в личные сообщения). Если вы анонимный администратор, /link ответит кнопкой «🔗 Подключить эту группу»: нажмите её, и подключение пройдёт от вашего имени.

3Способ 2: подключить по ID группы

Если вам удобнее делать всё из личного чата с ботом:

  1. Добавьте бота в группу и назначьте администратором
  2. В группе, будучи администратором, используйте команду /chatid, чтобы узнать числовой ID группы
  3. В личном чате с ботом откройте «⚙️ Управление» → «🔗 Группы» → «➕ Подключить группу» и вставьте ID вместе со знаком минус (например, -1001234567890)

Группа, уже подключённая к другой организации, не переносится. Каналы подключить нельзя: Tavora работает только в группах. Когда вы достигаете 50 групп, кнопка «➕ Подключить группу» исчезает из меню, а вместо неё строка сообщает, что лимит достигнут.

4Включить функции и настроить группу

Только что подключённая группа начинает со всем выключенным: ни предложений, ни задач, ни уведомлений Приёмной, пока вы их не включите. Каждая функция включается в своём меню:

  • Предложения — «⚙️ Управление» → «🔗 Группы» → «💡 Группы предложений»: отметьте группы, где предложения публикуются и ставятся на голосование. Нужны право «Подключить группы» и включённая функция «Предложения и голосования»; если Приёмная включена, тот же список открывается и из «📥 Обращения Приёмной» → «🔗 Группы назначения» → «💡 Предложения». В группе с включёнными предложениями предлагать может любой, у кого есть право «Создание предложений».
  • Задачи — «Задачи» → «🔗 Группы задач»: здесь решается, где работают команды задач, лента и дайджест. Если есть отделы, список ведётся по отделам, а привязка группы к отделу («🗂 Отделы» → отдел → «👥 Группы») включает там задачи. После создания первого отдела в группах без отдела нет ни задач, ни смен, пока вы их не привяжете.
  • Уведомления Приёмной — «⚙️ Управление» → «📥 Обращения Приёмной» → «🔗 Группы назначения» → «🙋 Запросы» / «🚩 Жалобы»: группа получает только короткое уведомление о поступлении, никогда — содержание или имя автора.

Настройки самой группы открываются из «⚙️ Управление» → «🔗 Группы» нажатием на номер группы или командой /settings в группе (тогда панель отвечает только тому, кто её открыл). Нужно право «Подключить группы». Они действуют только для этой группы:

  • Закреплять предложения — закрепляет вверху предложения, опубликованные в этой группе, в том числе объявление повестки дня и карточки голосования по её пунктам; когда голосование закрывается, его карточка открепляется
  • «🚪 Доступ к организации» — автоматический вход и выход: того, кто входит в группу, можно добавить в организацию или пригласить вступить, а того, кто выходит, — исключить из неё
  • «📍 Писать в этой теме» — только в группах с темами, если написать /settings в нужной теме: с этого момента всё, что бот публикует сам (лента и оповещения задач, дайджест, живая панель, объявления о предложениях и повестках дня, карточки голосования, мероприятия, анкеты, уведомления о сменах и Приёмной, объявления Библиотеки и организации), выходит в этой теме, а не в «General». ↩️ Назад в «General» отменяет выбор. Ответы на команды остаются в той теме, где вы написали команду
  • «🗑 Отключить группу» (в самой группе кнопка называется «🔓 Отключить группу»), с подтверждением
Предложения и задачи не включаются из панели группы: они включаются в меню своих функций (см. выше). Язык, на котором бот пишет в группах, один для всей организации: «🌐 Язык организации», в «⚙️ Управление» → «⚙️ Настройки». Внизу панели бот проверяет свои права в группе: предупреждает, если он не администратор, добавляет строку для каждого недостающего права («Закрепление сообщений», «Удаление сообщений», «Блокировка пользователей», «Пригласительные ссылки») с тем, что перестаёт работать, или пишет «🩺 Права бота: всё в порядке».

5Отключить группу

Чтобы отключить группу: «⚙️ Управление» → «🔗 Группы» → нажмите номер группы → «🗑 Отключить группу», или /settings в группе → «🔓 Отключить группу». Вас попросят подтвердить. Голосования, ещё открытые в этой группе, закрываются с уже собранными голосами, которые остаются в итоге, а автор предложения получает уведомление. Данные организации сохраняются.

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

Если бот лишится прав администратора, группа останется подключённой, но закрепление сообщений, исключение участников и создание пригласительных ссылок перестанут работать: те, у кого есть право «Подключить группы», получат личное уведомление — не чаще одного в день на группу. То же самое происходит, если бот больше не может писать в группу. Если бот остаётся администратором, но теряет какое-то из своих прав (закрепление или удаление сообщений, блокировка, приглашения), уведомление перечисляет утраченные права и то, что перестаёт работать.