Отправка стикера в боте Telegram
Анимационное сообщение в Telegram — уникальный визуальный формат для эмоциональной коммуникации в Telegram. Стикеры представляют собой статичные (WEBP) или анимированные (TGS) изображения, оптимизированные под быструю отправку и автоматическое воспроизведение. Они не поддерживают текст, но могут сопровождаться интерактивными кнопками. Каждый стикер принадлежит к конкретному набору (pack), созданному через @StickersBot, что обеспечивает согласованность дизайна.
Какие форматы принимает стикер в Telegram и какие бывают ограничения?
Для разных типов стикеров в Telegram предусмотрены разные форматы изображений:
- PNG. Подходит для статических стикеров. Формат обеспечивает высокое качество изображения и прозрачный фон. Размер стикера — 512×512 пикселей.
- WEBP. Формат для анимированных стикеров. Позволяет создавать креативные и живописные анимации. Размер стикера также — 512×512 пикселей.
- TGS. Спецформат Telegram для анимированных стикеров. Длительность анимации не может превышать 3 секунды, частота кадров — 30 или 60 FPS. Размер холста — 512×512 пикселей.
Некоторые ограничения:
1. Разрешение:
- Мин.: 100×100 px,
- Макс.: 512×512 px (рекомендуется 512×512 для четкости).
2. Прозрачность: Обязательна (фон удаляется автоматически).
3. Предпросмотр: Квадратное превью генерируется автоматически.
4. Анимация:
- Только TGS (формат Telegram),
- Макс. длительность: 3 секунды,
- Макс. частота кадров: 60 FPS.
Популярные ошибки при отправке стикера
400 Bad Request: STICKER_PNG_NOPNG
- Причина: Отправлен PNG вместо WEBP/TGS.
- Решение: Конвертируйте в WEBP:
400 Bad Request: STICKER_TGS_NOTGS
- Причина: Невалидный TGS-файл.
- Решение: Проверьте анимацию через [tgsviewer](https://www.tgsviewer.com/).
400 Bad Request: Invalid sticker emojis
- Причина: При создании набора указаны несуществующие эмодзи.
- Решение: Используйте только стандартные эмодзи (✅: 😊, ❤️, ⭐️).
400 Bad Request: Sticker set name invalid
- Причина: Название набора содержит запрещенные символы.
- Решение: Используйте латиницу и нижнее подчёркивание: my_cool_pack.
403 Forbidden: Bot is not a sticker set owner
- Решение: Создавайте наборы только через аккаунт, который создал стикеры.
Информация
Техническая информация для «API BOT-MARKET»
- - Код типа сообщения (`messageType`): "10" (для `sendSticker`).
- - Макс. скорость отправки: 30 стикеров/секунду (из-за малого веса файлов).
- - Лимиты наборов:
- Статические: до 120 стикеров в паке,
- Анимированные: до 50 стикеров в паке.
Советы по эффективному использованию
1. Дизайн-правила:
- Контур: 2-3 px обводка для контраста на любом фоне.
- Размер: 512×512 px с прозрачностью → Telegram сам масштабирует до 100-200 px в чате.
2. Продвижение наборов:
- Добавьте кнопку под стикером
