Видео сообщение(заметка) в Telegram — уникальный формат для отправки коротких видеосообщений в виде круга (аналогично Stories). Используется в личных чатах и группах для быстрой коммуникации. Telegram автоматически обрезает видео до квадрата 1:1, добавляет круговую маску и оптимизирует для мгновенного просмотра. Максимальная длительность — 60 секунд, что делает формат идеальным для микроконтента.

Какие форматы принимает видео сообщение(заметка) в Telegram и какие бывают ограничения?
Форматы видео сообщений(заметок)
В Telegram для создания кружочков подходят видеофайлы продолжительностью до 60 секунд. Загружаемое видео должно быть размером 8 Мб и иметь разрешение 640х640 пикселей.
Некоторые ограничения, которые нужно учитывать при работе с видео в Telegram:
- Длительность: не дольше 1 минуты. Если снимать дольше, запись остановится, и видео нужно будет отправить самостоятельно.
- Формат устройства: записывать кружочки можно только со смартфонов или на компьютерах Apple. В десктопной версии Telegram эта функция недоступна.
- Редактирование: перед отправкой кружочек можно изменить во встроенном редакторе, например, обрезать начало или концовку.
- Таймер самоуничтожения: есть функция, которая позволяет собеседнику просмотреть кружочек только один раз, после чего сообщение сразу удаляется.
- Сохранение: отправленное видеосообщение можно сохранить на устройство пользователя.
- Воспроизведение: отправленные видео автоматически воспроизводятся в ленте чата для удобства просмотра.
Популярные ошибки при отправке видео сообщения(кружочка)
400 Bad Request: Wrong video ratio
- Причина: Видео не квадратное (например, 16:9).
- Решение: Конвертировать в 1:1:
400 Bad Request: Video duration too long
- Причина: Видео >60 секунд.
- Решение: Обрезать.
413 Request Entity Too Large
- Причина: Файл >8 МБ.
- Решение: Сжать видео.
400 Bad Request: Wrong file identifier
- Причина: Неверный file_id или битая ссылка.
- Решение: Обновите file_id или проверьте доступность URL.
403 Forbidden: Bot was blocked by the user
- Решение: Требуется разблокировка бота пользователем.
Информация
Техническая информация для «API BOT-MARKET»
- Код типа сообщения (`messageType`): "5" (для `sendVideoNote`).
- Макс. скорость отправки: 20 сообщений/секунду в группах.
Советы по эффективному использованию
1. Оптимизация для мобильных:
- Разрешение: 480×480 (баланс качества/размера).
- Длительность: ≤15 сек для максимального вовлечения.
2. Создание контента:
- Используйте вертикальную съёмку → Telegram автоматически обрежет до квадрата.
- Добавьте текст в центр кадра (для кругового просмотра).