GetChat
GetChat — получает полную информацию о чате или канале.
📝 Назначение
Используется для получения актуальных данных о чате: название, тип, ID, пригласительная ссылка, настройки приватности, аватар, закреплённое сообщение и многое другое.
Когда это нужно:
- Получить название чата для отображения пользователю
- Проверить, включён ли режим одобрения заявок (
join_by_request) - Получить пригласительную ссылку (
invite_link) - Узнать настройки медленного режима (
slow_mode_delay) - Получить список активных username (
active_usernames)
💡 Совет: Реакция поддерживает как числовой ID чата, так и @username (для публичных чатов/каналов).
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| chat.id | Integer/String | ✅ Да | ID чата/канала или @username (для публичных) |
📍 Результат
После выполнения реакции результат доступен в переменной:
${response.result}
Структура ответа (основные поля):
| Поле | Тип | Описание |
|---|---|---|
id |
Integer | ID чата/канала |
type |
String | Тип: private, group, supergroup, channel |
title |
String | Название чата/канала |
username |
String | @username (если есть) |
description |
String | Описание чата/канала |
invite_link |
String | Пригласительная ссылка (требуются права) |
photo |
Object | Информация об аватаре чата |
pinned_message |
Object | Закреплённое сообщение |
permissions |
Object | Права по умолчанию для участников |
slow_mode_delay |
Integer | Задержка медленного режима (в секундах) |
join_by_request |
Boolean | Требуется ли одобрение заявок |
join_to_send_messages |
Boolean | Нужно ли вступить, чтобы писать |
has_visible_history |
Boolean | Видна ли история новым участникам |
active_usernames |
Array | Список активных username (для каналов) |
accent_color_id |
Integer | ID цвета акцента |
max_reaction_count |
Integer | Максимальное количество реакций |
📍 Подсказка: Полный список полей зависит от типа чата. Некоторые поля могут отсутствовать.
🔐 Требуемые права бота
| Тип чата | Требуемые права |
|---|---|
| Публичная группа/канал | Не требуются (базовая информация доступна всегда) |
| Приватная группа/канал | Бот должен быть участником чата |
| Получение invite_link | Бот должен быть администратором с правом can_invite_users |
💡 Совет: Для получения пригласительной ссылки бот должен быть администратором.
🧪 Примеры использования
Пример 1: Получение информации о текущем чате
Задача: Узнать название и тип чата, откуда пришло сообщение.
Реакции:
GetChat→chat.id:${chat.id}SendMessage→ текст:
Название чата: ${response.result.title}
Тип чата: ${response.result.type}
ID чата: ${response.result.id}
Пример 2: Проверка режима одобрения заявок
Задача: Проверить, включён ли в группе режим одобрения заявок.
Реакции:
GetChat→chat.id:${chat.id}TriggerFolderс условием:Bool→${response.result.join_by_request}=true
- Внутри:
SendMessage→В этой группе требуется одобрение заявок.
Пример 3: Получение информации по username
Задача: Получить информацию о публичном канале по его @username.
Реакции:
GetChat→chat.id:@durovSendMessage→ текст:Название канала: ${response.result.title}
Пример 4: Получение пригласительной ссылки
Задача: Создать/получить пригласительную ссылку для группы (бот должен быть админом).
Реакции:
GetChat→chat.id:${chat.id}SendMessage→ текст:Ссылка для приглашения: ${response.result.invite_link}
⚠️ Важно:
invite_linkможет отсутствовать, если у бота нет прав или ссылка не создана.
📊 Пример ответа (развёрнутый)
{
"ok": true,
"result": {
"id": -100123456789,
"type": "supergroup",
"title": "Моя супергруппа",
"username": "my_supergroup",
"description": "Описание группы",
"invite_link": "https://t.me/+abc123xyz",
"join_by_request": true,
"join_to_send_messages": false,
"has_visible_history": true,
"slow_mode_delay": 30,
"permissions": {
"can_send_messages": true,
"can_send_media_messages": true,
"can_send_polls": true,
"can_send_other_messages": true,
"can_add_web_page_previews": true,
"can_change_info": false,
"can_invite_users": true,
"can_pin_messages": false
},
"photo": {
"small_file_id": "AQAD...",
"big_file_id": "AQAD..."
},
"active_usernames": ["my_supergroup", "my_group_alt"]
}
}
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| GetChatAdministrators | Получить список администраторов |
| GetChatMemberCount | Получить количество участников |
| GetChatMember | Получить информацию об участнике |
| LoadChat | Загрузить данные из базы бота (кэш) |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Чаты/Каналы в админке | Управление чатами через интерфейс |
🔗 Быстрая навигация
- Вверх
- Параметры
- Результат
- Требуемые права
- Примеры
- Частые ошибки