кастомные эмодзи для telegram бота
Пройдите путь от SVG-символа до Telegram custom_emoji_id и отделите подготовку графики от отправки сообщения своим ботом.
Файл TGS, идентификатор эмодзи и права бота решают разные задачи.
Отдельную реакцию бот отправляет через sendSticker. Значок рядом со словами «Задача выполнена» — кастомный эмодзи в тексте. Оба рисунка могут начинаться с SVG и TGS, но требуют разных типов набора и способов отправки. Уменьшение обычного стикера не превращает его в эмодзи.
В интеграции сервиса custom_emoji_id для бота копируется после успешного добавления в управляемый набор эмодзи. Pro создаёт или пополняет наборы сервиса и предоставляет предпросмотр обычных стикеров и эмодзи в Telegram. Предпросмотр нужен для оценки вида, а ID для интеграции берите из результата добавления. Произвольный пак здесь нельзя выбрать или переименовать.
По текущим правилам Bot API сущности custom_emoji доступны ботам с дополнительными именами, приобретёнными на Fragment. Другой вариант — сообщения, которые бот напрямую отправляет в личные чаты, группы и супергруппы, если у владельца бота есть Telegram Premium. Это второе условие не следует переносить на каналы или inline-режим. Pro нашего сервиса не заменяет Telegram Premium и не выдаёт права Bot API.
Как это работает
Пройдите путь от SVG-символа до Telegram custom_emoji_id и отделите подготовку графики от отправки сообщения своим ботом.
Выберите понятное состояние: готово, ожидание или внимание. Переведите текст в контуры и замените растровые вставки вектором.
Конвертация и скачивание TGS бесплатны после входа через Telegram. При выборе SVG диагностическая копия отправляется сервису, включая выбор до входа; анимация и экспорт работают в браузере.
Выберите доступное движение, скачайте файл и проверьте его структуру. Оцените читаемость в строке текста: успешный экспорт не подтверждает корректность сообщения вашего бота.
Используйте соответствующее действие Pro либо официальный инструмент Telegram самостоятельно. Встроенные предпросмотр и добавление отправляют TGS через сервер сервиса в Telegram; обычное скачивание не создаёт custom_emoji_id.
После успешного добавления в управляемый набор эмодзи скопируйте custom_emoji_id из ответа сервера. При ручном добавлении получите его для нужного элемента через getStickerSet.
В коде бота передайте сущность custom_emoji с этим ID и обычным эмодзи в тексте как запасным отображением. Проверьте права бота и фактический результат в нужном типе чата.
Сценарии
Готовьте векторную графику для стикеров, кастомных эмодзи и брендовых наборов Telegram.
Добавьте значок рядом с понятным текстом; смысл сообщения должен сохраняться без кастомной графики.
Выберите спокойное движение, которое не мешает читать описание текущего состояния.
Используйте обычный стикер и sendSticker, если рисунок должен занимать отдельное сообщение.
Формат
TGS хранит анимацию, а custom_emoji_id указывает на зарегистрированный эмодзи Telegram. Это не имя файла, не file_id для передачи файла и не поле, которое нужно вычитать из содержимого TGS. Сохраняйте возвращённый ID строкой, без округления длинного числа.
Для TGS-эмодзи действует холст 512 × 512; правило 100 × 100 относится к PNG, WEBP и WEBM. Конвертер принимает SVG; готовые Lottie JSON и TGS не импортируются. Исправляйте SVG и заново экспортируйте графику, а после добавления проверяйте идентификатор нужной версии.
Советы и требования
FAQ
Нет. Сущность в тексте ссылается на зарегистрированный кастомный эмодзи. Скачанный файл сначала нужно добавить в соответствующий набор.
Telegram использует его там, где кастомное отображение недоступно. Сообщение должно оставаться понятным и в таком виде; пустая подстановка не подходит.
Нет. Здесь готовится графика и выполняются выбранные действия интеграции. Код вашего бота, его права и проверка доставки остаются отдельной задачей; принятие файла и отправка сообщения не гарантируются.
Начать
Начните с читаемого SVG, затем отдельно проверьте регистрацию эмодзи и его использование в сообщении.
