Группы и назначения правил

Модель групп, статусы и поведение назначений.

Страница Groups — основная точка управления подключёнными Telegram-группами и назначениями правил.

Поля группы

Для каждой группы хранятся:

  • Telegram chat ID;
  • заголовок группы из Telegram;
  • внутренний label (опционально);
  • username группы (если есть);
  • тип: group, supergroup, channel;
  • статус: active, paused, error, disconnected;
  • billing status: billable или non_billable;
  • статус и права бота;
  • дата подключения;
  • last seen.

Статусы группы

active

Группа включена. Модерация может работать при наличии прав у бота.

paused

Группа выключена и не тарифицируется.

error

Система зафиксировала проблему по группе.

disconnected

Группа больше не активна в аккаунте и не тарифицируется.

Биллинг-статус

Группа billable только если:

  1. статус active;
  2. billing status = billable.

Внутренний label

Label — это название для операторов внутри панели, не меняющее заголовок в Telegram.

Примеры:

Main EN community
Main RU community
VIP support group
Partner announcements

Базовая модель назначения

Правило влияет на группу только если одновременно:

  1. группа подключена и active;
  2. правило включено;
  3. правило назначено на группу;
  4. у бота есть нужное право Telegram.

Интерпретация счётчиков назначений

  • Not assigned — правило никуда не назначено.
  • All N groups — покрыты все группы.
  • X of N groups — покрыта часть групп.

Типы правил с ограничением «одно на группу»

Для группы одновременно может быть только одно активное правило:

Списочные типы правил

Списки работают через rule sets:

Их можно назначать через страницы правил и через страницу групп.

Group Sets

Group Set — сохранённая выборка групп для массовых операций назначения.

Примеры:

  • Public communities
  • VIP groups
  • Regional groups
  • Test groups

Если Group Set отключён, runtime не учитывает его в итоговом разрешении назначений.

Runtime cache

Runtime использует in-memory кэш. После изменения правил и назначений возможна короткая задержка до применения (обычно до минуты).