Реакции, стикеры и живой тон бота

Стикер для Bot API — это медиа-сообщение, и устроен он так же, как фото из урока про медиа: у каждого стикера есть file_id, по которому Telegram отдаёт файл без всякой загрузки с вашей стороны. Бот отправляет стикер конфигурацией tgbotapi.NewSticker(chatID, file): во второй аргумент передаётся идентификатор — в базовой версии библиотеки это tgbotapi.InputFileString(fileID), в свежих форках то же самое выглядит как tgbotapi.FileID(fileID), и смысл не меняется: путь к файлу на серверах Telegram. Где взять file_id: переслать нужный стикер боту и посмотреть в логе Message.Sticker.FileID — приём тот же, что для фото. Хранится идентификатор как обычная строка в конфиге или базе и живёт долго; у стикеров, в отличие от некоторых временных файлов, идентификатор стабильный. Свой набор боту не нужен: слать можно стикеры из любых общедоступных паков, а создание собственного пака через createNewStickerSet — отдельная тема, для тона бота хватит готовых.

Реакция — метод setMessageReaction из Bot API, который базовая обёртка не завершила конфигурацией, поэтому вызывается generic-запросом: bot.MakeRequest с именем метода и картой параметров tgbotapi.Params, где ключи — имена полей API, а значения — строки. Обязательные параметры: chat_id и message_id — на чьё сообщение ставим, и reaction — JSON-массив реакций. Каждый элемент массива — объект типа ReactionTypeEmoji: поле type со значением emoji и поле emoji с самим эмодзи, например огонёк или большой палец. Необязательный is_big делает реакцию крупной, а пустой массив reaction снимает реакцию бота с сообщения. В свежих обёртках и форках библиотеки для этого есть типизированная конфигурация — идея та же, только JSON собирает компилятор, — но схема запроса не менялась: тот же метод, те же поля. Ответ метода — простой True, и ошибка приходит по тем же правилам, что и весь API: код ответа отличен от ожидаемого, в описании причина.

Реакция — это подтверждение, и её честное место — в конце цепочки, когда действие уже сделано: задача записана, напоминание поставлено, файл сохранён. Пользователь видит жест на своём сообщении, лента не растёт, диалог остаётся чистым. Второй сценарий, где реакции незаменимы, — групповые чаты: бот подтверждает реакции вместо восьми сообщений принято-принято-принято, и рабочий чат остаётся рабочим. Граница уместности тоже ясная. Реакция не заменяет ответ на ошибку: если команда не сработала, человеку нужен текст — что именно не так и как исправить, а большой палец на невыполненном запросе выглядит насмешкой. Реакция не заменяет диалог: анкеты, уточнения и выбор — это сообщения и клавиатуры. И у эмодзи есть смысловая нагрузка: огонь на сообщении об ошибке читается как издёвка, поэтому набор бота стоит держать узким и предсказуемым — палец для успеха, глаза для принятия к сведению, и всё. Спорная точка курса: часть разработчиков ставит реакции на каждое входящее сообщение ради анимации — по опыту это дешёвый эффект, который быстро обесценивает и реакции, и бота.

Пара технических деталей, которые экономят вечер. Набор допустимых эмодзи фиксирован Telegram: реакция ставится только эмодзи из разрешённого списка и только в чатах, где реакции включены на уровне настроек чата — в группе можно ограничить набор, и бот связан теми же ограничениями, что и люди. Попытка поставить странный эмодзи или реакцию в чате с выключенными реакциями вернёт ошибку про недопустимую реакцию — это нормальный ответ API, обрабатывайте его без паники. Тип custom_emoji с анимированными эмодзи существует в схеме реакций, но для ботов привычный и надёжный путь — обычный emoji-набор. Стикеры при этом лимитам послушны точно так же: это обычные медиа-отправки со всеми счётчиками. И тонкое место в группах: бот видит только сообщения, для которых у него есть доступ, и не может ставить реакции на чужие служебные сообщения — если реакция не встаёт, проверьте сначала message_id, а потом разрешения.

Пару слов про выбор стикеров заранее, потому что это решение конфигурации, а не кода. Готовить пачку file_id стоит в одном месте: константы или конфиг-файл с осмысленными ключами — успех, мягкая ошибка, праздник, — и хендлеры берут стикер по ситуации, а не пишут идентификатор в строке. Тогда смена тона бота — это правка конфига без пересборки, а тестовый прогон подменяет пачку на пустую и проверяет, что бот не падает без стикеров. Набор метода getStickerSet позволяет скачать целый пак одним вызовом и собрать идентификаторы пачкой, но для тона бота хватает пяти-семи стикеров из разных паков. И правило для групп: там стикеры быстрее превращаются в шум, чем реакции, потому что стикер — это целое сообщение; в группах бот подтверждает действия реакциями, а стикеры оставляет личному диалогу, где нет чужой ленты, которую можно засорить.