Отправка анимационного сообщения в боте Telegram
Анимационное сообщение в Telegram — метод для отправки GIF и видео-анимаций в чаты, группы и каналы. В отличие от обычных видео (`sendVideo`), анимации автоматически воспроизводятся без звука, зациклены и отображаются с превью. Telegram оптимизирует их для мгновенного просмотра, что делает формат идеальным для рекламы, демонстрации интерфейсов и вирусного контента. Максимальная длительность — 3 минуты, но рекомендуется ≤15 сек для максимального вовлечения.
Какие форматы принимает анимационное сообщение в Telegram и какие бывают ограничения?
Telegram поддерживает различные форматы анимационных сообщений, среди них:
GIF, ANPG, MP4
Некоторые ограничения:
- GIF: при добавлении гифки через карточку «Картинка» анимация не будет проигрываться, в мессенджере отобразится статичное изображение. Для загрузки анимации нужно использовать карточку «Файл».
- Создание GIF из подборки фотографий: для анимации в формате GIF из подборки фотографий нужно использовать зацикленное видео без звука формата .webm размером 512х512 пикселей, весом до 256 КБ и продолжительностью до трёх секунд.
- Количество сохраняемых GIF: можно сохранить 200 GIF (с Telegram Premium — 400 GIF)
Популярные ошибки при отправке анимационного сообщения
400 Bad Request: Wrong file identifier
- Причина: Неверный URL или битый file_id.
- Решение: Проверьте Content-Type: video/mp4 для MP4.
400 Bad Request: Animation duration too long
- Причина: Анимация >180 секунд.
- Решение: Обрежьте через ffmpeg:
413 Request Entity Too Large
- Причина: Файл >50 МБ.
- Решение: Сожмите без потери качества:
400 Bad Request: Can't parse caption entities
- Решение: Экранируйте спецсимволы в подписи:
403 Forbidden: Bot was blocked by the user
- Решение: Требуется разблокировка.
Иноформация
Техническая информация для «API BOT-MARKET»
- Код типа сообщения (`messageType`): "9" (для `sendAnimation`).
- Макс. скорость отправки: 20 сообщений/секунду в группах.
Советы по эффективному использованию
1.Оптимизация анимаций:
- Конвертируйте GIF в MP4 (90% уменьшение размера):
- Частота кадров: 15-24 FPS (достаточно для плавности).
2. Превью-триггеры:
- Первый кадр должен содержать текст/призыв (например: "Свайпните вниз!").
Создайте кастомное JPEG-превью, если автосгенерированное не подходит.
3. Интерактивность:
Добавьте кнопки для действий:
4. Повышение вовлечённости:
- Используйте циклы: 3-5 повторов анимации.
- Добавьте текстовые пояснения в кадр (так как звук отсутствует).
