Блог и база знаний сервиса
Отправка анимационного сообщения в боте Telegram
Опубликовано: 04.08.2025 Обновлено: 04.08.2025

Анимационное сообщение в Telegram —  метод для отправки GIF и видео-анимаций в чаты, группы и каналы. В отличие от обычных видео (`sendVideo`), анимации автоматически воспроизводятся без звука, зациклены и отображаются с превью. Telegram оптимизирует их для мгновенного просмотра, что делает формат идеальным для рекламы, демонстрации интерфейсов и вирусного контента. Максимальная длительность — 3 минуты, но рекомендуется ≤15 сек для максимального вовлечения.

Отправка анимационного сообщения в боте Telegram

Какие форматы принимает анимационное сообщение в Telegram и какие бывают ограничения?

Telegram поддерживает различные форматы анимационных сообщений, среди них:

GIF, ANPG, MP4

Некоторые ограничения:

  1. GIF: при добавлении гифки через карточку «Картинка» анимация не будет проигрываться, в мессенджере отобразится статичное изображение. Для загрузки анимации нужно использовать карточку «Файл». 
  2. Создание GIF из подборки фотографий: для анимации в формате GIF из подборки фотографий нужно использовать зацикленное видео без звука формата .webm размером 512х512 пикселей, весом до 256 КБ и продолжительностью до трёх секунд.
  3. Количество сохраняемых 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»

  1. Код типа сообщения (`messageType`): "9" (для `sendAnimation`). 
  2. Макс. скорость отправки: 20 сообщений/секунду в группах. 


Советы по эффективному использованию

1.Оптимизация анимаций

  - Конвертируйте GIF в MP4 (90% уменьшение размера): 

  - Частота кадров: 15-24 FPS (достаточно для плавности). 

2. Превью-триггеры

  - Первый кадр должен содержать текст/призыв (например: "Свайпните вниз!").

Создайте кастомное JPEG-превью, если автосгенерированное не подходит. 

3. Интерактивность:

  Добавьте кнопки для действий: 

4. Повышение вовлечённости

  - Используйте циклы: 3-5 повторов анимации. 

  - Добавьте текстовые пояснения в кадр (так как звук отсутствует).  

Comments
to write comments
Comment list is empty. Start now!