GetChatMember

GetChatMember — получает информацию об участнике чата Telegram.

📝 Назначение

Используется для получения статуса пользователя в чате, его прав, информации о блокировках и ограничениях.

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

• Проверить, является ли пользователь администратором
• Узнать, забанен ли пользователь в чате
• Получить информацию о временных ограничениях (тайм-аут)
• Проверить права бота в чате

⚙️ Параметры

📍 Результат

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

${response.result}

Основные поля ответа:

Права администратора (для status = administrator)

Права для ограниченного пользователя (status = restricted)

📊 Возможные значения status

📥 Примеры ответов

Статус: creator (владелец чата)

{
  "ok": true,
  "result": {
    "status": "creator",
    "user": {
      "id": 888999000,
      "is_bot": false,
      "first_name": "Иван",
      "last_name": "Создатель",
      "username": "owner_user"
    },
    "is_anonymous": false,
    "custom_title": "Основатель"
  }
}

Статус: administrator (администратор)

{
  "ok": true,
  "result": {
    "status": "administrator",
    "user": {
      "id": 111222333,
      "is_bot": false,
      "first_name": "Пётр",
      "last_name": "Администратор",
      "username": "admin_user"
    },
    "can_be_edited": true,
    "can_manage_chat": true,
    "can_delete_messages": true,
    "can_restrict_members": true,
    "can_promote_members": false,
    "can_change_info": true,
    "can_invite_users": true,
    "can_pin_messages": true,
    "can_manage_topics": true,
    "custom_title": "Модератор"
  }
}

Статус: member (обычный участник)

{
  "ok": true,
  "result": {
    "status": "member",
    "user": {
      "id": 555666777,
      "is_bot": false,
      "first_name": "Анна",
      "last_name": "Участник",
      "username": "simple_member"
    }
  }
}

Статус: restricted (ограниченный участник)

{
  "ok": true,
  "result": {
    "status": "restricted",
    "is_member": true,
    "can_send_messages": true,
    "can_send_media_messages": false,
    "can_send_polls": false,
    "can_send_other_messages": false,
    "can_add_web_page_previews": false,
    "can_change_info": false,
    "can_invite_users": false,
    "can_pin_messages": false,
    "can_manage_topics": false,
    "until_date": 1725120000,
    "user": {
      "id": 2013629317,
      "is_bot": false,
      "first_name": "Олег",
      "last_name": "Ограниченный",
      "username": "restricted_user"
    }
  }
}

Статус: left (покинул чат)

{
  "ok": true,
  "result": {
    "status": "left",
    "user": {
      "id": 987654321,
      "is_bot": false,
      "first_name": "Дмитрий",
      "last_name": "Покинувший",
      "username": "left_user"
    }
  }
}

Статус: kicked (забанен)

{
  "ok": true,
  "result": {
    "status": "kicked",
    "until_date": 1725120000,
    "user": {
      "id": 112233445,
      "is_bot": false,
      "first_name": "Сергей",
      "last_name": "Заблокированный",
      "username": "kicked_user"
    }
  }
}

📅 Поле until_date

Для статусов kicked (забанен) и restricted (ограничен) в ответе приходит поле until_date — Unix timestamp (количество секунд с 1 января 1970 года), когда блокировка или ограничение будут автоматически сняты.

🔐 Требуемые права бота

⚠️ Важные ограничения

1. Права бота

Для получения полной информации об участнике группы (статусы restricted, kicked, administrator) бот должен быть администратором этой группы. Если бот не администратор, он получит только базовую информацию (статус member или left).

2. Лимиты Telegram API

Метод getChatMember имеет ограничение — не более 30 запросов в секунду на один чат. При превышении лимита Telegram вернёт ошибку 429 Too Many Requests.

💡 Совет: Для массовых операций используйте реакции LoadChatMemberCount и LoadChatAdministrators, которые работают с кэшированными данными.

3. Условие взаимодействия

Реакция работает только для пользователей, которые хотя бы раз взаимодействовали с ботом (отправили сообщение, нажали кнопку). Для проверки пользователя, который никогда не писал боту, используйте условие isChatMember.

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

Пример 1: Проверка статуса пользователя

Задача: Узнать, является ли пользователь администратором чата.

Реакции:

1. GetChatMember → chat.id: ${chat.id}, user.id: ${user.id}
2. TriggerFolder с условием: String → ${response.result.status} = administrator

• Внутри: SendMessage → Пользователь — администратор

Пример 2: Проверка блокировки

Задача: Узнать, забанен ли пользователь в чате.

Реакции:

1. GetChatMember → chat.id: ${chat.id}, user.id: ${user.id}
2. TriggerFolder с условием: String → ${response.result.status} = kicked

• Внутри: SendMessage → Пользователь забанен до ${response.result.until_date}

Пример 3: Проверка прав бота

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

Реакции:

1. GetChatMember → chat.id: ${chat.id}, user.id: ${bot.id}
2. TriggerFolder с условием: Bool → ${response.result.can_restrict_members} = true

• Внутри: SendMessage → Бот может блокировать участников

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

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

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

getChatMember — Telegram Bot API