LoadChat
LoadChat — загружает данные о чате из базы данных бота (кэш).
📝 Назначение
В отличие от GetChat, который обращается к Telegram API за актуальными данными, LoadChat загружает информацию о чате из собственной базы данных бота (кэш). Это быстрее и не тратит лимиты API.
Когда это нужно:
- Быстрое получение базовой информации о чате (ID, название, тип, username)
- Когда не требуется абсолютная актуальность данных
- При работе с чатами, где бот не является администратором (и
GetChatможет быть ограничен)
💡 Совет: Используйте
LoadChatдля быстрых операций, где не критична актуальность. Для получения свежих данных (например, проверки нового названия чата) используйтеGetChat.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat.id | Integer/String | ✅ Да | ID чата/канала для загрузки из кэша |
📍 Результат
После выполнения реакции результат доступен в переменной:
${load}
Структура ответа:
| Поле | Тип | Описание |
|---|---|---|
id |
Integer | ID чата/канала |
title |
String | Название чата/канала |
type |
String | Тип: private, group, supergroup, channel |
username |
String | @username (если есть) |
Пример ответа:
{
"id": -100123456789,
"title": "Моя супергруппа",
"type": "supergroup",
"username": "my_supergroup"
}
🔄 Сравнение с GetChat
| Характеристика | LoadChat | GetChat |
|---|---|---|
| Источник данных | База данных бота (кэш) | Telegram API (актуальные) |
| Скорость | Быстро (локальный кэш) | Медленнее (запрос к API) |
| Лимиты API | ❌ Нет | ✅ Да (30 запросов/сек) |
| Актуальность | Может отставать | Абсолютная |
| Полнота данных | Базовая (id, title, type, username) | Полная (все поля, включая права, фото и т.д.) |
| Требует прав админа | Нет (достаточно быть в чате) | Для некоторых полей — да |
💡 Совет: Используйте
LoadChatдля быстрого доступа к базовой информации. Для получения полных данных (например,invite_link,permissions,pinned_message) используйтеGetChat.
🧪 Примеры использования
Пример 1: Получение названия чата из кэша
Задача: Быстро получить название чата, откуда пришло сообщение.
Реакции:
LoadChat→chat.id:${chat.id}SendMessage→ текст:Название чата (из кэша): ${load.title}
Пример 2: Проверка username чата
Задача: Узнать, есть ли у чата username.
Реакции:
LoadChat→chat.id:${chat.id}TriggerFolderс условием:Has→${load.username}
- Внутри:
SendMessage→Username чата: @${load.username} - Иначе:
SendMessage→У чата нет username
Пример 3: Проверка типа чата
Задача: Определить, является ли чат супергруппой.
Реакции:
LoadChat→chat.id:${chat.id}TriggerFolderс условием:String→${load.type}=supergroup
- Внутри:
SendMessage→Это супергруппа
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| GetChat | Получить актуальные данные из Telegram API |
| LoadChatAdministrators | Загрузить администраторов из кэша |
| LoadChatMemberCount | Загрузить численность из кэша |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Чаты/Каналы в админке | Управление чатами через интерфейс |
🔗 Связанные разделы
- GetChat — получение актуальных данных из Telegram API