Відео повідомлення в 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: неправильне співвідношення сторін відео
- Причина: вказані невірні width`/`height (≠ реальному вирішенню).
- Рішення: видаліть параметри або вкажіть точні значення.
413: Об'єкт запиту занадто великий
- Рішення: стиснути відео через ffmpeg:
400: Не вдається розібрати об'єкти підпису
- Причина: помилка в HTML / Markdown розмітці підпису.
- Рішення: перевірити екранування тегів.
403: Бот був заблокований Користувачем
- Рішення: потрібно розблокування бота Користувачем.
Інформація
Технічна інформація для»API Bot-MARKET"
- Код типу повідомлення (`messageType') для sendVideo: "4".
- Макс. швидкість відправки: 20 повідомлень/секунду в каналах
Поради щодо ефективного використання :
1. Розмітка > Plain text: Використовуйте HTML для візуальної структуризації.
2. Розділення контенту: Для тексту > 4096 символів застосовуйте інлайн-кнопки з callback-даними.
3. Екранування: Завжди обробляйте спеціальні символи в введенні користувача, щоб уникнути помилок парсингу.
