EnotPRO Logo EnotPRO

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: Получение информации о текущем чате

Задача: Узнать название и тип чата, откуда пришло сообщение.

Реакции:

  1. GetChatchat.id: ${chat.id}
  2. SendMessage → текст:
Название чата: ${response.result.title}
Тип чата: ${response.result.type}
ID чата: ${response.result.id}

Пример 2: Проверка режима одобрения заявок

Задача: Проверить, включён ли в группе режим одобрения заявок.

Реакции:

  1. GetChatchat.id: ${chat.id}
  2. TriggerFolder с условием: Bool${response.result.join_by_request} = true
  • Внутри: SendMessageВ этой группе требуется одобрение заявок.

Пример 3: Получение информации по username

Задача: Получить информацию о публичном канале по его @username.

Реакции:

  1. GetChatchat.id: @durov
  2. SendMessage → текст: Название канала: ${response.result.title}

Пример 4: Получение пригласительной ссылки

Задача: Создать/получить пригласительную ссылку для группы (бот должен быть админом).

Реакции:

  1. GetChatchat.id: ${chat.id}
  2. 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 Загрузить данные из базы бота (кэш)

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

Раздел Описание
Чаты/Каналы в админке Управление чатами через интерфейс

🔗 Быстрая навигация

  • Вверх
  • Параметры
  • Результат
  • Требуемые права
  • Примеры
  • Частые ошибки

🔗 Ссылка на официальную документацию

getChat — Telegram Bot API

© 2025 EnotPRO. Все права защищены.