Метод getChatMemberCount

Метод для получения количества участников в чате Telegram.

Описание

Используйте этот метод, чтобы получить количество участников в чате. Возвращает Int при успешном выполнении.

Параметр Тип Обязательный Описание
chat_id Integer или String Да Уникальный идентификатор целевого чата или имя пользователя целевой супергруппы или канала (в формате @channelusername)

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$chatId = '@channelusername'; // или числовой ID

$url = "https://api.telegram.org/bot{$botToken}/getChatMemberCount";

$data = [
    'chat_id' => $chatId
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: multipart/form-data']);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['ok']) {
    $memberCount = $result['result'];
    echo "Количество участников: " . $memberCount;
} else {
    echo "Ошибка: " . $result['description'];
}

// Альтернативный вариант с file_get_contents
/*
$url = "https://api.telegram.org/bot{$botToken}/getChatMemberCount?" . http_build_query($data);
$response = file_get_contents($url);
$result = json_decode($response, true);

if ($result['ok']) {
    echo "Количество участников: " . $result['result'];
}
*/
?>

python

import requests

def get_chat_member_count(bot_token, chat_id):
    """
    Получает количество участников в чате.
    
    Args:
        bot_token (str): Токен вашего бота
        chat_id (int or str): ID чата или username канала/супергруппы
    
    Returns:
        int: Количество участников или None в случае ошибки
    """
    url = f"https://api.telegram.org/bot{bot_token}/getChatMemberCount"
    
    params = {
        'chat_id': chat_id
    }
    
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        data = response.json()
        
        if data.get('ok'):
            return data.get('result')
        else:
            print(f"Ошибка: {data.get('description')}")
            return None
            
    except requests.exceptions.RequestException as e:
        print(f"Ошибка запроса: {e}")
        return None
    except ValueError as e:
        print(f"Ошибка парсинга JSON: {e}")
        return None

# Пример использования
if __name__ == "__main__":
    # Замените на ваш токен бота
    BOT_TOKEN = "YOUR_BOT_TOKEN"
    
    # Примеры chat_id:
    # 1. По ID чата (число)
    chat_id_by_number = -1001234567890
    
    # 2. По username канала/супергруппы
    chat_id_by_username = "@channelusername"
    
    # Получаем количество участников
    member_count = get_chat_member_count(BOT_TOKEN, chat_id_by_number)
    
    if member_count is not None:
        print(f"Количество участников в чате: {member_count}")

История изменений

  • API 5.3. Добавлен метод getChatMemberCount
Комментарии