> For the complete documentation index, see [llms.txt](https://grizzly-3.gitbook.io/grizzly/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://grizzly-3.gitbook.io/grizzly/chat-manager.md).

# Чат-менеджер

Система управления участниками и настройками чата. Каждый уровень включает команды предыдущего.

{% hint style="info" %}
Указать пользователя можно реплаем на сообщение, через `@username` или по имени/нику. Для модерации reply надёжнее всего.
{% endhint %}

## Уровни доступа

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🟢 Пользователь</strong></td><td>Базовые команды — доступны любому зарегистрированному участнику</td><td><a href="/pages/KnFt2ceqW4FoHx9S80rj">/pages/KnFt2ceqW4FoHx9S80rj</a></td></tr><tr><td><strong>🔵 Модератор</strong></td><td>Баны, муты, предупреждения, награды</td><td><a href="/pages/ziYqx1chee6sHAqnhfWR">/pages/ziYqx1chee6sHAqnhfWR</a></td></tr><tr><td><strong>🟣 Администратор</strong></td><td>Настройки чата, роли, антирейд, верификация, стоп-лист</td><td><a href="/pages/c6jUktbAoFHMfi8IK1uq">/pages/c6jUktbAoFHMfi8IK1uq</a></td></tr><tr><td><strong>🔴 Создатель</strong></td><td>Полный контроль — доступно только владельцу чата</td><td><a href="/pages/V1fuIt8SEIK4SkYzyAmz">/pages/V1fuIt8SEIK4SkYzyAmz</a></td></tr></tbody></table>

Те же команды доступны и ниже — переключайтесь между вкладками по ролям:

{% tabs %}
{% tab title="🟢 Пользователь" %}

| Команда                     | Описание                                                                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `.инфо`                     | Профиль — своё или реплаем на другого (алиасы: `.ктоя` / `.кто я` / `.кто ты`)                                                                                                        |
| `.я`                        | Краткая информация о себе                                                                                                                                                             |
| `.ид`                       | Ваш Telegram ID (алиасы: `.id` / `.айди`)                                                                                                                                             |
| `.стата [неделя/месяц/вся]` | Статистика сообщений: топ по никам бота, жирное выделение 1–3 мест, пагинация, блок «ваша позиция», кнопка «Дополнительно». Реплаем — по участнику (алиасы: `.статистика` / `.stats`) |
| `.статахит`                 | Тепловая карта активности (также в `.стата` → «Дополнительно»; алиасы: `.statahit` / `.хитстата`; не чаще раза в минуту)                                                              |
| `.правила`                  | Правила чата                                                                                                                                                                          |
| `.чатинфо`                  | Настройки чата (алиасы: `.chatinfo` / `.настройки`)                                                                                                                                   |
| `.админы`                   | Персонал чата (алиасы: `.staff` / `.admins` / `.модеры`)                                                                                                                              |
| `.банлист`                  | Заблокированные участники (алиас: `.баны`)                                                                                                                                            |
| `.преды`                    | Ваши предупреждения (алиасы: `.варны` / `.предупреждения`)                                                                                                                            |
| `.муты`                     | Ваши активные муты (алиасы: `.всемуты` / `.мутсписок`)                                                                                                                                |
| `.награды`                  | Награды пользователя                                                                                                                                                                  |
| `.олды`                     | Топ старожилов чата                                                                                                                                                                   |
| `.ссылка`                   | Пригласительная ссылка                                                                                                                                                                |
| `.сетка`                    | Чаты, в которых вы состоите (алиасы: `.чаты` / `.мои чаты`)                                                                                                                           |
| `.топчат`                   | Рейтинг чатов бота                                                                                                                                                                    |
| `.рейтинг`                  | Рейтинг текущего чата                                                                                                                                                                 |
| `.+`                        | Проголосовать за чат                                                                                                                                                                  |
| `.пол [м/ж]`                | Установить пол                                                                                                                                                                        |
| `.зз`                       | Установить знак зодиака (кнопками)                                                                                                                                                    |
| `.ник [никнейм]`            | Никнейм (до 10 символов, VIP — до 35 + Premium emoji). Пустой ник сбрасывает на «Пользователь». Premium-emoji уходят на модерацию                                                     |
| `.ник @пользователь [ник]`  | Предложить другому пользователю сменить ник (только в чате, подтверждается кнопкой)                                                                                                   |
| `.упник`                    | Вкл/выкл упоминание в никнейме                                                                                                                                                        |
| `.никнеймы`                 | Все никнеймы участников чата                                                                                                                                                          |
| `.cid`                      | ID текущего чата                                                                                                                                                                      |
| `.uid`                      | Telegram ID — свой или реплаем на другого пользователя                                                                                                                                |
| `.unreg`                    | Сбросить свою регистрацию в боте                                                                                                                                                      |
| `.рег [@пользователь]`      | Зарегистрировать незарегистрированного пользователя                                                                                                                                   |
| `.кошелек`                  | TON-кошелёк                                                                                                                                                                           |
| `.+описание [текст]`        | Описание профиля (до 255 символов)                                                                                                                                                    |
| `.-описание`                | Удалить описание                                                                                                                                                                      |
| `.закладки`                 | Ваши закладки в чате (5 шт., VIP — 25)                                                                                                                                                |
| `.+закладка [название]`     | Сохранить закладку (реплаем на сообщение)                                                                                                                                             |
| `.-закладка [название]`     | Удалить закладку (реплаем или по названию)                                                                                                                                            |
| `.закладка [название]`      | Найти закладку и ответить на её сообщение                                                                                                                                             |
| `.репорт`                   | Пожаловаться (реплаем)                                                                                                                                                                |
| `.голосбан {пользователь}`  | Народный бан — запустить голосование участников за блокировку нарушителя, без прав администратора (если включено владельцем чата)                                                     |
| `.триггер` / `.триггеры`    | Список кастомных команд-алиасов чата с кнопками удаления                                                                                                                              |
| `.вип`                      | Свой VIP и срок. **Реплаем** на пользователя — его VIP и кнопка «Подарить VIP»                                                                                                        |
| `.предл`                    | Предложить картинку для RP (+1 звезда за принятую)                                                                                                                                    |
| `/paysupport`               | Проблемы с оплатой                                                                                                                                                                    |
| {% endtab %}                |                                                                                                                                                                                       |

{% tab title="🔵 Модератор" %}
{% hint style="info" %}
Назначает владелец или администратор. Количество не ограничено.
{% endhint %}

| Команда                                 | Описание                                                                                                               |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `.бан {пользователь}`                   | Заблокировать (алиасы: `.ban` / `.permban`)                                                                            |
| `.бан! {пользователь}`                  | Заблокировать + удалить сообщение                                                                                      |
| `.кик {пользователь}`                   | Выгнать из чата без блокировки (алиасы: `.kick` / `.кикнуть`)                                                          |
| `.разбан {пользователь}`                | Разблокировать (алиасы: `.расбан` / `.разблокировать` / `.unban`)                                                      |
| `.вернуть {пользователь}`               | Разблокировать и отправить пользователю в ЛС пригласительную ссылку (как кнопка «Вернуть» после `.бан`)                |
| `.мут {пользователь} {время} {причина}` | Мут: время в формате 30м/1ч/2д (от 3 мин до 365 дней; без указания — 1 час). Алиасы: `.mute` / `.замутить`             |
| `.размут {пользователь}`                | Снять мут (алиасы: `.снятьмут` / `.говори` / `.unmute`)                                                                |
| `.пред {пользователь} {причина}`        | Выдать предупреждение (алиас: `.варн`)                                                                                 |
| `.разпред {пользователь}`               | Убрать последнее предупреждение (алиасы: `.снятьпред` / `.unwarn` / `.распред`)                                        |
| `.проверитьмут {пользователь}`          | Проверить статус мута                                                                                                  |
| `.досье {пользователь}`                 | Полное досье участника: варны, муты, баны, награды и стаж — одним экраном                                              |
| `.-смс`                                 | Удалить сообщение реплаем                                                                                              |
| `.закреп`                               | Закрепить сообщение реплаем (требуется Telegram-право «закреплять сообщения»)                                          |
| `.откреп`                               | Открепить: реплаем — конкретное, без реплая — последнее закреплённое (требуется Telegram-право «закреплять сообщения») |
| `.наградить`                            | Наградить (реплаем; алиас `.награда+`)                                                                                 |
| `.награда- {пользователь}`              | Забрать награду (алиас `.награда -`)                                                                                   |
| `.обновить`                             | Перезапустить бота — решает большинство проблем                                                                        |
| `.созвать {админов/модеров}`            | Упомянуть всех администраторов или модераторов                                                                         |
| {% endtab %}                            |                                                                                                                        |

{% tab title="🟣 Администратор" %}
{% hint style="info" %}
Назначает только владелец. Количество не ограничено.
{% endhint %}

| Команда                                               | Описание                                                                                                                   |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `.модер {пользователь}`                               | Назначить модератором (алиасы: `.модератор` / `.moder`)                                                                    |
| `.повысить {пользователь}`                            | Повысить в правах                                                                                                          |
| `.понизить {пользователь}`                            | Понизить в правах                                                                                                          |
| `.разжаловать {пользователь}`                         | Снять все права (алиасы: `.расжаловать` / `.снять полномочия`)                                                             |
| `.+правила`                                           | Установить правила чата                                                                                                    |
| `.-правила`                                           | Удалить правила чата                                                                                                       |
| `.+приветствие`                                       | Приветствие при входе. Переменные: `{имя}`, `{ник}`                                                                        |
| `.-приветствие`                                       | Удалить приветствие                                                                                                        |
| `.+входы` / `.-входы`                                 | Вкл/выкл уведомления о входах                                                                                              |
| `.+выходы` / `.-выходы`                               | Вкл/выкл уведомления о выходах (самостоятельный уход)                                                                      |
| `.+бусты` / `.-бусты`                                 | Вкл/выкл уведомления о бустах                                                                                              |
| `.+инфовходы` / `.-инфовходы`                         | Полная информация при входе (аватар, профиль)                                                                              |
| `.входы`                                              | Настройка уведомлений о входах/выходах                                                                                     |
| `.капча`                                              | Настройка антирейда и капчи: режим (по умолчанию арифметика) и число нажатий «робот» (по умолчанию 3)                      |
| `.+рейд` / `.-рейд`                                   | Быстро включить/выключить антирейд                                                                                         |
| `.+верификация` / `.-верификация`                     | Включить/выключить верификацию при подаче заявки на вступление                                                             |
| `.верификация [режим]`                                | Выбрать режим: `код`, `математика`, `вопрос`, `правила`, `ручное`                                                          |
| `.+вопрос [вопрос\|правильный\|вариант2\|вариант3]`   | Настроить вопрос для режима «Свой вопрос»                                                                                  |
| `.стоплист`                                           | Стоп-лист (панель + кнопки). Лимит 10 фраз, Premium — 100                                                                  |
| `.стоплист + [слово]`                                 | Добавить фразу (до 50 символов; можно несколько с новой строки)                                                            |
| `.стоплист - [слово]`                                 | Удалить фразу из стоп-листа                                                                                                |
| `.стоплист очистить`                                  | Очистить весь стоп-лист (наказание не сбрасывается)                                                                        |
| `.стоплист наказание [кик/пред/мут N]`                | Наказание за стоп-слово (мут 1–9999 мин; по умолчанию — только удаление сообщения)                                         |
| `.+ссылки` / `.-ссылки`                               | Разрешить/запретить сторонние ссылки                                                                                       |
| `.+чаты` / `.-чаты`                                   | Разрешить/запретить ссылки на чаты (алиасы: `.+беседы` / `.-беседы`)                                                       |
| `.+каналы` / `.-каналы`                               | Разрешить/запретить каналы                                                                                                 |
| `.рс`                                                 | Вкл/выкл показ кастомной ссылки на чат                                                                                     |
| `.-ссылка`                                            | Удалить ссылку на чат                                                                                                      |
| `.+ссылка [ссылка]`                                   | Установить ссылку на чат                                                                                                   |
| `.лимитнаград {N}`                                    | Лимит наград на пользователя                                                                                               |
| `.тема`                                               | Тема руководства чата                                                                                                      |
| `.+рпбраккнопки` / `.-рпбраккнопки`                   | Вкл/выкл инлайн-кнопки в RP-действиях брака                                                                                |
| `.тег [текст]`                                        | Установить тег участника (реплаем)                                                                                         |
| `.+команда [триггер] [ответ]` / `.+[триггер] [ответ]` | Создать команду-алиас чата (короткий синтаксис — сразу `.+привет Привет, путник!`; макс. 10 на чат, ответ до 500 символов) |
| `.-команда [триггер]` / `.-триггер [триггер]`         | Удалить команду-алиас чата                                                                                                 |
| {% endtab %}                                          |                                                                                                                            |

{% tab title="🔴 Создатель" %}
{% hint style="warning" %}
Доступны только владельцу чата.
{% endhint %}

| Команда                                          | Описание                                                                                                                         |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `.админ {пользователь}`                          | Назначить администратором                                                                                                        |
| `.название {новое}`                              | Сменить название чата                                                                                                            |
| `.лтпред [1-20]`                                 | Лимит предупреждений до автобана (по умолчанию 3; алиасы: `.лимитпредов` / `.лпред`)                                             |
| `.кик неактив [срок]`                            | Исключить неактивных за указанное число дней (1–30; с подтверждением)                                                            |
| `.кик от [ссылка-приглашение]`                   | Исключить всех, кто вступил по указанной invite-ссылке (с подтверждением; учитываются только входы после включения отслеживания) |
| `.плвкл` / `.плвыкл [команда]`                   | Включить/выключить команду в чате                                                                                                |
| `.пл`                                            | Список отключённых команд в чате                                                                                                 |
| `.-чат`                                          | Закрыть чат (никто не может вступить)                                                                                            |
| `.+чат`                                          | Открыть чат                                                                                                                      |
| `.няпока`                                        | Снять с себя роль администратора                                                                                                 |
| `.восстановить создателя`                        | Восстановить роль создателя (если потеряна)                                                                                      |
| `.амнистия`                                      | Снять баны со всех участников                                                                                                    |
| `.nsfw` / `.+nsfw` / `.-nsfw`                    | NSFW-панель / включить / выключить (только Premium-чат)                                                                          |
| `.репорты` / `.+арбитр` / `.-арбитр` / `.арбитр` | Управление арбитрами репортов (назначить/снять)                                                                                  |
| {% endtab %}                                     |                                                                                                                                  |
| {% endtabs %}                                    |                                                                                                                                  |

## Уведомления в `.настройки`

Раздел **«Уведомления»** в `.настройки` (алиас `.чатинфо`) управляет сообщениями бота о событиях в чате:

| Переключатель       | Что показывает                                                                           |
| ------------------- | ---------------------------------------------------------------------------------------- |
| **Входы**           | Уведомления о новых участниках                                                           |
| **Выходы**          | Самостоятельный уход из группы                                                           |
| **Кики**            | Исключение администратором через интерфейс Telegram (по умолчанию включено)              |
| **Разблокировки**   | Снятие с чёрного списка администратором через интерфейс Telegram (по умолчанию включено) |
| **Бусты**           | Бусты чата                                                                               |
| **Инфо при входе**  | Расширенная карточка при входе                                                           |
| **График в .стата** | Тепловая карта в статистике                                                              |

Команды `.+входы` / `.-входы` и `.+выходы` / `.-выходы` по-прежнему работают; кики и разблокировки настраиваются только через `.настройки`.

## Верификация при входе

Защищает чат от ботов и нежелательных участников. Каждый, кто подаёт заявку на вступление, проходит проверку — 5 режимов на выбор.

{% hint style="warning" %}
**Обязательное условие:** в настройках группы Telegram должны быть включены **«Заявки на вступление»** (Settings → Members → Approve New Members). Без этого функция не работает. Бот предупредит в панели настроек, если заявки выключены.
{% endhint %}

![Включите "Заявки на вступление" в настройках группы](/files/LmMyaoJaBZsFAmkwuzsj)

**Как включить:**

```
.+верификация
```

Или через `.чатинфо` → **Безопасность** → кнопка **«Верификация входа»**.

### Выбор режима

Через `.чатинфо` → **Безопасность** → «Верификация входа» → нажмите на нужный режим:

| Режим         | Команда                   | Описание                                                                    |
| ------------- | ------------------------- | --------------------------------------------------------------------------- |
| 🔐 Капча      | `.верификация код`        | Бот отправляет 6-значный код в личку, пользователь вводит его текстом       |
| 🧮 Пример     | `.верификация математика` | Бот присылает арифметический пример, пользователь пишет числовой ответ      |
| ❓ Свой вопрос | `.верификация вопрос`     | 3 кнопки с вариантами, один правильный — задаёт администратор               |
| 📕 Правила    | `.верификация правила`    | Бот отправляет правила чата, кнопки «Принимаю» / «Не принимаю»              |
| 👨‍⚖️ Ручное  | `.верификация ручное`     | Бот уведомляет персонал чата — администратор одобряет или отклоняет вручную |

#### Настройка режима «Свой вопрос»

Перед включением нужно задать вопрос:

```
.+вопрос Текст вопроса|Правильный ответ|Вариант 2|Вариант 3
```

Пример:

```
.+вопрос О чём наш чат?|О программировании|О музыке|О кулинарии
```

Разделитель — `|`. Длина каждого ответа — до 16 символов. Первый ответ после вопроса — правильный.

{% hint style="danger" %}
Если вопрос не настроен, а режим «Свой вопрос» активен — заявка будет **автоматически отклонена**. Убедитесь в наличии вопроса перед включением.
{% endhint %}

#### Настройка режима «Ручное одобрение»

При подаче заявки бот рассылает уведомление в **личку** выбранным сотрудникам чата с кнопками **✅ Принять** / **❌ Отклонить**.

Когда кто-то из персонала принимает решение:

* Заявка немедленно одобряется или отклоняется в Telegram
* У всех остальных получивших уведомление сообщение **редактируется**: отображается, кто и когда принял решение
* Пользователь получает уведомление в личку о результате

Кнопки после принятия решения автоматически убираются.

**Настройка получателей уведомлений** (в панели «Ручное»):

| Вариант            | Описание                                   |
| ------------------ | ------------------------------------------ |
| 👥 Весь персонал   | Все Telegram-администраторы чата           |
| 🔑 Администраторы  | Все Telegram-администраторы (по умолчанию) |
| 👑 Только владелец | Только создатель чата                      |

{% hint style="info" %}
Если выбранный персонал недоступен или не имеет личного чата с ботом, заявка будет автоматически отклонена с уведомлением в чат.
{% endhint %}

### Общее поведение

* **Режимы «Капча» и «Пример»** — пользователь пишет ответ текстом в личку. 3 попытки, 10 минут.
* **Режимы «Свой вопрос» и «Правила»** — пользователь нажимает кнопку. 3 попытки, 10 минут.
* **Режим «Правила»** — нажатие «Не принимаю» сразу отклоняет заявку (без попыток).
* **Режим «Ручное»** — без ограничения по времени, решает человек.
* После 3 неверных попыток или истечения 10 минут — заявка **отклоняется** в Telegram.

{% hint style="info" %}
Если пользователь никогда не писал боту в личку, отправить ему задание невозможно — заявка будет отклонена автоматически с уведомлением в чат.
{% endhint %}

## Народный бан (.голосбан)

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

**Как включить:** `.настройки` → **Безопасность** → «Народный бан» (только владелец чата). В этом же меню настраивается порог для бана:

| Режим                       | Описание                                                                             |
| --------------------------- | ------------------------------------------------------------------------------------ |
| Фиксированное число голосов | Нужно набрать заданное количество голосов (по умолчанию 5, от 2 до 100)              |
| Процент от участников чата  | Нужно набрать заданный процент от числа участников (по умолчанию 20%, от 5% до 100%) |

{% hint style="info" %}
Голосование запускается командой `.голосбан {пользователь}` (реплаем или `@username`) и действует 10 минут. Голосовать нельзя за себя и против модераторов/администрации. Повторно запустить голосование против того же участника можно не чаще раза в час. При достижении порога участник блокируется автоматически.
{% endhint %}

## Команды-алиасы чата (.+команда)

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

| Что              | Как                                                                                                                      |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Создать          | `.+команда [триггер] [ответ]` или короткая форма `.+[триггер] [ответ]` (например `.+привет Привет, путник!`)             |
| Прикрепить медиа | После создания бот спросит, прикрепить ли фото/видео/gif — при наличии вложения команда уходит на модерацию (как `.срп`) |
| Список           | `.триггер` / `.триггеры` — показывает все алиасы чата с кнопкой 🗑 удаления под каждым                                   |
| Удалить          | Кнопкой в списке, либо `.-триггер [триггер]` / `.-команда [триггер]`                                                     |

{% hint style="info" %}
Лимит — 10 команд-алиасов на чат, длина ответа — до 500 символов. Ссылки и запрещённые слова в ответе не допускаются.
{% endhint %}

## См. также

* [Как работают предупреждения?](/grizzly/faq-chastye-voprosy/moderation.md#warns)
* [Как работает стоп-лист?](/grizzly/faq-chastye-voprosy/moderation.md#stoplist)
* [Чем бан отличается от кика?](/grizzly/faq-chastye-voprosy/moderation.md#ban-vs-kick)
* [Что такое народный бан?](/grizzly/faq-chastye-voprosy/moderation.md#voteban)
* [Регистрация и профиль](/grizzly/faq-chastye-voprosy/registration.md)
* [Все вопросы по чату и модерации](/grizzly/faq-chastye-voprosy/moderation.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://grizzly-3.gitbook.io/grizzly/chat-manager.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.