GetForumTopicIconStickers

GetForumTopicIconStickers — получает список пользовательских стикеров-эмодзи для использования в качестве иконок тем форума.

📝 Назначение

Используется для получения идентификаторов (custom_emoji_id) пользовательских эмодзи, которые можно установить как иконку темы при создании или редактировании через createforumtopic или editforumtopic.

Когда это нужно:

• Получить список доступных эмодзи для иконок тем
• Найти custom_emoji_id конкретного эмодзи для использования в других реакциях

💡 Совет: Всего доступно 112 пользовательских эмодзи для иконок тем форума.

⚙️ Параметры

📍 Результат

После выполнения реакции результат доступен в переменной:

${response.result}

Структура результата — массив объектов Sticker (до 112 элементов).

Для получения custom_emoji_id первого эмодзи:

${response.result.0.custom_emoji_id}

Для получения custom_emoji_id конкретного эмодзи по индексу (например, 5-го):

${response.result.4.custom_emoji_id}

📊 Пример ответа (сокращённый)

{
  "ok": true,
  "result": [
    {
      "custom_emoji_id": "5434144690511290129",
      "emoji": "📰",
      "file_id": "CAACAgIAAxUAAWmsESOYkylUfQWZsl6bvB2Y1T8FAAIRHwACzvVpS9-PyW20N6KdOgQ",
      "file_size": 58365,
      "file_unique_id": "AgADER8AAs71aUs",
      "height": 512,
      "is_animated": true,
      "is_video": false,
      "set_name": "Topics",
      "type": "custom_emoji",
      "width": 512
    },
    {
      "custom_emoji_id": "5434144690511290130",
      "emoji": "⭐",
      ...
    }
  ]
}

📍 Подсказка: Полный ответ содержит 112 объектов. Для перебора всех доступных эмодзи используйте макрос !{list}.

🧪 Примеры использования

Пример 1: Получение ID первого эмодзи

Задача: Получить custom_emoji_id первого доступного эмодзи для установки в качестве иконки темы.

Реакции:

1. GetForumTopicIconStickers
2. SetVarLocal → emoji_id = ${response.result.0.custom_emoji_id}

Пример 2: Создание темы со случайной иконкой

Задача: Создать тему со случайным эмодзи из доступных.

Реакции:

1. GetForumTopicIconStickers
2. SetVarLocal → random_index = !{random.number|min:0; max:111}
3. SetVarLocal → random_emoji_id = !{pick|value: ${response.result}; key: ${localVar.random_index}.custom_emoji_id}
4. createforumtopic → chat_id: ${chat.id}, name: Новая тема, icon_custom_emoji_id: ${localVar.random_emoji_id}

Пример 3: Получение ID эмодзи по индексу

Задача: Получить ID 10-го эмодзи из списка.

Реакции:

1. GetForumTopicIconStickers
2. SetVarLocal → emoji_10_id = ${response.result.9.custom_emoji_id}

Пример 4: Перебор всех доступных эмодзи

Задача: Получить список всех custom_emoji_id.

Реакции:

1. GetForumTopicIconStickers
2. (Обработка массива через TriggerFolder с итерацией)

🔄 Особенности поведения

🔗 Связанные реакции

🔗 Связанные разделы

🔗 Ссылка на официальную документацию

getForumTopicIconStickers — Telegram Bot API