Метод unbanChatSenderChat

Описание

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

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

Примеры

php

<?php

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

// Параметры метода
$chatId = -1001234567890; // ID супергруппы или канала
$senderChatId = -1009876543210; // ID разблокируемого канала

// Подготовка данных
$data = [
    'chat_id' => $chatId,
    'sender_chat_id' => $senderChatId
];

// Отправка запроса
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl . 'unbanChatSenderChat');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

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

// Обработка ответа
$result = json_decode($response, true);
if ($result['ok']) {
    echo "Канал успешно разблокирован!";
} else {
    echo "Ошибка: " . $result['description'];
}

// Альтернативный вариант с использованием file_get_contents
/*
$url = $apiUrl . 'unbanChatSenderChat?' . http_build_query($data);
$response = file_get_contents($url);
$result = json_decode($response, true);
*/

// Вариант для библиотеки TelegramBotPHP (если используется)
/*
$telegram = new Telegram($botToken);
$result = $telegram->unbanChatSenderChat([
    'chat_id' => $chatId,
    'sender_chat_id' => $senderChatId
]);
*/
?>

python

import requests

BOT_TOKEN = "YOUR_BOT_TOKEN_HERE"

def unban_chat_sender_chat(chat_id, sender_chat_id):
    """
    Разбанить ранее забаненный канал в супергруппе или канале.
    
    Args:
        chat_id (int | str): ID чата или username канала (например, @channelusername)
        sender_chat_id (int): ID разбаниваемого канала
    
    Returns:
        bool: True в случае успеха
    """
    url = f"https://api.telegram.org/bot{BOT_TOKEN}/unbanChatSenderChat"
    
    payload = {
        "chat_id": chat_id,
        "sender_chat_id": sender_chat_id
    }
    
    response = requests.post(url, json=payload)
    result = response.json()
    
    if result.get("ok"):
        return True
    else:
        print(f"Ошибка: {result.get('description')}")
        return False

# Пример использования:
if __name__ == "__main__":
    # Разбанить канал с ID -1001234567890 в супергруппе
    success = unban_chat_sender_chat(
        chat_id=-1001234567890,  # ID супергруппы
        sender_chat_id=-1009876543210  # ID разбаниваемого канала
    )
    
    if success:
        print("Канал успешно разбанен!")
    else:
        print("Не удалось разбанить канал")

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

API 5.5. Добавлен метод unbanChatSenderChat