Видео сообщение в Telegram — метод отправки видеоконтента в чаты, группы и каналы. В отличие от видео-заметок (`sendVideoNote`), этот формат поддерживает произвольное соотношение сторон (16:9, 9:16), длинные ролики и комплексное оформление: подписи с разметкой, интерактивные кнопки и кастомные миниатюры. Telegram оптимизирует видео для плавного воспроизведения, но для сохранения исходного качества используйте sendDocument.
Какие форматы принимает видео в Telegram и какие бывают ограничения?
Telegram поддерживает следующие форматы видео
Горизонтальный(16:9), вертикальный(9:16) и квадратный(1:1)
Некоторые ограничения, которые нужно учитывать при работе с видео в Telegram:
- Размер файла. Максимальный размер загружаемого видео — 2 ГБ. Вертикальные видео часто занимают меньше места, поскольку их продолжительность обычно короче, что упрощает загрузку. Горизонтальные и квадратные видео могут требовать дополнительной оптимизации.
- Автопроигрывание и превью. Telegram автоматически воспроизводит видео без звука в лентах и чатах. Вертикальные и квадратные видео в этом случае имеют преимущество, так как они более заметны и занимают больше места на экране.
- Влияние сетевых условий. Скорость и стабильность интернет-соединения влияют на качество видео. При нестабильном соединении система автоматически снижает качество для поддержания непрерывного воспроизведения.
- Ограничения по битрейту. Для оптимизации загрузки установлены ограничения по битрейту.
- Оптимальные параметры видео. Для Telegram рекомендуются следующие значения: разрешение — до 1920x1080 пикселей, битрейт — 2000–4000 кбит/с, частота кадров — 24–30 fps, формат — MP4 (H.264).
Популярные ошибки при отправке текста
400: Wrong video ratio
- Причина: Указаны неверные width`/`height (≠ реальному разрешению).
- Решение: Удалите параметры или укажите точные значения.
413: Request Entity Too Large
- Решение: Сжать видео через ffmpeg:
400: Can't parse caption entities
- Причина: Ошибка в HTML/Markdown разметке подписи.
- Решение: Проверить экранирование тегов.
403: Bot was blocked by the user
- Решение: Требуется разблокировка бота пользователем.
Информация
Техническая информация для «API BOT-MARKET»
- Код типа сообщения (`messageType`) для sendVideo: "4".
- Макс. скорость отправки: 20 сообщений/секунду в каналах
Советы по эффективному использованию :
1. Разметка > Plain text: Используйте HTML для визуальной структуризации.
2. Разделение контента: Для текста > 4096 символов применяйте инлайн-кнопки с callback-данными.
3. Экранирование: Всегда обрабатывайте спецсимволы в пользовательском вводе, чтобы избежать ошибок парсинга.
