LoadChatAdministrators

LoadChatAdministrators — загружает список администраторов чата из базы данных бота (кэш).

📝 Назначение

В отличие от GetChatAdministrators, который обращается к Telegram API за актуальными данными, LoadChatAdministrators загружает список администраторов из собственной базы данных бота (кэш). Это быстрее, не тратит лимиты API и не требует прав администратора для получения базовой информации.

Когда это нужно:

• Быстрое получение списка администраторов чата
• Когда не требуется абсолютная актуальность данных
• При работе с чатами, где бот не является администратором (в кэше могут быть данные от последнего взаимодействия)

💡 Совет: Используйте LoadChatAdministrators для быстрых операций, где не критична актуальность. Для получения свежих данных (например, только что назначенного администратора) используйте GetChatAdministrators.

⚙️ Параметры

📍 Результат

После выполнения реакции результат доступен в переменной:

${load}

Структура ответа — массив объектов, каждый из которых описывает одного администратора.

Пример ответа:

[
  {
    "status": "creator",
    "is_anonymous": false,
    "user": {
      "id": 123456789,
      "first_name": "Иван",
      "last_name": "Создатель",
      "username": "creator",
      "is_bot": false
    },
    "custom_title": "Основатель"
  },
  {
    "status": "administrator",
    "is_anonymous": false,
    "user": {
      "id": 987654321,
      "first_name": "Пётр",
      "last_name": "Админ",
      "username": "admin",
      "is_bot": false
    },
    "can_be_edited": true,
    "can_manage_chat": true,
    "can_delete_messages": true,
    "can_restrict_members": true,
    "custom_title": "Модератор"
  }
]

🔄 Сравнение с GetChatAdministrators

💡 Совет: Используйте LoadChatAdministrators для быстрого доступа к списку администраторов. Если нужно гарантированно получить актуальные права (например, после назначения нового админа), используйте GetChatAdministrators.

🧪 Примеры использования

Пример 1: Получение списка администраторов из кэша

Задача: Быстро получить имена всех администраторов чата.

Реакции:

1. LoadChatAdministrators → chat.id: ${chat.id}
2. (Обработка массива администраторов)
3. SendMessage → текст с перечислением администраторов

Пример 2: Проверка, является ли пользователь администратором

Задача: Проверить по кэшу, есть ли отправитель в списке администраторов.

Реакции:

1. LoadChatAdministrators → chat.id: ${chat.id}
2. TriggerFolder с условием: поиск user.id в массиве ${load.*.user.id}

• Внутри: (пользователь — администратор)
• Иначе: (обычный пользователь)

Пример 3: Нахождение создателя чата

Задача: Найти владельца чата (status = creator).

Реакции:

1. LoadChatAdministrators → chat.id: ${chat.id}
2. (Поиск элемента с status = creator в массиве)
3. SendMessage → Владелец чата: ${creator_name}

🔗 Связанные реакции

🔗 Связанные разделы

🔗 Связанные разделы

• GetChatAdministrators — получение актуальных данных из Telegram API