> 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/faq-chastye-voprosy/moderation.md).

# Чат и модерация

*Раздел:* [*Чат-менеджер*](/grizzly/chat-manager.md)

* [Какие уровни прав есть в боте?](#roles)
* [Почему команда не работает в конкретном чате?](#command-not-working)
* [Как работают предупреждения?](#warns)
* [Чем бан отличается от кика?](#ban-vs-kick)
* [Массовое исключение (.кик неактив / .кик от)](#mass-kick)
* [Как настроить ссылки?](#links)
* [Как настроить приветствие и правила?](#welcome-rules)
* [Как включить подробные входы?](#join-notifications)
* [Что делает антирейд?](#antiraid)
* [Как работает стоп-лист?](#stoplist)
* [Что такое арбитры репортов?](#arbiters)
* [Что значит закрыть чат через .-чат?](#close-chat)
* [Что такое народный бан (.голосбан)?](#voteban)
* [Что показывает .досье?](#dossier)
* [Что такое тепловая карта чата (.статахит)?](#heatmap)

## Какие уровни прав есть в боте? <a href="#roles" id="roles"></a>

Обычный участник видит профильные и развлекательные команды. Модератор получает муты, баны и предупреждения. Администратор управляет настройками чата. Владелец назначает админов, управляет NSFW, антирейдом, отключением команд и арбитрами.

## Почему команда не работает в конкретном чате? <a href="#command-not-working" id="command-not-working"></a>

Возможные причины: команда отключена через `.плвыкл`, у бота нет прав администратора, вы не зарегистрированы, у команды есть кулдаун, функция доступна только в ЛС или нужна роль модератора/админа/владельца.

## Как работают предупреждения? <a href="#warns" id="warns"></a>

По умолчанию лимит — 3 предупреждения. При его достижении участник автоматически банится, а счётчик предупреждений сбрасывается. Боту нужны права на блокировку.

Модератор выдаёт предупреждение через `.пред`. Лимит задаёт владелец через `.лтпред`. Последнее предупреждение можно снять командой `.разпред`.

## Чем бан отличается от кика? <a href="#ban-vs-kick" id="ban-vs-kick"></a>

`.кик` просто удаляет участника из чата без блокировки. `.бан` запрещает возвращаться, пока модератор не снимет блокировку через `.разбан` или `.вернуть`.

`.разбан` только снимает блокировку. `.вернуть` делает то же самое, что кнопка «Вернуть» под сообщением о бане: снимает блокировку и отправляет пользователю в ЛС пригласительную ссылку на чат. Пользователя можно указать реплаем, `@username` или id — он не обязан быть в чате.

## Массовое исключение (.кик неактив / .кик от) <a href="#mass-kick" id="mass-kick"></a>

Только **создатель** чата:

* **`.кик неактив [дни]`** — исключить участников без сообщений за указанный срок (1–30 дней). Бот покажет число и попросит подтверждение.
* **`.кик от [ссылка-приглашение]`** — исключить всех, кто вступил по конкретной invite-ссылке (`https://t.me/+…` или `https://t.me/joinchat/…`). Тоже с подтверждением.

Для `.кик от` учитываются только входы **после того, как бот начал сохранять ссылку приглашения** (при вступлении по invite). Администраторов и модераторов с равными или более высокими правами бот не тронет.

## Как настроить ссылки? <a href="#links" id="links"></a>

`.+ссылки` и `.-ссылки` управляют сторонними ссылками. `.+чаты` и `.-чаты` отдельно отвечают за ссылки на Telegram-чаты. `.+каналы` и `.-каналы` — за каналы.

## Как настроить приветствие и правила? <a href="#welcome-rules" id="welcome-rules"></a>

**Правила:** `.+правила [текст]`, удалить — `.-правила`, посмотреть — `.правила`.

**Приветствие:** `.+приветствие [текст]`, удалить — `.-приветствие`. В тексте поддерживаются переменные `{имя}` и `{ник}` — подставляется имя вошедшего участника.

### Вложения (фото, GIF, видео)

К правилам и приветствию можно добавить **фото, GIF или видео**:

* отправьте медиа **с подписью** — подпись станет текстом;
* для правил ответьте на чужое фото/GIF/видео командой `.+правила`;
* можно сохранить **только вложение** без текста (для правил в верификации и `.правила` текст не обязателен, если есть медиа).

Если вы задали **только текст** (командой или через панель настроек), бот спросит: «Хотите добавить фото, GIF или видео?» Отправьте вложение следующим сообщением или нажмите **Пропустить**. Если медиа уже было в том же сообщении, повторный вопрос не задаётся.

### Где ещё настроить

* **В чате:** `.настройки` → раздел **Тексты**
* **В личке с ботом:** `.панель` / `.управление` → выберите чат → **Тексты**

Правила поддерживают форматирование (жирный, курсив, ссылки). При входе новых участников приветствие отправляется с вложением, если оно задано. В режиме верификации «Правила» бот показывает правила с вложением в личку.

## Как включить подробные входы? <a href="#join-notifications" id="join-notifications"></a>

`.+входы` включает обычные уведомления о входах, `.+инфовходы` добавляет расширенную карточку с данными пользователя. Выключение — `.-входы` и `.-инфовходы`.

Уведомления об исключении и разблокировке **администратором через интерфейс Telegram** (не командами бота) настраиваются в `.настройки` → **Уведомления** → «Кики» и «Разблокировки». По умолчанию оба включены; «Выходы» на них не влияет.

## Что делает антирейд? <a href="#antiraid" id="antiraid"></a>

Антирейд помогает фильтровать массовые входы и подозрительных новых участников. Быстро включить или выключить можно через `.+рейд` и `.-рейд`, подробная настройка — `.капча`.

## Как работает стоп-лист? <a href="#stoplist" id="stoplist"></a>

Администратор добавляет слова через `.стоплист + [слово]` (лимит 10 фраз, в Premium-чате — 100). Когда участник пишет стоп-слово, бот удаляет сообщение и применяет выбранное наказание: кик, предупреждение или мут на заданное время. Если наказание не задано — сообщение просто удаляется.

## Что такое арбитры репортов? <a href="#arbiters" id="arbiters"></a>

Арбитры получают и разбирают жалобы из `.репорт`. Управляет ими владелец через `.репорты`, `.+арбитр` и `.-арбитр`.

## Что значит закрыть чат через .-чат? <a href="#close-chat" id="close-chat"></a>

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

## Что такое народный бан (.голосбан)? <a href="#voteban" id="voteban"></a>

Демократическая модерация: любой зарегистрированный участник запускает голосование `.голосбан {пользователь}`, а остальные голосуют кнопкой. При достижении порога голосов нарушитель блокируется автоматически, без участия администрации. Функция выключена по умолчанию — включить и настроить порог (фиксированное число или процент от участников) может только владелец через `.настройки` → «Безопасность» → «Народный бан». Нельзя голосовать за себя или против модераторов/администрации, голосование действует 10 минут.

## Что показывает .досье? <a href="#dossier" id="dossier"></a>

`.досье {пользователь}` — сводка по участнику для модераторов и выше: предупреждения, муты, баны, награды и стаж в чате одним экраном. Указать пользователя можно реплаем, по `@username` или id.

## Что такое тепловая карта чата (.статахит)? <a href="#heatmap" id="heatmap"></a>

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

* **Напрямую:** `.статахит` (алиасы: `.statahit`, `.хитстата`) — не чаще одного построения в минуту на чат.
* **Из статистики:** `.стата` → выберите период → **«Дополнительно»** → **«Тепловая карта»** (тот же лимит).


---

# 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/faq-chastye-voprosy/moderation.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.