Диагностика

Частые проблемы и быстрые исправления.

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

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

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

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

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

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

Проверьте:

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

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

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

Проверьте:

  • право ban users для /banall;
  • право restrict members для /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. destination chat указан корректно;
  2. бот есть в лог-чате;
  3. у бота есть право отправки сообщений;
  4. логирование включено.

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

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

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

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

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

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

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

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

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

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