Блог і база знань сервісу

Відправлення повідомлення "кружечок" в боті Telegram

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

Відправлення повідомлення "кружечок" в боті Telegram

Які формати приймає відео повідомлення (замітка) в Telegram і які бувають обмеження?

Формати відео повідомлень (заміток)

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

Деякі обмеження, які потрібно враховувати при роботі з відео в Telegram:

  1. Тривалість: не довше 1 хвилини. Якщо знімати довше, запис зупиниться, і Відео потрібно буде відправити самостійно. 
  2. Формат пристрою: записувати кружечки можна тільки зі смартфонів або на комп'ютерах Apple. У десктопній версії Telegram ця функція недоступна. 
  3. Редагування: перед відправкою кружечок можна змінити у вбудованому редакторі, наприклад, обрізати початок або кінцівку. 
  4. Таймер самознищення: є функція, яка дозволяє співрозмовнику переглянути кружечок тільки один раз, після чого повідомлення відразу видаляється.
  5. Збереження: відправлене відеоповідомлення можна зберегти на пристрій користувача.
  6. Відтворення: надіслані відео автоматично відтворюються у стрічці чату для зручності перегляду.


Популярні помилки при відправці відео повідомлення (кружечка)

400 неправильний запит: неправильне співвідношення відео

- Причина: відео не квадратне (наприклад, 16: 9). 

- Рішення: конвертувати в 1:1:  

400 неправильний запит: занадто велика тривалість відео

- Причина: Відео >60 секунд. 

- Рішення: Обрізати. 

413 Об'єкт запиту занадто великий

- Причина: Файл >8 МБ. 

- Рішення: стиснути відео.

400 неправильний запит: неправильний ідентифікатор файлу

- Причина: невірний file_id або бита посилання.

- Рішення: оновіть file_id або перевірте наявність URL-адреси. 

403 заборонено: Бот був заблокований Користувачем

- Рішення: потрібно розблокування бота Користувачем. 

Інформація

Технічна інформація для»API Bot-MARKET"

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


Поради щодо ефективного використання

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

  - Дозвіл: 480×480 (баланс якості/розміру).

  - Тривалість: ≤15 сек для максимального залучення. 

2. Створення контенту: 

  - Використовуйте вертикальну зйомку → Telegram автоматично обріже до квадрата. 

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