Метод setChatAdministratorCustomTitle

Описание

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

Параметр	Тип	Обязательный	Описание
chat_id	Integer или String	Да	Уникальный идентификатор целевого чата или имя пользователя целевой супергруппы (в формате `@supergroupusername`)
user_id	Integer	Да	Уникальный идентификатор целевого пользователя
custom_title	String	Да	Новый пользовательский заголовок для администратора; 0-16 символов, эмодзи не допускаются

Примеры

php

<?php

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

// Параметры для метода setChatAdministratorCustomTitle
$chatId = -1001234567890; // ID супергруппы или @supergroupusername
$userId = 123456789; // ID пользователя-администратора
$customTitle = "Senior Mod"; // Новый кастомный заголовок (0-16 символов)

// Формируем данные для запроса
$data = [
    'chat_id' => $chatId,
    'user_id' => $userId,
    'custom_title' => $customTitle
];

// Отправляем запрос
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl . 'setChatAdministratorCustomTitle');
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 . 'setChatAdministratorCustomTitle?' . http_build_query($data);
$response = file_get_contents($url);
$result = json_decode($response, true);
*/

?>

python

import requests

def set_chat_administrator_custom_title(bot_token, chat_id, user_id, custom_title):
    """
    Устанавливает кастомный заголовок для администратора в супергруппе.
    
    Args:
        bot_token (str): Токен вашего бота
        chat_id (int or str): ID чата или username супергруппы
        user_id (int): ID пользователя
        custom_title (str): Новый кастомный заголовок (0-16 символов, без эмодзи)
    
    Returns:
        bool: True при успехе, иначе False
    """
    url = f"https://api.telegram.org/bot{bot_token}/setChatAdministratorCustomTitle"
    
    payload = {
        "chat_id": chat_id,
        "user_id": user_id,
        "custom_title": custom_title
    }
    
    try:
        response = requests.post(url, json=payload)
        response.raise_for_status()
        result = response.json()
        
        if result.get("ok"):
            return True
        else:
            print(f"Ошибка: {result.get('description')}")
            return False
            
    except requests.exceptions.RequestException as e:
        print(f"Ошибка запроса: {e}")
        return False
    except ValueError as e:
        print(f"Ошибка парсинга JSON: {e}")
        return False

# Пример использования
if __name__ == "__main__":
    BOT_TOKEN = "ВАШ_ТОКЕН_БОТА"
    
    # Пример с ID чата
    success = set_chat_administrator_custom_title(
        bot_token=BOT_TOKEN,
        chat_id=-1001234567890,  # ID супергруппы
        user_id=123456789,        # ID администратора
        custom_title="Старший модератор"
    )
    
    if success:
        print("Кастомный заголовок успешно установлен!")
    else:
        print("Не удалось установить кастомный заголовок.")

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

API 4.5. Добавлен метод setChatAdministratorCustomTitle