Метод promoteChatMember

Описание

Примеры

php

<?php

$botToken = 'YOUR_BOT_TOKEN';
$apiUrl = "https://api.telegram.org/bot{$botToken}/";

// Пример данных для повышения пользователя до администратора
$chatId = -1001234567890; // ID супергруппы или канала (отрицательное число)
$userId = 123456789; // ID пользователя, которого повышаем

// Параметры для повышения (установка прав администратора)
$params = [
    'chat_id' => $chatId,
    'user_id' => $userId,
    'is_anonymous' => false,
    'can_manage_chat' => true,
    'can_delete_messages' => true,
    'can_manage_video_chats' => true,
    'can_restrict_members' => true,
    'can_promote_members' => false, // Обычно не даём право повышать других
    'can_change_info' => true,
    'can_invite_users' => true,
    'can_post_stories' => false,
    'can_edit_stories' => false,
    'can_delete_stories' => false,
    'can_post_messages' => true, // Для каналов
    'can_edit_messages' => true, // Для каналов
    'can_pin_messages' => true, // Для супергрупп
    'can_manage_topics' => true, // Для супергрупп с форумами
    'can_manage_direct_messages' => false, // Для каналов
];

// Пример для понижения пользователя (все параметры false)
$demoteParams = [
    'chat_id' => $chatId,
    'user_id' => $userId,
    'is_anonymous' => false,
    'can_manage_chat' => false,
    'can_delete_messages' => false,
    'can_manage_video_chats' => false,
    'can_restrict_members' => false,
    'can_promote_members' => false,
    'can_change_info' => false,
    'can_invite_users' => false,
    'can_post_stories' => false,
    'can_edit_stories' => false,
    'can_delete_stories' => false,
    'can_post_messages' => false,
    'can_edit_messages' => false,
    'can_pin_messages' => false,
    'can_manage_topics' => false,
    'can_manage_direct_messages' => false,
];

// Функция для отправки запроса
function promoteChatMember($apiUrl, $params) {
    $url = $apiUrl . 'promoteChatMember';
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    
    if (curl_errno($ch)) {
        $error = curl_error($ch);
        curl_close($ch);
        return ['ok' => false, 'error' => "cURL Error: {$error}"];
    }
    
    curl_close($ch);
    
    if ($httpCode !== 200) {
        return ['ok' => false, 'error' => "HTTP Error: {$httpCode}"];
    }
    
    return json_decode($response, true);
}

// Пример использования для повышения
$result = promoteChatMember($apiUrl, $params);

if ($result['ok']) {
    echo "Пользователь успешно повышен до администратора!\n";
} else {
    echo "Ошибка: " . ($result['description'] ?? $result['error'] ?? 'Неизвестная ошибка') . "\n";
}

// Альтернативный вариант с использованием file_get_contents (требует allow_url_fopen)
function promoteChatMemberAlt($apiUrl, $params) {
    $url = $apiUrl . 'promoteChatMember?' . http_build_query($params);
    
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'ignore_errors' => true,
        ],
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        return ['ok' => false, 'error' => 'Failed to get response'];
    }
    
    return json_decode($response, true);
}

// Пример с использованием имени пользователя канала
$channelParams = [
    'chat_id' => '@my_channel', // Использование username канала
    'user_id' => $userId,
    'can_post_messages' => true,
    'can_edit_messages' => true,
    'can_manage_direct_messages' => true,
    // Остальные параметры false или не указаны
];

// $result = promoteChatMember($apiUrl, $channelParams);

python

import asyncio
from telegram import Bot
from telegram.constants import ChatAdministratorRights

async def promote_user():
    bot = Bot(token="YOUR_BOT_TOKEN")
    
    # Параметры для повышения пользователя до администратора
    chat_id = -1001234567890  # ID супергруппы или канала
    user_id = 123456789  # ID пользователя
    
    # Создаем права администратора
    rights = ChatAdministratorRights(
        is_anonymous=False,
        can_manage_chat=True,
        can_delete_messages=True,
        can_manage_video_chats=True,
        can_restrict_members=True,
        can_promote_members=False,  # Не даем право назначать других администраторов
        can_change_info=True,
        can_invite_users=True,
        can_post_stories=False,
        can_edit_stories=False,
        can_delete_stories=False,
        can_post_messages=True,  # Для каналов
        can_edit_messages=True,  # Для каналов
        can_pin_messages=True,  # Для супергрупп
        can_manage_topics=True,  # Для супергрупп с форумами
        can_manage_direct_messages=True  # Для каналов
    )
    
    try:
        # Повышение пользователя
        result = await bot.promote_chat_member(
            chat_id=chat_id,
            user_id=user_id,
            **rights.to_dict()
        )
        
        if result:
            print("Пользователь успешно повышен до администратора")
        else:
            print("Не удалось повысить пользователя")
            
    except Exception as e:
        print(f"Ошибка: {e}")

# Альтернативный вариант с явным указанием параметров
async def promote_user_alternative():
    bot = Bot(token="YOUR_BOT_TOKEN")
    
    try:
        # Повышение с минимальными правами
        result = await bot.promote_chat_member(
            chat_id="@channelusername",
            user_id=123456789,
            can_change_info=True,
            can_delete_messages=True,
            can_invite_users=True,
            can_restrict_members=True,
            can_pin_messages=True,
            can_promote_members=False  # Важно ограничить это право для безопасности
        )
        
        print(f"Результат: {result}")
        
    except Exception as e:
        print(f"Ошибка: {e}")

# Пример понижения пользователя (demote)
async def demote_user():
    bot = Bot(token="YOUR_BOT_TOKEN")
    
    try:
        # Понижение пользователя - передаем False для всех boolean параметров
        result = await bot.promote_chat_member(
            chat_id=-1001234567890,
            user_id=123456789,
            is_anonymous=False,
            can_manage_chat=False,
            can_delete_messages=False,
            can_manage_video_chats=False,
            can_restrict_members=False,
            can_promote_members=False,
            can_change_info=False,
            can_invite_users=False,
            can_post_stories=False,
            can_edit_stories=False,
            can_delete_stories=False,
            can_post_messages=False,
            can_edit_messages=False,
            can_pin_messages=False,
            can_manage_topics=False,
            can_manage_direct_messages=False
        )
        
        if result:
            print("Пользователь успешно понижен")
            
    except Exception as e:
        print(f"Ошибка: {e}")

# Запуск асинхронной функции
if __name__ == "__main__":
    asyncio.run(promote_user())

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

• API 3.1. Добавлен метод promoteChatMember
• API 5.0. Обновлен метод promoteChatMember: Добавлен параметр is_anonymous
• API 5.1. Обновлен метод promoteChatMember: Добавлены параметры can_manage_voice_chats и can_manage_chat
• API 6.0. Обновлен метод promoteChatMember: Переименован параметр can_manage_voice_chats в can_manage_video_chats
• API 6.3. Обновлен метод promoteChatMember: Добавлен параметр can_manage_topics
• API 6.9. Обновлен метод promoteChatMember: Добавлены параметры: can_post_stories, can_edit_stories, can_delete_stories
• API 9.2. Обновлен метод promoteChatMember: Добавлен параметр can_manage_direct_messages