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

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

Отправка сообщения "кружочек" в боте Telegram

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

Форматы видео сообщений(заметок)

В Telegram для создания кружочков подходят видеофайлы продолжительностью до 60 секунд. Загружаемое видео должно быть размером 8 Мб и иметь разрешение 640х640 пикселей.

Некоторые ограничения, которые нужно учитывать при работе с видео в Telegram:

  1. Длительность: не дольше 1 минуты. Если снимать дольше, запись остановится, и видео нужно будет отправить самостоятельно. 
  2. Формат устройства: записывать кружочки можно только со смартфонов или на компьютерах Apple. В десктопной версии Telegram эта функция недоступна. 
  3. Редактирование: перед отправкой кружочек можно изменить во встроенном редакторе, например, обрезать начало или концовку. 
  4. Таймер самоуничтожения: есть функция, которая позволяет собеседнику просмотреть кружочек только один раз, после чего сообщение сразу удаляется.
  5. Сохранение: отправленное видеосообщение можно сохранить на устройство пользователя.
  6. Воспроизведение: отправленные видео автоматически воспроизводятся в ленте чата для удобства просмотра.


Популярные ошибки при отправке видео сообщения(кружочка)

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»

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


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

1. Оптимизация для мобильных: 

  - Разрешение: 480×480 (баланс качества/размера).

  - Длительность: ≤15 сек для максимального вовлечения. 

2. Создание контента: 

  - Используйте вертикальную съёмку → Telegram автоматически обрежет до квадрата. 

  - Добавьте текст в центр кадра (для кругового просмотра). 

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