Метод setCustomEmojiStickerSetThumbnail

Метод устанавливает миниатюру для набора стикеров с пользовательскими эмодзи.

Описание

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

Параметр Тип Обязательный Описание
name String Да Название набора стикеров
custom_emoji_id String Опционально Идентификатор пользовательского эмодзи стикера из набора; передайте пустую строку, чтобы удалить миниатюру и использовать первый стикер в качестве миниатюры.

Примеры

php

<?php

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

// Параметры для метода setCustomEmojiStickerSetThumbnail
$params = [
    'name' => 'YourStickerSetName', // Обязательный параметр
    'custom_emoji_id' => 'CustomEmojiId123' // Опциональный параметр
];

// Инициализация cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl . 'setCustomEmojiStickerSetThumbnail');
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);
curl_close($ch);

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

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

// Пример с удалением thumbnail (передаем пустую строку)
/*
$paramsRemove = [
    'name' => 'YourStickerSetName',
    'custom_emoji_id' => ''
];
*/
?>

python

import requests

def set_custom_emoji_sticker_set_thumbnail(bot_token, name, custom_emoji_id=None):
    """
    Устанавливает миниатюру для набора стикеров с пользовательскими эмодзи.
    
    Args:
        bot_token (str): Токен вашего бота
        name (str): Название набора стикеров
        custom_emoji_id (str, optional): ID пользовательского эмодзи из набора стикеров.
                                         Если None или пустая строка - удаляет миниатюру.
    
    Returns:
        bool: True в случае успеха, иначе False
    """
    url = f"https://api.telegram.org/bot{bot_token}/setCustomEmojiStickerSetThumbnail"
    
    payload = {
        "name": name
    }
    
    if custom_emoji_id is not None:
        payload["custom_emoji_id"] = custom_emoji_id
    
    try:
        response = requests.post(url, json=payload)
        result = response.json()
        
        if result.get("ok"):
            return True
        else:
            print(f"Ошибка: {result.get('description')}")
            return False
            
    except Exception as e:
        print(f"Ошибка при выполнении запроса: {e}")
        return False

# Пример использования:
if __name__ == "__main__":
    # Замените на реальный токен вашего бота
    BOT_TOKEN = "ВАШ_ТОКЕН_БОТА"
    
    # Пример 1: Установить миниатюру с пользовательским эмодзи
    sticker_set_name = "MyCustomEmojiPack"
    emoji_id = "AgADBAADwqcxG"  # Пример ID пользовательского эмодзи
    
    success = set_custom_emoji_sticker_set_thumbnail(
        BOT_TOKEN,
        name=sticker_set_name,
        custom_emoji_id=emoji_id
    )
    
    if success:
        print(f"Миниатюра для набора '{sticker_set_name}' успешно установлена!")
    
    # Пример 2: Удалить миниатюру (использовать первый стикер как миниатюру)
    success = set_custom_emoji_sticker_set_thumbnail(
        BOT_TOKEN,
        name=sticker_set_name,
        custom_emoji_id=""  # Пустая строка удаляет миниатюру
    )
    
    if success:
        print(f"Миниатюра для набора '{sticker_set_name}' удалена!")

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

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