Диагностика

Ниже — самые частые проблемы и быстрые проверки.

1. Бот не удаляет сообщения

Проверьте по порядку:

1. Группа подключена и имеет статус active.
2. Правило назначено на эту группу.
3. Правило включено (active/enabled).
4. У бота есть право Delete messages.
5. Сообщение действительно попадает под условие правила.

Если всё верно, учитывайте короткую задержку обновления runtime cache.

2. /connect не работает

Проверьте:

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

3. /banall или /muteall срабатывает частично

Это нормальный сценарий при разных правах бота в группах.

Проверьте:

• право Restrict members для /banall и /muteall;
• что все целевые группы подключены и активны.

4. Фильтр ссылок «пропускает» ссылку

Проверьте:

1. правильный режим (block_all, block_listed, allow_approved);
2. нормализованный домен в списке;
3. Telegram-флаги (invite/public links), если нужен контроль именно t.me.

5. Required words удаляет «правильные» сообщения

Проверьте:

• фактическое наличие нужного слова/фразы после нормализации;
• отсутствие конфликта нескольких списков;
• что сообщение не reply, если текущая логика для reply отличается.

6. Логи не приходят в Telegram

Проверьте:

1. команда /logs была отправлена в нужном лог-чате;
2. бот есть в лог-чате и может отправлять сообщения;
3. доставка включена на странице /logs.

7. Группа есть в дашборде, но не модерируется

Обычно причина в одном из пунктов:

• статус группы paused/disconnected;
• правило не назначено;
• нет права удаления сообщений;
• обновление кэша ещё не дошло.

8. Неочевидное поведение из-за порядка правил

Порядок проверок:

1. blocked users
2. stop words
3. link filter
4. required words (может пропускаться для reply)
5. rate limits

Если сработало раннее правило, последующие уже не проверяются.

9. Чеклист перед обращением в поддержку

Подготовьте:

• Telegram chat ID группы;
• точное время инцидента;
• текст тестового сообщения;
• скрин прав бота;
• список назначенных правил;
• фрагмент из сетевых логов (если включены).