GetChatMemberCount

GetChatMemberCount — получает количество участников чата или канала.

📝 Назначение

Используется для получения актуальной численности чата/канала.

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

• Проверить, сколько человек в группе
• Статистика активности
• Мониторинг роста/снижения аудитории
• Условия для автоматических действий (например, если в группе > 100 человек)

💡 Совет: Для получения численности из кэша (без запроса к API) используйте реакцию LoadChatMemberCount.

⚙️ Параметры

📍 Результат

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

${response

Тип значения: Integer (целое число) — количество участников чата/канала.

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

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

Пример 1: Получение численности текущего чата

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

Реакции:

1. GetChatMemberCount → chat.id: ${chat.id}
2. SendMessage → текст: В этой группе ${response.result} участников

Пример 2: Условное действие при достижении лимита

Задача: Если в группе больше 100 человек, отправить предупреждение.

Реакции:

1. GetChatMemberCount → chat.id: ${chat.id}
2. TriggerFolder с условием: Number → ${response.result} > 100

• Внутри: SendMessage → Внимание! В группе более 100 участников.

Пример 3: Получение численности по username

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

Реакции:

1. GetChatMemberCount → chat.id: @durov
2. SendMessage → текст: В канале ${response.result} подписчиков

Пример 4: Сравнение с предыдущим значением

Задача: Отслеживать изменение численности (требуется сохранение предыдущего значения).

Реакции:

1. GetChatMemberCount → chat.id: ${chat.id}
2. GetVarCloud → загрузить предыдущее значение prev_count
3. TriggerFolder с условием: сравнение ${response.result} и ${var.person.prev_count}

• Внутри: SendMessage → Изменение: +${разница}

⚠️ Ограничения Telegram API

💡 Совет: Для частых проверок численности используйте LoadChatMemberCount — он работает с кэшированными данными и не имеет ограничений API.

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

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

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

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

getChatMemberCount — Telegram Bot API