Справочник правил.

Группы

Группа — это подключённый Telegram-чат и его назначения правил. Правило влияет на группу только если группа активна, правило включено, правило назначено и у бота есть нужные права Telegram.

Статусы и биллинг

• Статусы: active, paused, error, disconnected.
• Billing status: billable или non_billable.
• Когда группа тарифицируется: только при active и billable.

Модель назначений

• Одно правило на группу: фильтр ссылок, лимиты сообщений, приветствия.
• Списочные правила: стоп-слова, обязательные слова, заблокированные пользователи.

Стоп-слова

Стоп-слова — это переиспользуемые списки слов и фраз. Если текст сообщения или подписи совпал с активным назначенным списком, бот пытается удалить сообщение.

Поведение

• Матчинг без учёта регистра для слов и фраз.
• По умолчанию создаётся список Global stop words и назначается на группы.
• Нормализация ловит обфускацию через разделители, например s.p.a.m.

Ограничения

• Только удаление сообщения (без встроенного бан/мут).
• Нет regex и wildcard-синтаксиса.

Практическое объяснение с примерами фраз и частыми ошибками - в гиде по стоп-словам.

Один список стоп-слов для многих Telegram-групп - как общие стоп-слова работают на уровне сети.

Обязательные слова

Обязательные слова требуют наличие хотя бы одного заданного слова или фразы. Если совпадений нет, бот удаляет сообщение.

Порядок в runtime

• Проверяются после blocked users, stop words и link filter.
• Проверка reply-сообщений может быть пропущена текущей runtime-логикой.
• Проверяются текст сообщения и подписи к медиа.

Ограничения

• Нет regex и wildcard.
• Нет режима предупреждения вместо удаления.

Ссылки

Правила ссылок удаляют сообщения со ссылками по выбранному режиму и спискам доменов.

Режимы

• Block all links (block_all).
• Block listed domains (block_listed).
• Allow only approved domains (allow_approved).

Охват и флаги

• Одно активное правило ссылок на группу.
• Telegram-флаги: удалять invite-ссылки и публичные Telegram-ссылки.
• Wildcard-домены (например *.example.com) не поддерживаются.

Гид по фильтру ссылок в Telegram — запрет всех ссылок, blocklist, approved domains и правила invite links.

Лимиты сообщений

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

Модель правила

• Параметры: max_messages и window_seconds.
• Одно активное правило лимитов на группу.
• Проверка выполняется последней в стандартной цепочке модерации.

Особенности runtime

• Счётчики хранятся в памяти и сбрасываются при рестарте runtime.
• Типичные стартовые значения: 5 сообщений / 60 секунд.

Приветственные сообщения

Приветственные сообщения отправляют шаблон при входе нового участника в подключённую группу.

Поведение шаблонов

• Одно активное приветствие на группу.
• Поддерживается подстановка данных пользователя с fallback-значением при отсутствии данных.
• Собственное событие входа бота игнорируется.

Ограничения

• Нет расширенного шаблонизатора и визуального конструктора.
• Нет кнопок и медиа-вложений.

Массовые действия

Массовые действия запускают кросс-групповую модерацию по активным группам аккаунта.

Поддерживаемые команды

Команды в одной группе:

• /ban — забанить пользователя в этой группе.
• /mute — замутить пользователя в этой группе на 24 часа.
• /unban — разбанить пользователя в этой группе.
• /unmute — снять мут в этой группе.

Команды по всей сети (все активные группы):

• /banall — забанить во всех активных группах.
• /muteall — замутить во всех активных группах.
• /unbanall — разбанить во всех активных группах.
• /unmuteall — снять мут во всех активных группах.

Модель выполнения

• Надёжный сценарий: отправить команду в reply на сообщение целевого пользователя.
• Сетевые команды выполняются асинхронно и могут завершиться частичным успехом.
• Группы без прав бота или неактивные группы пропускаются.
• Доступ требует роли owner, admin или manager в аккаунте.

Заблокированные пользователи

Списки blocked users сопоставляют Telegram ID или username и удаляют сообщения совпавших отправителей в назначенных группах.

Поведение

• Проверяются первыми в цепочке модерации.
• Принимают числовые Telegram ID и username.
• Это списочное удаление сообщений, а не автоматический бан/мут.

Ограничения

• Нет срока блокировки внутри этого правила.
• Для мгновенного кросс-группового бан/мут используйте массовые действия.