Сетевые логи

Настройка и проверка доставки логов.

Сетевые логи отправляют события модерации в отдельную Telegram-группу или канал. Дашборд показывает состояние и управляет доставкой, а сами события приходят в Telegram.

Подключение лог-чата

  1. Создайте отдельную группу или канал для операторов.
  2. Добавьте туда GramGroupsBot администратором и разрешите ему отправлять сообщения.
  3. Отправьте в этом чате команду:
/logs
  1. Откройте страницу состояния в дашборде:
/logs

Команда в Telegram назначает текущий чат получателем логов. На странице /logs можно проверить получателя, включить, выключить или удалить доставку.

Настраивать получателя должны owner или admin. Не используйте для логов пользовательский чат с обычным обсуждением.

Как работает доставка сейчас

Публичный сценарий настраивает один общий поток (single_feed). Режимы с темами и автоматическим роутингом встречаются во внутренних ветках кода, но не доступны в интерфейсе и не являются поддерживаемым способом настройки.

Каждое сообщение лога содержит данные исходной группы, поэтому события разных сообществ можно различить в одном чате.

Что попадает в логи

  • удаление сообщения и ошибки удаления;
  • отправка приветствия и ошибки отправки;
  • исходная группа;
  • причина срабатывания и совпавшее значение, если оно доступно;
  • Telegram ID пользователя, если он доступен;
  • время события.

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

Если логи не приходят

Проверьте:

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

Ошибка доставки лога не должна останавливать само действие модерации. Для проверки правила используйте Диагностику.